Skip to main content
Glama
thebtf
by thebtf

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: Chrome Extension MCP Bridge

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

A
license - permissive license
-
quality - not tested
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/thebtf/camofox-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server