Skip to content
MCP server

FrankenSurf

Reads web pages with the cheapest tool that works, then checks the page is real

Runs locallyStatus and history
Pricing
Free
Platforms
CLI, self-hosted, Linux
Runs
Locally
Version
0.50.0
Listing updated
2 days ago

About FrankenSurf

FrankenSurf is a free MCP server for web search and scraping. It runs locally on your machine and is started by your AI client.

Frankensurf tries plain HTTP first, then Jina Reader, local and free stealth browsers, and only reaches for paid unblocking APIs if you allow them. Each result is checked so a CAPTCHA, login wall or an empty app shell counts as a failure with a receipt explaining why. The site says about 40 percent of reads never open a browser.

The registry lists 28 tools. It also runs as a Firecrawl-compatible server in one Docker container, as a Python package and CLI, and with adapters for LangChain and the OpenAI Agents SDK. Every provider, built in or yours, is a plugin that inherits routing, pacing, page checks, retries, cost caps and receipts; plugins must be trusted by name.

The benchmark figures on the site come from the author's own blind sets of 150 and 148 sites, so treat them as the project's claims. When a site needs a human, such as a 2FA prompt, the wall is handed back to you.

Install

Run in a terminal

claude mcp add frankensurf -- uvx frankensurf

Add to claude_desktop_config.json

{
  "mcpServers": {
    "frankensurf": {
      "command": "uvx",
      "args": [
        "frankensurf"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "frankensurf": {
      "command": "uvx",
      "args": [
        "frankensurf"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "frankensurf": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "frankensurf"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "frankensurf": {
      "command": "uvx",
      "args": [
        "frankensurf"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "frankensurf": {
      "command": "uvx",
      "args": [
        "frankensurf"
      ]
    }
  }
}

What it does

Cost-ordered escalation
Starts with plain HTTP and climbs to browsers and paid APIs only when needed.
Page checks
Treats challenge pages, login walls and unloaded results as failures with a reason.
Firecrawl-compatible API
Runs as a self-hosted server that tools with a Firecrawl URL setting can use.
Plugin system
Add a provider by writing one class and inherit routing and cost caps.
Search with checks
Search results are checked for topic, page type and date window.
Human handoff
Returns walls such as 2FA prompts to the user instead of guessing.

Good for

  • Let an agent read pages that block simple fetches
  • Replace a hosted scraping API with a self-hosted one
  • Search the web with a recency window and checked results
  • Cap spend on paid unblockers

Pricing

Free

Free and self-hosted; optional paid fallback providers

Prices change. Check frankensurf.dev before you buy.

FrankenSurf FAQ

Is it free?

The site calls it free and self-hosted; paid fallback providers are used only if you enable them.

How do I install the MCP server?

pip install "frankensurf[mcp]", then claude mcp add frankensurf -- frankensurf-mcp.

What Python version is needed?

Python 3.12 or newer, on Linux, macOS or Windows through WSL.

Can it replace Firecrawl?

It speaks Firecrawl's API, and a compare command lets you test it against your own URLs.

Is FrankenSurf free?

Yes. FrankenSurf is free to use.

How do I add FrankenSurf to Claude Code?

Run this command in your terminal: claude mcp add frankensurf -- uvx frankensurf

What are the best alternatives to FrankenSurf?

The closest alternatives to FrankenSurf are REA, Scrapling MCP Server, Codebase Memory, GitHub and Serena MCP: the IDE for your agent.

Alternatives to FrankenSurf

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. 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
  3. 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
  4. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  5. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  6. 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