v0.3.16 · 21 tools live

FreshContext is temporal intelligence infrastructure for AI systems.

FreshContext ranks live signals by freshness, provenance, and decay-aware relevance before they reach an agent.

sourceHacker News / Jobs / GitHub
content_datepreserved
retrieved_atattached
freshness_score0-100
envelopetext + JSON
21freshness-aware MCP tools
3live public product APIs
DARdecay-aware ranking model
JSONstructured provenance envelope

FreshContext MCP is the retrieval layer.

The core MCP server gives Claude Desktop and other agent workflows a set of live tools that return timestamped, provenance-aware context instead of undated scraped text.

FreshContext MCP

Core MCP server with 21 freshness-aware tools.

Adapters cover GitHub, Hacker News, Reddit, arXiv, finance, jobs, Product Hunt, SEC filings, GDELT, government contracts, packages, and composite landscape reports.

Envelope shape
[FRESHCONTEXT]
Source: https://example.com/source
Published: 2026-05-12T09:00:00Z
Retrieved: 2026-05-12T10:00:00Z
Confidence: high
Score: 95/100 (current)
---
Fresh, source-grounded content...
[/FRESHCONTEXT]

[FRESHCONTEXT_JSON]
{ "freshcontext": { "freshness_score": 95 } }
[/FRESHCONTEXT_JSON]

One freshness model, multiple surfaces.

FreshContext now has a small ecosystem: the MCP server, vertical feeds, and operations reporting for the infrastructure behind them.

Core MCP

FreshContext MCP

Core MCP server with freshness-aware tools for Claude and agent workflows.

Signal Feed

Fresh HN Feed

Freshness-ranked Hacker News signals powered by FreshContext scoring.

Signal Feed

Fresh Jobs Feed

Freshness-ranked job listings from public sources, with AI/ML as the default category.

Ops

FreshContext Ops Pulse

Plain-English Cloudflare operations reports for FreshContext Workers, D1, cron, and logs.

Agents should know when a fact is fresh, old, or uncertain.

Every response preserves source provenance, source date, retrieval time, adapter confidence, and a numeric freshness score. The score is decay-aware: different sources decay at different rates because a market quote, a job listing, a research paper, and a repository are not stale on the same clock.

Decay-aware ranking R(t) = R0 · e-λt

R0 is the starting relevance, t is elapsed time, and lambda is the source-specific decay constant. The envelope exposes a 0-100 freshness score; downstream agents can inspect the structured JSON block instead of guessing from prose.

Stamped

Retrieved data is wrapped in a stable FreshContext envelope.

Dated

The source's content_date is preserved separately from retrieval time.

Scored

A freshness_score gives agents a compact 0-100 temporal signal.

Structured

Machine-readable JSON travels with the human-readable context.

Use FreshContext MCP from Claude Desktop or the cloud endpoint.

Use the hosted Cloudflare Worker endpoint for the fastest setup, or run the npm package locally when you want stdio transport on your machine.

1

Open Claude Desktop config

Claude Desktop → Settings → Developer → Edit Config.

2

Add the remote MCP endpoint

This uses the deployed FreshContext Worker. No local Node install required.

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

Restart Claude Desktop

All 21 tools appear automatically after Claude reconnects to the MCP server.

1

Install from npm

npm install -g freshcontext-mcp
2

Add local stdio server

Edit ~/Library/Application Support/Claude/claude_desktop_config.json on macOS or your Claude config path on Linux.

{
  "mcpServers": {
    "freshcontext": {
      "command": "freshcontext-mcp"
    }
  }
}
1

Install from npm

npm install -g freshcontext-mcp
2

Find the executable path

where freshcontext-mcp
3

Add it to Claude Desktop

Use the path returned by where freshcontext-mcp in %APPDATA%\Claude\claude_desktop_config.json.

{
  "mcpServers": {
    "freshcontext": {
      "command": "C:\\Users\\YOUR_NAME\\AppData\\Roaming\\npm\\freshcontext-mcp.cmd"
    }
  }
}

Examples that return freshness-aware context.

These prompts become MCP tool calls, and the resulting context includes provenance, content dates, confidence, freshness_score, and structured JSON.

Use extract_hackernews to find recent discussion around browser agents.
Use extract_company_landscape for Palantir with ticker PLTR.
Use search_jobs to find current AI engineer roles in Europe.
Use extract_idea_landscape for "AI operations monitoring".

Live feeds expose FreshContext as simple HTTP surfaces.

The vertical feeds are built for direct API use, dashboards, Apify actors, and scheduled downstream agents.

Fresh HN Feed

curl "https://fresh-hn-feed.gimmanuel73.workers.dev/v1/hn/feed?limit=10"

Fresh Jobs Feed

curl "https://fresh-jobs-feed.gimmanuel73.workers.dev/v1/jobs/feed?category=ai&limit=10"

FreshContext MCP Health

curl "https://freshcontext-mcp.gimmanuel73.workers.dev/health"

Freshness-aware feeds are moving into agent marketplaces.

Apify Actor

Fresh HN Feed Actor

Run freshness-ranked Hacker News collection from Apify. Private actor deployed; public listing pending.

Apify Actor

Fresh Jobs Feed Actor

Run freshness-ranked job collection from Apify. Apify listing coming soon.

Short roadmap, focused on measurable signal quality.

Research Resurgence Tracker

Detect papers and topics becoming newly relevant again.

Trend Half-Life API

Expose source-specific decay estimates for external agents.

Signal Digest Agent

Push compact daily digests when high-value signals cross a threshold.

GitHub Release Intelligence Feed

Rank release notes by recency, velocity, and operational relevance.