camofox-browser-mcp

Name: camofox-browser-mcp
Author: jo

MCP adapter that drives a Camoufox anti-detection Firefox through the camofox-browser REST server

By jo JavaScript Local · stdio Browser automation

GitHub npm Website

54 popularity score ★ 12k ↓ 520/wk

Connect your client

Local (npm)

Add in one click

Add to Cursor Add to VS Code Add to LM Studio Add to Goose

Opens the app, which asks before it adds the server.

Or add it by command or config

Claude CodeTerminal

claude mcp add camofox-browser -- npx -y @askjo/camofox-browser-mcp

Claude Desktopclaude_desktop_config.json

{
  "mcpServers": {
    "camofox-browser": {
      "command": "npx",
      "args": [
        "-y",
        "@askjo/camofox-browser-mcp"
      ]
    }
  }
}

Cursor~/.cursor/mcp.json

{
  "mcpServers": {
    "camofox-browser": {
      "command": "npx",
      "args": [
        "-y",
        "@askjo/camofox-browser-mcp"
      ]
    }
  }
}

VS Code.vscode/mcp.json

{
  "servers": {
    "camofox-browser": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@askjo/camofox-browser-mcp"
      ]
    }
  }
}

Codex~/.codex/config.toml

[mcp_servers.camofox-browser]
command = "npx"
args = ["-y", "@askjo/camofox-browser-mcp"]

Gemini CLITerminal

gemini mcp add --scope user camofox-browser npx -- -y @askjo/camofox-browser-mcp

Local (from source)

Add in one click

Add to Cursor Add to VS Code Add to LM Studio

Opens the app, which asks before it adds the server.

Or add it by command or config

FirstTerminal

git clone https://github.com/jo-inc/camofox-browser
cd camofox-browser/mcp
npm install
npm link

Claude CodeTerminal

claude mcp add camofox-browser -- camofox-browser-mcp

Claude Desktopclaude_desktop_config.json

{
  "mcpServers": {
    "camofox-browser": {
      "command": "camofox-browser-mcp",
      "args": []
    }
  }
}

Cursor~/.cursor/mcp.json

{
  "mcpServers": {
    "camofox-browser": {
      "command": "camofox-browser-mcp",
      "args": []
    }
  }
}

VS Code.vscode/mcp.json

{
  "servers": {
    "camofox-browser": {
      "type": "stdio",
      "command": "camofox-browser-mcp",
      "args": []
    }
  }
}

Codex~/.codex/config.toml

[mcp_servers.camofox-browser]
command = "camofox-browser-mcp"
args = []

Gemini CLITerminal

gemini mcp add --scope user camofox-browser camofox-browser-mcp

Settings 5

`CAMOFOX_BASE_URL`	Optional: Address of the camofox-browser REST server; defaults to http://localhost:9377.
`CAMOFOX_ACCESS_KEY`	Optional: Bearer token sent on every call; must match the REST server's key when it has one set.
`CAMOFOX_API_KEY`	Optional: Secret for cookie import; must match the REST server's value, needed on remote servers.
`CAMOFOX_USER_ID`	Optional: Session identity used for isolation; defaults to a random mcp- value.
`CAMOFOX_SESSION_KEY`	Optional: Tab partition within the user; defaults to default.

What it does

camofox-browser-mcp is a small stdio MCP server that turns tool calls into HTTP requests against a camofox-browser REST server. That REST server is the main product of the same repository: it launches Camoufox, a Firefox fork that spoofs browser fingerprints in its C++ code, and exposes tabs, accessibility snapshots, clicks and typing over port 9377. The MCP package itself carries no browser; its only dependency is the MCP SDK, so the REST server can run on the same machine or on another host reached through CAMOFOX_BASE_URL.

An assistant opens a tab on a URL, takes an accessibility snapshot that labels page elements with short refs (e1, e2 ...) and an optional screenshot, then clicks or types against those refs and snapshots again to see the result. It can also navigate with search macros for sites such as Google and Reddit, run JavaScript inside the page, list and close tabs, and load a Netscape-format cookie file so later browsing is signed in.

The repository holds more than this server: the REST browser server, a Docker build, an OpenClaw plugin that shares the same 11 tool definitions, and a crash-report worker. The makers pitch the browser as getting past bot detection on sites such as Google and Cloudflare, which may run against the terms of sites a user visits.

What it needs

Runtime	Node.js

Node.js with npm (npx) for the adapter. A running camofox-browser REST server it can reach, by default at http://localhost:9377; starting that server locally means cloning the repository and running npm install, which downloads the Camoufox browser (about 300 MB), or using its Docker build.

Limits

It does nothing on its own: every tool fails unless the camofox-browser REST server is up. Its docs say camofox_scroll can report success without moving lazy-loading or virtual-scroll pages (use camofox_evaluate instead), that a CSS selector matching several elements is rejected with a 422 error, and that a dead browser session returns 503 until the REST server is restarted. Cookie import needs CAMOFOX_API_KEY on remote servers. Each MCP process uses one camofox session.

Who it suits

Suits developers whose agents need to read or act on sites that block ordinary headless browsers, and who are willing to run the camofox-browser REST server themselves, locally, on a small server or in Docker. Because the adapter is thin, it also fits teams that host one browser server and point several assistants at it. It is a community project rather than a vendor's product, it runs a real browser that can submit forms and execute page scripts, and its anti-detection aim may clash with some sites' terms. If you only need plain page fetching or ordinary Playwright-style testing, a lighter browser server without a separate backend is simpler to set up.

Tools 11

camofox_create_tab: Open a new tab on a URL and return its tab id
camofox_snapshot: Return an accessibility snapshot with element refs and a screenshot
camofox_navigate: Load a URL or run a site search macro in a tab
camofox_click: Click an element by ref or CSS selector
camofox_type: Enter text into an element, optionally pressing Enter
camofox_scroll: Scroll the page by a number of pixels
camofox_screenshot: Capture a screenshot of a tab
camofox_evaluate: Run JavaScript inside the page and return the result
camofox_list_tabs: List the tabs open in the current session
camofox_close_tab: Close a tab
camofox_import_cookies: Load cookies from a Netscape cookie file into the session

Popularity

54 popularity score, on our list (the bar is 36)

★ 12k ↓ 520/wk

GitHub stars, whole repository	12,196	21.7 points
Stars in 30 days	+643	10 points
npm downloads, last week	520	21.7 points

It lives in the folder mcp of jo-inc/camofox-browser, which holds more than this server. Its stars are the whole repository's, so in the score they never count for more than its own downloads.

Measured 2026-11-07. How the score works.

Where it is published

Code	jo-inc/camofox-browser/mcp ★ 12k, the whole repository
npm	@askjo/camofox-browser-mcp 1.18.1, 2026-10-05

What it can reach

Runs	On your machine
Reaches	Drives a browser, The internet, Your account at a service
Changes things	Yes: it can write, send, create or delete
Sign-in	None
Licence	MIT (npm)
Last code change	2026-10-05

The adapter only makes HTTP calls to the REST server named in CAMOFOX_BASE_URL; the browser itself runs wherever that server runs, by default your own machine. Through it an assistant can open any URL, click, type and submit forms, and run arbitrary JavaScript in pages. Imported cookies let it act inside the user's signed-in web accounts. The REST server listens on port 9377 on all interfaces unless CAMOFOX_BIND_HOST is set, and is open unless CAMOFOX_ACCESS_KEY is configured. The REST server sends anonymized crash and hang reports, including stripped target URLs, to an endpoint run by the makers; CAMOFOX_CRASH_REPORT_ENABLED=false turns this off.

Over time

GitHub stars, whole repository 12k +634 (+5 %)

12k12k

13 Oct 20267 Nov 2026

npm downloads a week 520 +400 (+333 %)

1.1k120

10 Aug 20267 Nov 2026

Before the site measured it, read from npm's daily download counts.

Popularity score 54 +5 (+9 %)

540

13 Oct 20267 Nov 2026

What is rising across the directory

Sources

Page checked 2026-10-13.

Badge for your README

Shows this server's rank in its category, and stars for a server that runs on your machine. It updates every hour.

MarkdownREADME.md

[![camofox-browser-mcp on EveryMCPServer](https://everymcpserver.com/badge/camofox-browser-2.svg)](https://everymcpserver.com/servers/camofox-browser-2)

Connect your client

Add in one click

Or add it by command or config

Add in one click

Or add it by command or config

Settings 5

What it does

What it needs

Limits

Who it suits

Tools 11

Similar servers

BrowserOS neo

Browser Use

Browser Use MCP Server

Browser Use Cloud MCP

BrowserStack MCP Server

Hyperbrowser MCP Server