FrankenSurf
Reads web pages with the cheapest tool that works, then checks the page is real
- 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 frankensurfAdd to claude_desktop_config.json
{
"mcpServers": {
"frankensurf": {
"command": "uvx",
"args": [
"frankensurf"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"frankensurf": {
"command": "uvx",
"args": [
"frankensurf"
]
}
}
}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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Scrapling MCP Server
MCP serverMCP 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

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory