FreshContext

princegabriel-lgtm/freshcontext-mcp

This solves the problem of LLMs confidently citing outdated information by applying temporal decay scoring to retrieved context. It wraps 21 adapters around sources like GitHub, Hacker News, arXiv, Reddit, SEC filings, GDELT news, and Singapore government procurement data. Every response gets tagged with publication and retrieval timestamps, then re-ranked using exponential decay functions tuned per source type. You can run it locally with full Playwright scraping or hit the hosted Cloudflare Worker endpoint. The real product is the decay-adjusted relevancy layer and the FreshContext envelope spec, not the adapters themselves. Useful when you need Claude to distinguish between a 2022 blog post and current documentation, or when building agents that need provenance and confidence scores on every piece of context.

GitHub stars: 12
tools: 22
transport: STDIO, HTTP
last updated: Sep 27, 2026

View on GitHub

Install

From registry metadata

$ npx add-mcp https://api.freshcontext.dev/mcp --name freshcontext

Run in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http freshcontext https://api.freshcontext.dev/mcp

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 22 tools

Verified live against the running server on Nov 6, 2026.

evaluate_contextEvaluate caller-provided candidate context and return decision-ready output. This is the primary FreshContext judgment path: it does not fetch, crawl, scrape, browse, read folders, or call adapters.4 params

Evaluate caller-provided candidate context and return decision-ready output. This is the primary FreshContext judgment path: it does not fetch, crawl, scrape, browse, read folders, or call adapters.

Parameters* required

intent*string

Intent Profile id, e.g. citation_check, student_research, developer_adoption, job_search, market_watch, business_due_diligence, medical_literature_triage.

nowstring

Optional ISO timestamp for deterministic evaluation.

profile*string

Source Profile id, e.g. academic_research, jobs_opportunities, market_finance, official_docs, local_custom.

signals*array

Candidate context items provided by the caller. FreshContext evaluates these; it does not retrieve them.

extract_githubExtract real-time data from a GitHub repository — README, stars, forks, last commit, topics. Returns timestamped freshcontext.1 params

Extract real-time data from a GitHub repository — README, stars, forks, last commit, topics. Returns timestamped freshcontext.

Parameters* required

url*string

Full GitHub repo URL e.g. https://github.com/owner/repo

extract_hackernewsExtract top stories or search results from Hacker News. The url field accepts an HN/Algolia URL or a plain search query.1 params

Extract top stories or search results from Hacker News. The url field accepts an HN/Algolia URL or a plain search query.

Parameters* required

url*string

HN URL e.g. https://news.ycombinator.com/news, Algolia API URL, or search query e.g. 'browser agents'

extract_scholarExtract research results (title, authors, year, snippet) from a Google Scholar search URL. Scholar exposes only the publication year, not an exact date, so freshness confidence is capped at medium.1 params

Extract research results (title, authors, year, snippet) from a Google Scholar search URL. Scholar exposes only the publication year, not an exact date, so freshness confidence is capped at medium.

Parameters* required

url*string

Google Scholar search URL

extract_ycWithdrawn in 0.5.3 pending review of source terms. Returns an error; kept so existing clients get a clear answer.1 params

Withdrawn in 0.5.3 pending review of source terms. Returns an error; kept so existing clients get a clear answer.

Parameters* required

url*string

Previously a ycombinator.com/companies URL

search_reposSearch GitHub for repositories matching a keyword. Returns top results by stars.1 params

Search GitHub for repositories matching a keyword. Returns top results by stars.

Parameters* required

query*string

Search query e.g. 'mcp server typescript'

package_trendsnpm and PyPI package metadata — version history, release cadence, last updated.1 params

npm and PyPI package metadata — version history, release cadence, last updated.

Parameters* required

packages*string

Package name(s) e.g. 'langchain' or 'npm:zod,pypi:fastapi'

extract_redditExtract recent posts from a subreddit (e.g. 'r/MachineLearning') or a Reddit search/listing URL. Returns title, subreddit, author, score, comment count, and post date per result.1 params

Extract recent posts from a subreddit (e.g. 'r/MachineLearning') or a Reddit search/listing URL. Returns title, subreddit, author, score, comment count, and post date per result.

Parameters* required

url*string

Subreddit name e.g. 'r/MachineLearning' or search URL

extract_producthuntExtract recent Product Hunt launches by keyword/topic search or a PH URL. Returns name, tagline, votes, comment count, topics, and launch date per result.1 params

Extract recent Product Hunt launches by keyword/topic search or a PH URL. Returns name, tagline, votes, comment count, topics, and launch date per result.

Parameters* required

url*string

Search query or PH topic URL

extract_financeNo-key stock quote data via Stooq. Accepts comma-separated ticker symbols and returns quote/OHLC/volume observations with timestamps.1 params

No-key stock quote data via Stooq. Accepts comma-separated ticker symbols and returns quote/OHLC/volume observations with timestamps.

Parameters* required

url*string

Ticker symbol(s) e.g. 'AAPL' or 'MSFT,GOOG'

search_jobsSearch for real-time job listings with freshness badges on every result. Sources: Remotive + HN Who is Hiring.2 params

Search for real-time job listings with freshness badges on every result. Sources: Remotive + HN Who is Hiring.

Parameters* required

max_lengthnumber

default: 6000

query*string

Job search query e.g. 'typescript remote'

extract_landscapeComposite tool. Queries GitHub + HN + npm simultaneously. Returns a unified landscape report with each source's own freshness.1 params

Composite tool. Queries GitHub + HN + npm simultaneously. Returns a unified landscape report with each source's own freshness.

Parameters* required

topic*string

Project idea or keyword e.g. 'mcp server'

extract_arxivSearch arXiv for research papers via the official API. Pass a topic or full arXiv API URL. Returns titles, authors, dates, abstracts.1 params

Search arXiv for research papers via the official API. Pass a topic or full arXiv API URL. Returns titles, authors, dates, abstracts.

Parameters* required

url*string

Search query e.g. 'temporal retrieval', or a full arXiv API URL

extract_changelogUpdate history for any product. Accepts a GitHub repo URL or an npm package name. Returns version numbers, release dates, and entries.1 params

Update history for any product. Accepts a GitHub repo URL or an npm package name. Returns version numbers, release dates, and entries.

Parameters* required

url*string

GitHub repo URL or npm package name e.g. 'react'

extract_gdeltGlobal news intelligence from GDELT. Monitors news from every country in 100+ languages, updated every 15 minutes. Returns articles with source country, language, date.1 params

Global news intelligence from GDELT. Monitors news from every country in 100+ languages, updated every 15 minutes. Returns articles with source country, language, date.

Parameters* required

url*string

Query: company name, topic, or keyword

extract_gebizSingapore Government procurement opportunities (GeBIZ via data.gov.sg). Search by keyword, agency name, or empty for all recent tenders.1 params

Singapore Government procurement opportunities (GeBIZ via data.gov.sg). Search by keyword, agency name, or empty for all recent tenders.

Parameters* required

url*string

Keyword, agency, or empty for latest tenders

extract_govcontractsUS federal contract awards from USASpending.gov. Search by company name (e.g. 'Palantir'), keyword, or NAICS code. Returns amounts, dates, agencies.1 params

US federal contract awards from USASpending.gov. Search by company name (e.g. 'Palantir'), keyword, or NAICS code. Returns amounts, dates, agencies.

Parameters* required

url*string

Company name, keyword, or NAICS code

extract_sec_filingsSEC 8-K filings via EDGAR full-text search. 8-K = legally mandated material event disclosures (CEO changes, M&A, breaches). Pass company name, ticker, or keyword.1 params

SEC 8-K filings via EDGAR full-text search. 8-K = legally mandated material event disclosures (CEO changes, M&A, breaches). Pass company name, ticker, or keyword.

Parameters* required

url*string

Company name, ticker, or keyword

extract_gov_landscapeComposite government intelligence: federal contract awards (USASpending) + dev community awareness (HN) + GitHub repo activity + product release velocity (changelog). 4-source unified report.2 params

Composite government intelligence: federal contract awards (USASpending) + dev community awareness (HN) + GitHub repo activity + product release velocity (changelog). 4-source unified report.

Parameters* required

github_urlstring

Optional GitHub repo URL for the company

query*string

Company name, keyword, or NAICS code

extract_finance_landscapeComposite financial intelligence: Stooq quote data + HN sentiment + Reddit discussion + GitHub ecosystem + product changelog. 5-source unified report.3 params

Composite financial intelligence: Stooq quote data + HN sentiment + Reddit discussion + GitHub ecosystem + product changelog. 5-source unified report.

Parameters* required

company_namestring

Company name for HN/Reddit/GitHub searches

github_querystring

GitHub search query or repo URL

tickers*string

One or more ticker symbols e.g. 'PLTR' or 'PLTR,MSFT'

extract_company_landscapeMost complete single-call company intelligence: SEC 8-K filings + USASpending federal contracts + GDELT global news + product changelog + Stooq quote data. 5 unique sources.3 params

Most complete single-call company intelligence: SEC 8-K filings + USASpending federal contracts + GDELT global news + product changelog + Stooq quote data. 5 unique sources.

Parameters* required

company*string

Company name e.g. 'Palantir', 'Anthropic'

github_urlstring

Optional GitHub repo or org URL for changelog accuracy

tickerstring

Stock ticker for finance data

extract_idea_landscapeIdea validation composite: HN pain signals + YC funded competitors + GitHub crowding + jobs market signal + npm/PyPI ecosystem + Product Hunt launches. 6 sources.1 params

Idea validation composite: HN pain signals + YC funded competitors + GitHub crowding + jobs market signal + npm/PyPI ecosystem + Product Hunt launches. 6 sources.

Parameters* required

idea*string

Your idea, problem space, or keyword

Readme

FreshContext

This package is no longer developed. 0.5.3 is the last release of freshcontext-mcp. It and every earlier release stay available under the MIT License, as is; there will be no further feature releases. For FreshContext services, see https://freshcontext.dev. Security reports: see SECURITY.md.

I asked Claude to help me find a job. It gave me a list of openings. I applied to three of them. Two didn't exist anymore. One had been closed for two years.

Claude had no idea. It presented everything with the same confidence.

That's the problem freshcontext fixes.

This repository is the integrated FreshContext Core/MCP package.

View the full README on GitHub

Details

Repository: github.com/princegabriel-lgtm/freshcontext-mcp
Website: freshcontext.dev
Package: freshcontext-mcp
Transport: STDIO, HTTP
Registry: MCP registry, active
Tools verified: Nov 6, 2026