# Intercept

Intercept hands the agent page content as clean markdown instead of 403 errors, script walls, or raw HTML. Useful when the model needs to read articles, tickets and docs on its own.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 9 repo stars
- Author: bighippoman
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/bighippoman/intercept-mcp
- Updated: 2026-08-02
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/intercept

## What it does

The server routes a URL through dedicated handlers first. Twitter, YouTube, arXiv, Wikipedia and GitHub each have their own extractor that returns structured data: tweet text with author, video transcript, paper abstract, repo README. Everything else goes into a multi-tier fallback with fifteen strategies.

When one fetcher fails, the next one takes over: the shared agentsweb.org cache, Jina Reader, Wayback Machine, Common Crawl, the Codetabs CORS proxy, archive.ph, and a direct request converted through Turndown. Tier 2 fetchers run in parallel and the best result wins. Output is real markdown — headings, tables, code blocks.

The basic `fetch` tool needs no API keys. GitHub API calls work unauthenticated but cap at 60 requests per hour, so heavy issue or release work calls for a `GITHUB_TOKEN`. Shared caching can be turned off with `INTERCEPT_SHARED_CACHE=false` or set to consume-only with `INTERCEPT_CACHE_READ_ONLY=true`. Direct image links come back as an image block so the agent's vision model can read charts and screenshots.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `BRAVE_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add intercept-mcp -e BRAVE_API_KEY=<BRAVE_API_KEY> -- npx -y intercept-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add intercept --env BRAVE_API_KEY=<BRAVE_API_KEY> -- npx -y intercept-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "intercept": {
            "command": "npx",
            "args": [
                "-y",
                "intercept-mcp"
            ],
            "env": {
                "BRAVE_API_KEY": "<BRAVE_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "intercept": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "intercept-mcp"
            ],
            "env": {
                "BRAVE_API_KEY": "<BRAVE_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e BRAVE_API_KEY=<BRAVE_API_KEY> intercept npx -y intercept-mcp
```
Replace <…> with your own values

## When to use it
- read a page behind Cloudflare or DDoS-Guard
- pull a transcript from a YouTube video
- inspect a GitHub issue with comments and diff stats
- extract text from a PDF without downloading it by hand
- fetch ten URLs in parallel with a single call

## Example prompts
- Fetch this article and summarise the main points
- Look at github.com/project/repo/issues/42 and tell me what's being asked
- Compare these two YouTube videos by transcript and find shared themes

## Similar
- [Exa Search](https://affpapa.org/en/nevibecode/mcp/exa-search.md) — MCP server · 9181 installs
- [Ghostrouter](https://affpapa.org/en/nevibecode/mcp/ghostrouter.md) — MCP server · 5398 installs
- [firecrawl-scrape](https://affpapa.org/en/nevibecode/skills/firecrawl-scrape.md) — skill · 84400 installs
- [defuddle](https://affpapa.org/en/nevibecode/skills/defuddle.md) — skill · 76500 installs
- [Keenable Web Search](https://affpapa.org/en/nevibecode/mcp/keenable-web-search.md) — MCP server · 2498 installs
- [firecrawl-knowledge-ingest](https://affpapa.org/en/nevibecode/skills/firecrawl-knowledge-ingest.md) — skill · 31600 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
