Fantoma
Stealth browser MCP that reads pages through the accessibility tree for small models
- Pricing
- Open source
- Platforms
- CLI, self-hosted, Linux
- Runs
- Locally
- Version
- 0.13.1
- Listing updated
- today
Similar MCP servers
About Fantoma
Fantoma is an open-source MCP server for browser automation. It runs locally on your machine and is started by your AI client.
Fantoma sees a page the way a screen reader does: as structured text, not screenshots. The README says a step costs about 500 tokens against 1,000 to 5,000 for a screenshot, which is what makes a small local model practical. It reports results from a 31-site run where a 35B local model scored 30 of 31 on reading, and is frank that multi-step interaction on small models is weaker.
Much of the work is done by code rather than a model: reading a URL as Markdown with hidden text removed, filling logins, searching, selecting options and adding items to a cart, with checks after each step. Camoufox (Firefox) is the default browser and Patchright (Chromium) is optional. Page text is fenced and domain allow and block lists are available as guards against instructions embedded in pages.
Five MCP tools run a built-in browser with pip install "fantoma[mcp]". Two of them need an OpenAI-compatible LLM such as Ollama. It needs Python 3.10+ on Linux or macOS.
Install
Run in a terminal
claude mcp add fantoma -- uvx fantomaAdd to claude_desktop_config.json
{
"mcpServers": {
"fantoma": {
"command": "uvx",
"args": [
"fantoma"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"fantoma": {
"command": "uvx",
"args": [
"fantoma"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"fantoma": {
"type": "stdio",
"command": "uvx",
"args": [
"fantoma"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"fantoma": {
"command": "uvx",
"args": [
"fantoma"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"fantoma": {
"command": "uvx",
"args": [
"fantoma"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Tools this server provides (5)
Taken from the project documentation; the running server may differ.
- fantoma_read
- Open a URL and return clean Markdown and links, flagging bot checks or login walls; no LLM.
- fantoma_login
- Fill and submit a login form with code alone.
- fantoma_extract
- Open a page and extract data, optionally as JSON matching a schema.
- fantoma_run
- Run a plain-English browsing task to completion.
- fantoma_health
- Report mode and whether an LLM and browsers are reachable.
What it does
- Accessibility-tree reading
- Pages as compact structured text, about 500 tokens a step.
- Model-free reading and login
- fantoma_read and fantoma_login need no LLM.
- Local model support
- Works with Ollama, llama.cpp, vLLM or a cloud API.
- Page-injection guards
- Hidden-text removal, fenced page text and domain lists.
- Block detection
- Reports bot challenges and login walls.
- Skill file
- Includes an Agent Skills file for coding agents.
Good for
- Read a page as Markdown without calling a model
- Log in to a site and carry the session into later reads
- Extract structured data from a page against a schema
- Run a short browsing task on a local model
- Drive a browser from your own agent loop
Pricing
Open source
Open-source Python package on PyPI
Fantoma FAQ
Which tools need an LLM?
fantoma_extract and fantoma_run. Read, login and health do not.
What do I need to run it?
Python 3.10 or newer on Linux or macOS; Windows via WSL.
How well do small models handle interaction?
The README says a local 35B model finished 1 of 6 login and form flows in one test; later versions handle common steps in code.
How do I add it to Claude Code?
pip install "fantoma[mcp]", then claude mcp add fantoma -- fantoma-mcp.
Is Fantoma free?
Yes. Fantoma is open source, so you can use and self-host it for free.
How do I add Fantoma to Claude Code?
Run this command in your terminal: claude mcp add fantoma -- uvx fantoma
What are the best alternatives to Fantoma?
The closest alternatives to Fantoma are Browser Use, Scrapling MCP Server, Chrome DevTools MCP, Oya Browser and playwright_mcp.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.


