🦊 CamoFox MCP

The anti-detection browser MCP server for AI agents. Navigate, interact, and automate the web without getting blocked.

Why CamoFox MCP?

AI agents using Playwright get blocked constantly. CAPTCHAs, fingerprint detection, IP bans — the web fights back against automation.

CamoFox MCP wraps the CamoFox anti-detection browser as an MCP server, giving your AI agent:

• 🛡️ Anti-detection fingerprinting — Each tab gets a unique, human-like browser fingerprint

• ⚡ Fast, token-efficient snapshots — Accessibility tree snapshots use 90% fewer tokens than screenshots

• 🔍 Built-in search — Search Google, YouTube, Amazon + 11 more engines without getting blocked

• 🍪 Session persistence — Import cookies, maintain login state across interactions

• 🎯 CSS selector fallback — Target elements even when accessibility refs aren't available

CamoFox MCP vs Playwright MCP

CamoFox MCP vs Other Camoufox MCPs

Quick Start

Prerequisites

1. Install and run CamoFox Browser:

   # Follow CamoFox installation guide
   # CamoFox must be running on port 9377 (default)

VS Code / Cursor / Claude Desktop

Add to your MCP configuration:

{
  "camofox": {
    "command": "node",
    "args": ["/path/to/camofox-mcp/dist/index.js"],
    "env": {
      "CAMOFOX_URL": "http://localhost:9377"
    },
    "type": "stdio"
  }
}

From Source

git clone https://github.com/redf0x1/camofox-mcp.git
cd camofox-mcp
npm install
npm run build

Tools (18)

Tab Management

Navigation

Interaction

Observation

Search

Session

Configuration

Environment Variables

Architecture

AI Agent (Claude, GPT, etc.)
       │
       │ MCP Protocol (stdio)
       ▼
┌─────────────────┐
│  CamoFox MCP    │  ← This package
│  (TypeScript)   │
└────────┬────────┘
         │
         │ REST API (HTTP)
         ▼
┌─────────────────┐
│  CamoFox Server │  ← Anti-detection browser
│  (Port 9377)    │
└────────┬────────┘
         │
         │ Browser Engine
         ▼
┌─────────────────┐
│  Camoufox       │  ← Firefox-based, fingerprint spoofing
│  (Firefox)      │
└─────────────────┘

How It Works

1. Your AI agent sends MCP tool calls (e.g., create_tab, navigate, snapshot)

2. CamoFox MCP translates these into REST API calls to the CamoFox server

3. CamoFox server manages a Camoufox browser with anti-detection features

4. Each tab gets a unique fingerprint — different user agent, screen size, WebGL, fonts, etc.

5. Websites see what appears to be a normal human browser, not automation

Anti-Detection Features

CamoFox (via Camoufox) provides:

• ✅ Unique browser fingerprint per tab

• ✅ Human-like user agent rotation

• ✅ WebGL fingerprint spoofing

• ✅ Canvas fingerprint protection

• ✅ Screen resolution randomization

• ✅ Font enumeration protection

• ✅ Navigator properties masking

• ✅ Timezone/locale consistency

Contributing

Contributions are welcome! Please open an issue or submit a PR.

License

MIT

Acknowledgments

• CamoFox Browser — The anti-detection browser this MCP wraps

• Camoufox — Firefox-based anti-detection browser engine

• Model Context Protocol — The protocol standard by Anthropic