Skip to main content
Glama
Sign In
camofox-mcp

camofox-mcp

by thebtf
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

camofox-mcp

MCP server for CamoFox — anti-detect browser automation for AI agents.

No local browser is launched. This is a thin MCP wrapper over the CamoFox REST API running elsewhere (Docker, remote server, etc.).

Why

CamoFox provides anti-detect browsing via Camoufox (Firefox fork with C++ fingerprint spoofing). This MCP server lets any MCP-compatible AI agent (OpenClaw, Claude Desktop, etc.) use it as a tool.

Related MCP server: CamoFox MCP

Quick Start

1. Start CamoFox server somewhere

# Docker (recommended)
docker run -p 9377:9377 jo-inc/camofox-browser

# Or standalone
git clone https://github.com/jo-inc/camofox-browser
cd camofox-browser && npm install && npm start

2. Run the MCP server

# With uvx (no install needed)
CAMOFOX_URL=http://your-server:9377 uvx camofox-mcp

# Or install and run
pip install camofox-mcp
CAMOFOX_URL=http://your-server:9377 camofox-mcp

3. Configure your MCP client

OpenClaw (mcporter)

mcporter config add camofox --stdio \
  "CAMOFOX_URL=http://your-server:9377 CAMOFOX_USER=agent uvx camofox-mcp"

Claude Desktop / Cursor

{
  "mcpServers": {
    "camofox": {
      "command": "uvx",
      "args": ["camofox-mcp"],
      "env": {
        "CAMOFOX_URL": "http://your-server:9377",
        "CAMOFOX_USER": "agent"
      }
    }
  }
}

Environment Variables

Variable

Default

Description

CAMOFOX_URL

http://localhost:9377

CamoFox server URL

CAMOFOX_USER

default

User ID for session isolation

CAMOFOX_TIMEOUT

30

HTTP request timeout (seconds)

Tools

Tool

Description

camofox_health

Check server status

camofox_navigate

Open URL → get accessibility snapshot

camofox_snapshot

Get current page snapshot

camofox_click

Click element by ref (e1, e2…)

camofox_type

Type text into element

camofox_press

Press keyboard key

camofox_scroll

Scroll page (up/down/left/right)

camofox_navigate_tab

Navigate existing tab to new URL

camofox_search

Use search macro (@google_search, etc.)

camofox_links

Extract all links from page

camofox_screenshot

Take screenshot (returns file path)

camofox_tabs

List open tabs

camofox_close

Close a tab

camofox_close_all

Close all tabs

camofox_back

Browser history back

camofox_forward

Browser history forward

Search Macros

@google_search · @youtube_search · @amazon_search · @reddit_search · @wikipedia_search · @twitter_search · @yelp_search · @spotify_search · @netflix_search · @linkedin_search · @instagram_search · @tiktok_search · @twitch_search

Architecture

AI Agent ←(MCP/stdio)→ camofox-mcp ←(REST/HTTP)→ CamoFox Server ←→ Camoufox Browser

The MCP server is stateless — all state lives in the CamoFox server. Multiple MCP clients can connect to the same CamoFox instance with different CAMOFOX_USER values for session isolation.

Security

  • All user inputs (URLs, text, refs) are JSON-encoded — no shell interpolation

  • Tab IDs are URL-encoded before use in paths

  • No credentials are stored or transmitted beyond what CamoFox requires

  • The MCP server never launches a browser — it only proxies to an existing CamoFox instance

License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Resources

    Related MCP Connectors

    Related MCP Servers

    • CamoFox MCP

      scolombo74294
      A
      license
      Not graded
      quality
      A
      maintenance
      Gives MCP-compatible AI agents an anti-detection browser toolset for navigating, interacting with, searching, and extracting content from websites, plus downloads, multi-tab workflows, and persistent sessions with cookies and saved profiles. It enables reliable automation of the web without getting blocked by running against a separate Camoufox-based browser server.
      899 npm
      MIT

    • CamoFox MCP

      HelgaSato68
      A
      license
      Not graded
      quality
      A
      maintenance
      Exposes a 47-tool browser automation surface to MCP clients, enabling AI agents to navigate, interact with, observe, and extract content from web pages across multi-tab sessions. Runs on Camoufox-based anti-detection behavior so agents can automate sites that block conventional headless browsers, with session persistence, cookie import, and stdio or HTTP transport.
      899 npm
      MIT

    • CamoFox MCP

      NaokiHunt
      A
      license
      Not graded
      quality
      A
      maintenance
      Connects MCP-compatible AI agents to an anti-detection browser server, providing 47 tools for navigation, interaction, observation, search, extraction, downloads, multi-tab and session workflows. Agents can drive real web pages, reuse saved profiles and cookies, and automate sites that would otherwise block automated access.
      899 npm
      MIT