# FreshContext

An MCP server that discounts stale documents in retrieval workflows using publication dates. It stops agents from acting on outdated search snippets.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 12
- Author: PrinceGabriel-lgtm
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/PrinceGabriel-lgtm/freshcontext-mcp
- Updated: 2026-09-30
- HTML: https://affpapa.org/en/nevibecode/mcp/freshcontext

## What it does

Vector retrieval often pulls obsolete documents because cosine similarity only compares text meaning. A blog post from several years ago can easily outrank recent technical documentation. FreshContext inserts an evaluation step between fetching data and agent execution. It modifies the initial score with an exponential decay calculation tailored to the source format, such as blog posts or academic papers.

The core tool in the server is `evaluate_context`. Agents pass in retrieved candidate texts alongside publication timestamps, source URLs, and task profiles. In return, the server generates an action recommendation, confidence ratings, explicit warnings, and a standard envelope.

Version 0.5.3 marks the final release of `freshcontext-mcp`, as development on this repository has ended. Existing builds remain under the MIT license, accessible either through a local Node.js process with `npx` or via the remote endpoint at `https://api.freshcontext.dev/mcp`.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://api.freshcontext.dev/mcp`

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http freshcontext https://api.freshcontext.dev/mcp
```

2. **Platform CLI**
```bash
claude mcp add freshcontext -- npx -y freshcontext-mcp
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add freshcontext --url https://api.freshcontext.dev/mcp
```

2. **Platform CLI**
```bash
codex mcp add freshcontext -- npx -y freshcontext-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "freshcontext": {
            "url": "https://api.freshcontext.dev/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "freshcontext": {
            "command": "npx",
            "args": [
                "-y",
                "freshcontext-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "freshcontext": {
            "type": "http",
            "url": "https://api.freshcontext.dev/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "freshcontext": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "freshcontext-mcp"
            ]
        }
    }
}
```

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http freshcontext https://api.freshcontext.dev/mcp
```

2. **Platform CLI**
```bash
gemini mcp add freshcontext npx -y freshcontext-mcp
```

## When to use it
- Downrank stale search snippets in retrieval pipelines
- Balance semantic similarity against publication age
- Generate structured confidence verdicts for candidate sources
- Flag outdated context before passing it to LLMs

## Example prompts
- Evaluate the freshness of these search results with `evaluate_context`.
- Check whether our retrieved research links are still current for this citation.
- Rank candidate sources by decay-adjusted relevancy and show any date warnings.

## Similar
- [rag-engineer](https://affpapa.org/en/nevibecode/skills/sickn33-rag-engineer.md) — skill · 1000 installs
- [evaluate-rag](https://affpapa.org/en/nevibecode/skills/evaluate-rag.md) — skill · 970 installs
- [prompt-engineering](https://affpapa.org/en/nevibecode/skills/neolabhq-prompt-engineering.md) — skill · 1400 installs
- [llm-context](https://affpapa.org/en/nevibecode/skills/llm-context.md) — skill · 1300 installs
- [rag](https://affpapa.org/en/nevibecode/skills/rag.md) — skill · 3700 installs
- [rag-architect](https://affpapa.org/en/nevibecode/skills/rag-architect.md) — skill · 629 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md