# FrankenSurf

> FrankenSurf is a free MCP server for web search and scraping. Reads web pages with the cheapest tool that works, then checks the page is real. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, self-hosted, Linux, macOS, API
- **Website:** https://frankensurf.dev
- **Repository:** https://github.com/yail259/frankensurf
- **MCP Registry name:** io.github.yail259/frankensurf
- **Categories:** web search and scraping, developer tools
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add frankensurf -- uvx frankensurf
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "frankensurf": {
      "command": "uvx",
      "args": [
        "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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Firecrawl MCP Server](https://ai-powered.com/mcp/firecrawl-mcp-server): Firecrawl MCP Server is a freemium MCP server for web search and scraping.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/frankensurf
