Config is the same across clients — only the file and path differ.
{
"mcpServers": {
"web-retrieval": {
"env": {
"EXA_API_KEY": "exa-...",
"FIRECRAWL_API_KEY": "fc-..."
},
"command": "web-retrieval-mcp"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
web-retrieval-mcp is an open-source Model Context Protocol (MCP) server that gives AI agents two web tools — neural web search (Exa) and a tiered web fetch (Exa → optional local browser → Firecrawl) — as a drop-in replacement for built-in WebSearch/WebFetch. It preserves per-source provenance, guards against SSRF, runs cross-platform (macOS/Linux/Windows), and works with Claude Code, Claude Desktop, Cursor, and any MCP client. Runs on free API tiers.
Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.
uvx 'web-retrieval-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"
After testing, let us know if it worked:
Five weighted categories — click any category to see the underlying evidence.
No known CVEs.
Checked web-retrieval-mcp against OSV.dev.
Be the first to review
Have you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Others in browser / search
Web and local search using Brave Search API
Context7 Platform -- Up-to-date code documentation for LLMs and AI code editors
Browser automation with Puppeteer for web scraping and testing
Production ready MCP server with real-time search, extract, map & crawl.
MCP Security Weekly
Get CVE alerts and security updates for io.github.VelvetSP/web-retrieval-mcp and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
web-retrieval-mcp is an open-source Model Context Protocol (MCP) server that gives AI agents two web tools — neural web search (Exa) and a tiered web fetch (Exa → optional local browser → Firecrawl) — as a drop-in replacement for built-in WebSearch/WebFetch. It preserves per-source provenance, guards against SSRF, runs cross-platform (macOS/Linux/Windows), and works with Claude Code, Claude Desktop, Cursor, and any MCP client. Runs on free API tiers.
An agent's stock WebSearch / WebFetch tend to flatten many sources into one blurry summary, drop provenance, and silently fail on JavaScript-heavy or anti-bot pages. This server fixes that:
| Built-in web tools | web-retrieval-mcp | |
|---|---|---|
| Search results | One merged summary, sources conflated | One block per result — each keeps its own title, URL, highlights, and text, plus a Sources trailer |
| Fetch reliability | Single attempt, gives up on hard pages | Tiered fallback: Exa contents → optional local browser → Firecrawl, with a [served by: …] provenance header |
| JS / anti-bot pages | Usually fails | Opt-in real headless browser (camoufox) on demand |
| Safety | — | SSRF guard rejects loopback / private / link-local / multicast hosts before any request |
| Cost | Bundled / metered by your model vendor | Free on Exa + Firecrawl free tiers (see below) |
Both providers have a genuinely usable free, no-credit-card tier, and because fetches hit Exa first (Firecrawl is only the fallback), a single developer or agent rarely touches the Firecrawl quota at all:
| Provider | Free tier (verified 2026) | Role in this server |
|---|---|---|
| Exa | 1,000 requests / month, no card | Powers web_search and the first web_fetch tier |
| Firecrawl | 1,000 pages / month, no card | Fallback fetch tier only — rarely reached |
| camoufox (local browser) | Unlimited & free — runs on your machine | Opt-in render="always" tier for JS/anti-bot pages |
For a personal agent that's ~33 searches and 33 hard-page fetches every day, indefinitely, for $0/month. Heavy production workloads can upgrade either provider independently — the tiering and code don't change.
web_search — neural / keyword / auto search via Exa, one provenance-preserving block per result.web_fetch — single-URL readable content through a resilient tier chain with provenance headers.keyring library, or an OS secret tool. No keys on the command line.uvx, pipx, or pip; ships two console scripts.# Run with no install — uvx fetches and runs it on demand:
uvx web
... [View full README on GitHub](https://github.com/velvetsp/web-retrieval-mcp#readme)