freshcontext-mcp

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.

---

What it does

Every MCP server returns data. freshcontext returns data plus when it was retrieved and how confident that date is — wrapped in a FreshContext envelope:

[FRESHCONTEXT]
Source: https://github.com/owner/repo
Published: 2024-11-03
Retrieved: 2026-03-05T09:19:00Z
Confidence: high
---
... content ...
[/FRESHCONTEXT]

Claude now knows the difference between something from this morning and something from two years ago. You do too.

---

11 tools. No API keys.

Intelligence

Tool	What it gets you
extract_github	README, stars, forks, language, topics, last commit
extract_hackernews	Top stories or search results with scores and timestamps
extract_scholar	Research papers — titles, authors, years, snippets
extract_arxiv	arXiv papers via official API — more reliable than Scholar
extract_reddit	Posts and community sentiment from any subreddit

Competitive research

Tool	What it gets you
extract_yc	YC company listings by keyword — who's funded in your space
extract_producthunt	Recent launches by topic
search_repos	GitHub repos ranked by stars with activity signals
package_trends	npm and PyPI metadata — version history, release cadence

Market data

Tool	What it gets you
extract_finance	Live stock data — price, market cap, P/E, 52w range

Composite

Tool	What it gets you
extract_landscape	One call. YC + GitHub + HN + Reddit + Product Hunt + npm in parallel. Full timestamped picture.

---

Quick Start

Option A — Cloud (no install)

Add to your Claude Desktop config and restart:

Mac: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "freshcontext": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://freshcontext-mcp.gimmanuel73.workers.dev/mcp"]
    }
  }
}

Restart Claude. Done.

Prefer a guided setup? Visit freshcontext-site.pages.dev — 3 steps, no terminal.

---

Option B — Local (full Playwright)

Requires: Node.js 18+ (nodejs.org)

git clone https://github.com/PrinceGabriel-lgtm/freshcontext-mcp
cd freshcontext-mcp
npm install
npx playwright install chromium
npm run build

Add to Claude Desktop config:

Mac:

{
  "mcpServers": {
    "freshcontext": {
      "command": "node",
      "args": ["/Users/YOUR_USERNAME/path/to/freshcontext-mcp/dist/server.js"]
    }
  }
}

Windows:

{
  "mcpServers": {
    "freshcontext": {
      "command": "node",
      "args": ["C:\\Users\\YOUR_USERNAME\\path\\to\\freshcontext-mcp\\dist\\server.js"]
    }
  }
}

---

Troubleshooting (Mac)

"command not found: node" — Use the full path:

which node  # copy this output, replace "node" in config

Config file doesn't exist — Create it:

mkdir -p ~/Library/Application\ Support/Claude
touch ~/Library/Application\ Support/Claude/claude_desktop_config.json

---

Usage examples

Is anyone already building what you're building?

Use extract_landscape with topic "cashflow prediction saas"

Returns who's funded, what's trending, what repos exist, what packages are moving — all timestamped.

What's the community actually saying right now?

Use extract_reddit on r/MachineLearning
Use extract_hackernews to search "mcp server 2026"

Did that company actually ship recently?

Use extract_github on https://github.com/some-org/some-repo

Check Published vs Retrieved. If the gap is 18 months, Claude will tell you.

---

How freshness works

Most AI tools retrieve data silently. No timestamp, no signal, no way for the agent to know how old it is.

freshcontext treats retrieval time as first-class metadata. Every adapter returns:

• retrieved_at — exact ISO timestamp of the fetch
• content_date — best estimate of when the content was originally published
• freshness_confidence — high, medium, or low based on signal quality
• adapter — which source the data came from

When confidence is high, the date came from a structured field (API, metadata). When it's medium or low, freshcontext tells you why.

---

Security

• Input sanitization and domain allowlists on all adapters
• SSRF prevention (blocked private IP ranges)
• KV-backed global rate limiting: 60 req/min per IP across all edge nodes
• No credentials required — all public data sources

---

Roadmap

• [x] GitHub, HN, Scholar, YC, Reddit, Product Hunt, Finance, arXiv adapters
• [x] extract_landscape — 6-source composite tool
• [x] Cloudflare Workers deployment
• [x] KV-backed global rate limiting
• [x] Listed on official MCP Registry
• [ ] TTL-based caching layer
• [ ] freshness_score numeric metric
• [ ] Job search adapter (the tool that started all this)

---

Contributing

PRs welcome. New adapters are the highest-value contribution — see src/adapters/ for the pattern.

---

License

MIT