# ghostfox

Self-hosted stealth browser engine for AI coding agents. Keeps identity profiles and runs local captcha solvers without routing sessions through external clouds.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 12
- Author: autokeren
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/autokeren/ghostfox
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/ghostfox

## What it 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`.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add ghostfox -- npx -y ghostfox
```

### Codex

**Platform CLI**
```bash
codex mcp add ghostfox -- npx -y ghostfox
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "ghostfox": {
            "command": "npx",
            "args": [
                "-y",
                "ghostfox"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "ghostfox": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "ghostfox"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add ghostfox npx -y ghostfox
```

## When to use it
- 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
- 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

## Similar
- [invisible_playwright_mcp](https://affpapa.org/en/nevibecode/mcp/invisible-playwright-mcp.md) — MCP server · ★ 884
- [Svipall](https://affpapa.org/en/nevibecode/mcp/svipall.md) — MCP server · ★ 20
- [browser-fingerprint-audit](https://affpapa.org/en/nevibecode/skills/browser-fingerprint-audit.md) — skill · 102600 installs
- [browser-extension-builder](https://affpapa.org/en/nevibecode/skills/sickn33-browser-extension-builder.md) — skill · 2000 installs
- [steel-reliability](https://affpapa.org/en/nevibecode/skills/steel-reliability.md) — skill · 432 installs
- [browser-act](https://affpapa.org/en/nevibecode/skills/browser-act.md) — skill · 108300 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md