Skip to content
MCP server

web-retrieval-mcp

MCP web search + tiered web fetch for AI agents (Exa, Firecrawl), SSRF-guarded…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.1.2
Listing updated
4 days ago

About web-retrieval-mcp

web-retrieval-mcp is an open-source MCP server for web search and scraping. It runs locally on your machine and is started by your AI client.

MCP web search + tiered web fetch for AI agents (Exa, Firecrawl), SSRF-guarded, cross-platform.

Install

Run in a terminal

claude mcp add web-retrieval-mcp --env EXA_API_KEY='<EXA_API_KEY>' --env FIRECRAWL_API_KEY='<FIRECRAWL_API_KEY>' -- uvx web-retrieval-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "web-retrieval-mcp": {
      "command": "uvx",
      "args": [
        "web-retrieval-mcp"
      ],
      "env": {
        "EXA_API_KEY": "<EXA_API_KEY>",
        "FIRECRAWL_API_KEY": "<FIRECRAWL_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "web-retrieval-mcp": {
      "command": "uvx",
      "args": [
        "web-retrieval-mcp"
      ],
      "env": {
        "EXA_API_KEY": "<EXA_API_KEY>",
        "FIRECRAWL_API_KEY": "<FIRECRAWL_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "web-retrieval-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "web-retrieval-mcp"
      ],
      "env": {
        "EXA_API_KEY": "<EXA_API_KEY>",
        "FIRECRAWL_API_KEY": "<FIRECRAWL_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "web-retrieval-mcp": {
      "command": "uvx",
      "args": [
        "web-retrieval-mcp"
      ],
      "env": {
        "EXA_API_KEY": "<EXA_API_KEY>",
        "FIRECRAWL_API_KEY": "<FIRECRAWL_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "web-retrieval-mcp": {
      "command": "uvx",
      "args": [
        "web-retrieval-mcp"
      ],
      "env": {
        "EXA_API_KEY": "<EXA_API_KEY>",
        "FIRECRAWL_API_KEY": "<FIRECRAWL_API_KEY>"
      }
    }
  }
}

Configuration

  • EXA_API_KEYExa API key (free tier at https://exa.ai)Required
  • FIRECRAWL_API_KEYFirecrawl API key (free tier at https://firecrawl.dev)Required

Pricing

Open source

web-retrieval-mcp FAQ

Is web-retrieval-mcp free?

Yes. web-retrieval-mcp is open source, so you can use and self-host it for free.

How do I add web-retrieval-mcp to Claude Code?

Run this command in your terminal: claude mcp add web-retrieval-mcp --env EXA_API_KEY='<EXA_API_KEY>' --env FIRECRAWL_API_KEY='<FIRECRAWL_API_KEY>' -- uvx web-retrieval-mcp

What are the best alternatives to web-retrieval-mcp?

The closest alternatives to web-retrieval-mcp are Scrapling MCP Server, Codebase Memory, XERJ, Firecrawl MCP Server and Claude Code Ultimate Guide.

Alternatives to web-retrieval-mcp

  1. MCP server for AI clients to scrape sites with HTTP and stealth browser sessions

    Runs locally
    • 17 tools
    • Open source
    • 104K GitHub stars
    • Web search and scraping
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  4. MCP server that lets AI agents search, scrape and interact with web pages

    • 3 tools
    • Remote
    • Freemium
    • 7.8K GitHub stars
    • Web search and scraping
  5. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  6. SearXNG Search

    MCP server

    MCP server for web search and page reading through a SearXNG instance

    Runs locally
    • 3 tools
    • Open source
    • 1.4K GitHub stars
    • Web search and scraping