ghostfox — Claude Code MCP server: what it does, how to install
Self-hosted stealth browser engine for AI coding agents. Keeps identity profiles and runs local captcha solvers without routing sessions through external clouds.
claude mcp add ghostfox -- npx -y ghostfoxWhat ghostfox does
Standard headless browsers trigger automated anti-bot checks across the web. This package runs an independent Firefox fork modified directly in C++, hiding automation traces from JavaScript detection routines. A companion Rust runtime coordinates browser sessions and handles incoming tool execution.
It bundles 43 MCP tools for browser navigation and on-device puzzle evaluation. The setup solves slider puzzles and hCaptcha challenges locally via CPU inference, eliminating recurring subscriptions to external solver farms. When target sites misbehave, the agent debugs state using page_console and inspects network payloads.
Accessibility checks read directly from Gecko's internal tree rather than relying on DOM wrappers. Tampered page scripts cannot manipulate what the agent observes. Running the server locally requires an active Node.js environment with npx.
What it helps with
- bypass bot protection systems at the browser engine level
- solve interactive captchas locally without paid API keys
- inspect runtime script errors and network traffic on web pages
- read genuine element trees straight from the Gecko engine
Example prompts for the agent
- Launch the target page via ghostfox and inspect runtime issues with page_errors
- Inspect recent HTTP traffic on this active tab with page_network_read
- Solve the challenge shown on screen using the page_hcaptcha tool
How to install ghostfox
Platform CLI
claude mcp add ghostfox -- npx -y ghostfoxPlatform CLI
codex mcp add ghostfox -- npx -y ghostfoxConfig file
{
"mcpServers": {
"ghostfox": {
"command": "npx",
"args": [
"-y",
"ghostfox"
]
}
}
}Config file
{
"servers": {
"ghostfox": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"ghostfox"
]
}
}
}Platform CLI
gemini mcp add ghostfox npx -y ghostfoxStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about ghostfox
How do I install ghostfox in Claude Code?
Run claude mcp add ghostfox -- npx -y ghostfox in your command line. Node.js with npx must be available on your system.
What is ghostfox used for?
It gives AI assistants an anti-detect browser environment without cloud dependencies. User profiles, cookies, and tokens remain isolated on your local computer.
How does ghostfox solve captchas without paid providers?
The runtime bundles lightweight neural networks running locally on your CPU. They detect slide puzzle offsets and match character icons directly.
