Skip to main content
Glama

CamoFox MCP

AI-powered anti-detection browser automation for MCP-compatible AI agents.

CamoFox MCP connects MCP clients such as Claude Desktop, VS Code, Cursor, and OpenClaw to the CamoFox browser server. It gives agents a practical browser toolset for navigation, interaction, search, extraction, downloads, and session reuse while relying on Camoufox-based anti-detection behavior underneath.

Key Features

  • 53 browser automation tools across navigation, interaction, observation, search, downloads, sessions, network capture, and batch workflows.

  • Anti-detection browser automation built on top of the CamoFox browser server and Camoufox.

  • Multi-tab workflows with tracked state, history, and cleanup.

  • Session persistence with cookie import, saved profiles, and optional auto-save.

  • Token-efficient accessibility snapshots with CSS-selector fallbacks for difficult SPA flows.

  • OpenClaw-compatible HTTP transport, plus standard stdio support for desktop MCP clients.

Related MCP server: scout-mcp-server

Quick Install

You need both components running:

  1. camofox-browser handles the anti-detection browser.

  2. camofox-mcp exposes that browser to your MCP client.

Option A: npx + stdio

Start the browser server:

npx camofox-browser@latest

Add CamoFox MCP to your MCP client:

{
  "servers": {
    "camofox": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "camofox-mcp@latest"],
      "env": {
        "CAMOFOX_URL": "http://localhost:9377"
      }
    }
  }
}

Option B: Docker

Start the browser server:

docker run -d -p 9377:9377 --name camofox-browser ghcr.io/redf0x1/camofox-browser:latest

Run CamoFox MCP in HTTP mode for remote MCP clients such as OpenClaw:

docker run -p 3000:8080 --rm \
  -e CAMOFOX_TRANSPORT=http \
  -e CAMOFOX_HTTP_HOST=0.0.0.0 \
  -e CAMOFOX_HTTP_API_KEY=replace-with-32-plus-random-chars \
  -e CAMOFOX_URL=http://host.docker.internal:9377 \
  ghcr.io/redf0x1/camofox-mcp:latest node dist/http.js

Configure your HTTP MCP client to connect to http://localhost:3000/mcp with Authorization: Bearer replace-with-32-plus-random-chars.

Full client configuration examples live in docs/getting-started.md.

Quick Verify

Use camofox-browser 2.4.7 or newer. Browser 2.4.7 adds the supported Windows x64 headless portable distribution and hardens session-scoped navigation recovery without changing the MCP-facing REST request shapes used here. Browser 2.4.6 pins the Camoufox-compatible Playwright protocol dependency for fresh installs, 2.4.5 adds explicit browser auth modes including CAMOFOX_AUTH_MODE=disabled for trusted private agent networks, and 2.4.4 fixes the persistent-context cold-start about:blank page reuse path.

Verify the browser server is reachable:

curl -fsS http://localhost:9377/health

Expected response includes "ok":true and "running":true. On a cold server with no active tabs yet, browserConnected can be false; create a tab to start a browser session.

Tool Categories

Category

Tool count

Docs

Health

1

Health

Tabs

3

Tabs

Navigation

4

Navigation

Interaction

8

Interaction

Observation

8

Observation

Search

1

Search

Session

4

Session

Profiles

4

Profiles

Downloads

3

Downloads

Extraction

4

Extraction

Batch workflows

6

Batch

Presets

1

Presets

Network capture

6

Network capture

Network capture

Network capture requires camofox-browser 2.5.0 or newer. Older compatible browser versions remain usable for ordinary tools without networkCapture.

Use create_tab with networkCapture: {} to record metadata from the initial navigation. For a session-wide capture, set networkCapture.scope to session, then reuse the returned session key and pass the capture key as networkCapture.joinKey when creating additional tabs. To start recording later, create the tab with networkCapture.start set to false and call network_capture_start.

Use network_list_requests with nextCursor as the next after value, and network_get_response for one request's metadata. Call network_capture_stop before network_export_har for a stable export. Keep an enrolled tab open until the export finishes.

If the browser enables body capture, set networkCapture.captureBodies to true at creation and use includeBody: true with network_get_response.

Use network_intercept to replace exact-match fetch/XHR abort or static mock rules on an active tab capture. The browser operator must configure CAMOFOX_API_KEY and enable CAMOFOX_NETWORK_INTERCEPTION=true.

See the network tool reference for all six tools, opt-in settings, and interception limits.

The browser server must advertise network capture support. The networkKey returned by create_tab grants access to that capture and may appear in tool transcripts. Keep it private, and avoid forwarding capture results to untrusted recipients. Exports may contain application-specific URL paths.

Top Limitations

  • CamoFox MCP is not a standalone browser. You must run a compatible camofox-browser server separately.

  • MCP can share the camofox CLI default browser profile/context when create_tab uses userId: "cli-default" and sessionKey: "default", but it cannot reliably attach to a tab the CLI already opened. Importing/adopting existing CLI tabs is a future feature.

  • Headed browser window size follows browser viewport/display-size behavior. Pass viewport, for example { "width": 1366, "height": 768 }, or set CAMOFOX_VIEWPORT=1366x768 / --viewport 1366x768 for a default new-tab size. Supported defaults use width 320..3840 and height 240..2160.

  • On Windows x64, camofox-browser 2.4.7 supports the portable distribution in headless=true mode. Headed and virtual-display modes remain unsupported on Windows; toggle_display will reject those modes there.

  • Accessibility-tree refs are the primary interaction model, but SPA and custom-component sites can require CSS selectors or rendered HTML tools.

  • If the browser server enforces authentication, API-key-gated operations need the same CAMOFOX_API_KEY on both sides.

  • For trusted private-network browser deployments using CAMOFOX_AUTH_MODE=disabled, leave CAMOFOX_API_KEY unset in CamoFox MCP. MCP then sends no outbound browser auth headers. Keep both browser and MCP access on a trusted private network.

  • If HTTP transport is exposed beyond loopback, set CAMOFOX_HTTP_API_KEY and require clients to send it as a Bearer token.

  • HTTP transport is mainly for remote MCP clients. Desktop MCP clients usually work best with stdio configuration.

Security

Treat this as a browser control surface. In shared or networked environments, isolate the browser server, avoid exposing MCP endpoints broadly, and use CAMOFOX_HTTP_API_KEY for inbound HTTP MCP clients plus CAMOFOX_API_KEY when the browser server requires authentication. If the browser server runs CAMOFOX_AUTH_MODE=disabled, leave CAMOFOX_API_KEY unset and keep that browser endpoint on a trusted private network. Session profiles can contain sensitive cookies and should be stored accordingly.

Documentation

Start at docs/README.md for the documentation hub, then use docs/getting-started.md for setup, verification, and first workflow examples.

Contributing + License

See CONTRIBUTING.md for contribution guidelines, SECURITY.md for private vulnerability reporting, and LICENSE for the MIT license.

Custom search engines

Set CAMOFOX_SEARCH_URL_TEMPLATE in the MCP server environment, for example https://search.example/search?q={query}&language=en, then call web_search({ tabId: "tab_123", query: "café & tea", engine: "custom" }). For SearXNG, use your instance's /search?q={query} URL. Restart MCP after changing its environment. Google remains the default; the 14 browser macros are unchanged.

The template must be an absolute HTTP(S) URL with exactly one literal {query} in its path or query, never its host, credentials, or fragment. Credentials in URLs are rejected. The query is percent-encoded once, including Unicode and &. Invalid configuration fails startup without reflecting the URL or its tokens; custom without configuration returns an actionable error (no fallback).

Custom search uses ordinary browser navigate, then snapshot, not a new macro or a direct MCP HTTP fetch to the search engine. Browser URL validation and existing private-network/SSRF policy remain authoritative, including redirects. Self-hosted or private SearXNG requires the browser's existing network policy to allow it; this setting does not grant access or weaken that policy. Do not store secrets in search URLs: navigated URLs can appear in tool output, browser history and logs.

Available Tools

47 tools
batch_clickA

Click multiple elements sequentially. Continues on error (clicks are independent). Returns per-click results.

Inputs: tabId (required), clicks (required), delayMs.

batch_downloadA

Extract resources from a DOM container and download them all. Combines extract_resources + download in one call. Useful for downloading all images from a chat, all PDFs from a table, etc.

Inputs: tabId (required), ref, types, userId, +5 more.

camofox_close_sessionA

Close all browser tabs for a user session. Use for complete cleanup when done with a browsing session.

Inputs: tabId (required).

camofox_evaluate_jsA

Execute JavaScript in the browser page context. Runs in isolated scope (invisible to page scripts — safe for anti-detection). Use for: extracting data not visible in accessibility snapshot, checking element properties, reading computed styles, manipulating DOM elements. Requires CAMOFOX_API_KEY only when browser-server authentication is enabled.

Inputs: tabId (required), expression (required), timeout.

camofox_get_page_htmlA

Get rendered HTML from the live DOM. Use when snapshot refs are incomplete on SPA/custom-component sites or when you need the final DOM state rather than the accessibility tree. Optionally pass a CSS selector to return only that element's outerHTML instead of the full page. Requires CAMOFOX_API_KEY only when browser-server authentication is enabled.

Inputs: tabId (required), selector.

camofox_hoverA

Hover over an element to trigger tooltips, dropdown menus, or hover states. Use ref from snapshot or CSS selector.

Inputs: tabId (required), ref, selector.

camofox_press_keyA

Press a keyboard key. Use after type_text to submit forms (Enter), navigate between elements (Tab), move through suggestions (ArrowDown/ArrowUp), or dismiss dialogs (Escape). Common keys: Enter, Tab, Escape, ArrowDown, ArrowUp, Backspace, Space.

Inputs: key (required), tabId (required).

camofox_query_selectorA

Query a CSS selector in the live DOM and return its element details or a specific attribute. Use this for targeted inspection without writing raw evaluate_js. Requires CAMOFOX_API_KEY only when browser-server authentication is enabled.

Inputs: tabId (required), selector (required), attribute.

camofox_scroll_elementA

Scroll a specific container element (modal dialog, scrollable div, sidebar). Use when page-level scroll doesn't reach content inside modals or overflow containers. Returns scroll position metadata to track progress.

Inputs: tabId (required), ref, deltaX, deltaY, +1 more.

camofox_scroll_element_and_snapshotA

Scroll a container element AND take a snapshot. Combines scroll_element + snapshot in one call. Perfect for incrementally loading lazy content in modals (e.g. Facebook group post comments). Returns both scroll position and page snapshot.

Inputs: tabId (required), ref, deltaY, waitMs, +1 more.

camofox_wait_forA

Wait for page to be fully ready (DOM loaded, network idle, framework hydration complete). Use after navigation or actions that trigger page changes.

Inputs: tabId (required), timeout, waitForNetwork.

camofox_wait_for_selectorA

Wait for a CSS selector to appear in the live DOM. Use for SPA hydration and async content when snapshot refs are incomplete or stale. Once found, prefer snapshot refs for interaction when available. Requires CAMOFOX_API_KEY only when browser-server authentication is enabled.

Inputs: tabId (required), selector (required), timeout.

camofox_wait_for_textA

Wait for specific text to appear on the page. Useful for waiting for search results, form submissions, or dynamic content loading.

Inputs: text (required), tabId (required), timeout.

clickA

Click an element. Provide either ref (from snapshot) or CSS selector. Use snapshot first to discover element refs.

Inputs: tabId (required), ref, selector.

close_tabA

Close a browser tab and release resources. Always close tabs when done to free memory.

Inputs: tabId (required).

create_tabA

Create a new browser tab with anti-detection fingerprinting. Each tab gets a unique fingerprint. Optionally provide a URL, userId, sessionKey, and viewport. To share the camofox CLI default browser profile/context, pass userId "cli-default" and sessionKey "default"; this creates a tracked MCP tab in that context but does not attach to a CLI tab that is already open.

Inputs: url, proxy, locale, preset, +7 more.

delete_downloadB

Delete a downloaded file from disk and registry

Inputs: downloadId (required), userId.

delete_profileB

Delete a saved browser profile from disk. Removes the profile's cookie data permanently.

Inputs: profileId (required).

extract_resourcesA

Extract resources (images, links, media, documents) from a specific DOM container. Use a CSS selector or element ref from snapshot to scope extraction to a particular section of the page. This is useful for extracting all images from a specific post, all links from a table, etc.

Inputs: tabId (required), ref, types, userId, +5 more.

extract_structuredB

Extract deterministic structured JSON from a page using the camofox-browser structured extraction schema.

Inputs: tabId (required), schema (required), userId.

fill_formA

Fill multiple form fields in one call. Provide an array of field entries, each with a ref or CSS selector and the text to type. Optionally specify a submit button to click after filling.

Inputs: tabId (required), fields (required), submit.

get_downloadA

Get a downloaded file. Images are always returned as viewable images. Recommended for AI agents: set includeContent=true to get non-image file content as base64 inline (max 256KB). Otherwise returns metadata only (including contentUrl).

Inputs: downloadId (required), userId, includeContent.

get_statsB

Get session statistics: request counts, active tabs, uptime, performance metrics.

Inputs: tabId (required).

go_backA

Navigate backward in browser history (Back button). Returns new page URL.

Inputs: tabId (required).

go_forwardA

Navigate forward in browser history (Forward button). Returns new page URL.

Inputs: tabId (required).

import_cookiesA

Import cookies for authenticated sessions. Provide cookies in a JSON string array. Restores login sessions without re-auth. Requires userId.

Inputs: userId (required), cookies (required), tabId.

list_downloadsA

List downloaded files with optional filtering by tab, status, extension, MIME type, and size range. Each download includes contentUrl for direct file retrieval.

Inputs: sort, limit, tabId, offset, +6 more.

list_presetsA

List all available geo presets supported by the CamoFox server. Presets include locale, timezone, and optional geolocation.

Inputs: no named parameters.

list_profilesA

List all saved browser profiles with metadata. Shows profile names, cookie counts, save dates, and descriptions.

Inputs: no named parameters.

list_tabsA

List all open browser tabs with URLs and titles. Use to discover available tabs or verify tab state.

Inputs: no named parameters.

load_profileA

Load a saved profile's cookies into an active browser tab. Restores login sessions without re-authentication. Use after create_tab to restore saved state.

Inputs: tabId (required), profileId (required).

refreshA

Reload the current page. Useful when page state is stale or after changes.

Inputs: tabId (required).

resolve_blobsA

Resolve blob: URLs to downloadable base64 data. Blob URLs are temporary browser objects (common in Telegram, WhatsApp, Discord) that cannot be downloaded directly. This tool converts them to base64 data URIs.

Inputs: urls (required), tabId (required), userId.

save_profileA

Save browser cookies from an active tab to a named profile on disk. Enables session persistence across restarts. Use after login to save authenticated state.

Inputs: tabId (required), profileId (required), description.

screenshotA

Take a viewport or full-page visual screenshot in base64 PNG. Set fullPage to capture the entire scrollable page. Use ONLY for visual verification (CSS, layout, proof). Prefer snapshot for most tasks — much more token-efficient.

Inputs: tabId (required), fullPage.

scrollB

Scroll page up or down by pixel amount. Use to reveal content below the fold or navigate long pages.

Inputs: tabId (required), direction (required), amount.

scroll_and_snapshotA

Scroll the page and take a snapshot. Useful for revealing content below the fold.

Inputs: tabId (required), direction (required), amount, waitMs.

server_statusA

Check CamoFox server health and browser connection. Call first to verify server is running. Returns version, browser status, and active tab count.

Inputs: no named parameters.

snapshotA

Get accessibility tree snapshot — the PRIMARY way to read page content. Returns element refs, roles, names and values. Token-efficient. Always prefer over screenshot. Refs come from the accessibility tree, so custom SPA elements may be missing; fall back to CSS selectors, camofox_wait_for_selector, or camofox_get_page_html when needed.

Inputs: tabId (required), offset.

toggle_displayA

Toggle browser display mode between headless and headed. When encountering CAPTCHAs or issues requiring visual interaction, switch to headed mode (headless: false) to show the browser window. After resolving, switch back to headless mode (headless: true). When switching an existing single context to virtual or headed mode, the response includes a vncUrl field — open this URL in a browser to see and interact with the browser GUI. Check tabsInvalidated in the response: when true, recreate tabs; when false, existing tracked tabs remain usable and the override applies to future contexts.

Inputs: userId (required), headless (required).

type_and_submitA

Type text into a field and press a key (default: Enter). Useful for search boxes and single-field forms.

Inputs: text (required), tabId (required), key, ref, +1 more.

type_textA

Type text into an input field. Provide either a ref (from snapshot) or a CSS selector. Use ref when available; otherwise use selector when snapshot doesn't assign refs (common with combobox/autocomplete inputs). Call snapshot first to find target element.

Inputs: text (required), tabId (required), ref, selector.

youtube_transcriptA

Extract transcript from a YouTube video. Returns timestamped text. No tab required.

Inputs: url (required), languages.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 47 tools

    Disambiguation3/5

    The core actions (navigate, click, type_text, snapshot) are clearly distinct, and descriptions actively steer choices (prefer snapshot over screenshot). However, the set is riddled with near-duplicate convenience wrappers — navigate vs navigate_and_snapshot, scroll vs camofox_scroll_element vs scroll_and_snapshot vs camofox_scroll_element_and_snapshot, click vs batch_click, type_text vs type_and_submit vs fill_form — and extraction tools (snapshot, get_page_html, query_selector, evaluate_js, extract_structured) require reading descriptions to separate. load_profile vs import_cookies also overlap in purpose.

    Naming Consistency3/5

    Everything is snake_case, which keeps it readable, and most names follow verb_noun (create_tab, list_downloads, delete_profile, batch_click). But an arbitrary subset is prefixed with camofox_ (camofox_hover, camofox_wait_for, camofox_evaluate_js, camofox_close_session) while their direct siblings (click, wait_for_text, snapshot) are not, and several are bare verbs/nouns (navigate, snapshot, refresh), so the pattern breaks within the same functional category.

    Tool Count2/5

    47 tools is excessive for a browser automation server, and much of the bloat comes from combined convenience variants that duplicate an existing primitive plus snapshot. Many tools earn their place (tabs, downloads, profiles, cookies, extraction), but the surface is heavy enough that an agent must triage before acting.

    Completeness4/5

    Coverage is broad: tab lifecycle, navigation/history, interaction, multiple extraction paths, downloads, blob resolution, profile and cookie persistence, geo presets, search macros, display mode, and stats. Minor gaps remain — no file upload, no explicit dropdown/select_option, and no cookie listing/clearing beyond import — but agents can work around these via JS evaluation.

    Maintenance

    ActivityMaintained
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • -
      license
      Not graded
      quality
      Not graded
      maintenance
      Undetectable browser automation server for MCP-compatible AI agents, offering 225 tools across 32 sections to navigate, extract, clone pages, and bypass antibot systems like Cloudflare.
      1
      -
    • A
      license
      A
      quality
      B
      maintenance
      MCP server for browser automation with anti-detection. Scout pages, find elements, interact with websites, and monitor network traffic from any AI client that supports the Model Context Protocol.
      21
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      A stealth browser automation MCP server that wraps CloakBrowser's patched Chromium to bypass bot detection, providing 22 tools for web navigation, interaction, and session management.
      24
      27 PyPI
      2
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      Browser automation MCP server using Camoufox anti-detect browser with fingerprint spoofing, geolocation/timezone spoofing, and human-like cursor movement.
      14
      1
      Apache 2.0