camofox-mcp
CamoFox MCP exposes a 47-tool anti-detection browser automation server for MCP clients, backed by a separately running camofox-browser server.
Check server health and browser connection; manage tabs (create, list, close) with fingerprints, sessions, proxies, locale/timezone/geolocation presets, and viewport overrides.
Navigate pages and history (navigate, back, forward, refresh) and wait for page readiness, text, or CSS selectors.
Interact with pages: click, type, fill multi-field forms, press keys, hover, scroll pages or containers, and batch clicks.
Observe and extract content: accessibility snapshots, screenshots, rendered HTML, CSS queries, links, resources, structured JSON, and JavaScript evaluation.
Search via browser macros such as Google, YouTube, Amazon, Reddit, Wikipedia, Twitter, LinkedIn, and others; extract YouTube transcripts.
Manage downloads: list, inspect/get, delete, batch-download resources, and resolve blob URLs.
Persist sessions: import cookies, save/load/list/delete profiles, close user sessions, and view session stats.
Toggle headless, headed, or virtual display mode and list available geo presets.
Use batch workflows that combine navigation/scroll/click/extraction with snapshots for efficient multi-step automation.
README documents optional custom search engine configuration via CAMOFOX_SEARCH_URL_TEMPLATE.
Provides a built-in search macro to search Amazon using anti-detection technology to avoid being blocked.
Provides a built-in search macro to search DuckDuckGo using anti-detection technology to avoid being blocked.
Provides a built-in search macro to search Facebook using anti-detection technology to avoid being blocked.
Utilizes a Firefox-based anti-detection browser engine to navigate, interact, and automate the web with unique, human-like fingerprints.
Provides a built-in search macro to search GitHub using anti-detection technology to avoid being blocked.
Provides a built-in search macro to search Google using anti-detection technology to avoid being blocked.
Provides a built-in search macro to search Instagram using anti-detection technology to avoid being blocked.
Provides a built-in search macro to search Reddit using anti-detection technology to avoid being blocked.
Provides a built-in search macro to search TikTok using anti-detection technology to avoid being blocked.
Provides a built-in search macro to search Wikipedia using anti-detection technology to avoid being blocked.
Provides a built-in search macro to search YouTube using anti-detection technology to avoid being blocked.
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:
camofox-browserhandles the anti-detection browser.camofox-mcpexposes that browser to your MCP client.
Option A: npx + stdio
Start the browser server:
npx camofox-browser@latestAdd 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:latestRun 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.jsConfigure 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/healthExpected 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 | |
Tabs | 3 | |
Navigation | 4 | |
Interaction | 8 | |
Observation | 8 | |
Search | 1 | |
Session | 4 | |
Profiles | 4 | |
Downloads | 3 | |
Extraction | 4 | |
Batch workflows | 6 | |
Presets | 1 | |
Network capture | 6 |
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-browserserver separately.MCP can share the camofox CLI default browser profile/context when
create_tabusesuserId: "cli-default"andsessionKey: "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 setCAMOFOX_VIEWPORT=1366x768/--viewport 1366x768for a default new-tab size. Supported defaults use width320..3840and height240..2160.On Windows x64,
camofox-browser2.4.7 supports the portable distribution inheadless=truemode. Headed and virtual-display modes remain unsupported on Windows;toggle_displaywill 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_KEYon both sides.For trusted private-network browser deployments using
CAMOFOX_AUTH_MODE=disabled, leaveCAMOFOX_API_KEYunset 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_KEYand 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 toolsbatch_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_linksA
Get all hyperlinks on page with URLs and text. Useful for navigation discovery and site mapping.
Inputs: tabId (required), scope, extension, downloadOnly.
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.
web_searchC
Search via the 14 macros supported by camofox-browser 2.4.7: google, youtube, amazon, reddit, reddit_subreddit, wikipedia, twitter, yelp, spotify, netflix, linkedin, instagram, tiktok, twitch. Also supports engine=custom via CAMOFOX_SEARCH_URL_TEMPLATE and ordinary browser navigation/network policy. Returns a snapshot of results.
Inputs: query (required), tabId (required), engine.
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
Scored across 47 tools
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.
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.
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.
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
Related MCP Connectors
Browser automation MCP for whole web tasks in a cloud browser: saved logins, bot checks, replays.
Web scraping MCP server — scrape, extract structured data, screenshot any site with anti-bot bypass.
Official Browserless MCP server: browser automation, scraping, screenshots and PDFs for AI agents.
Undetectable cloud browser sessions for AI agents and scrapers. Navigate, extract, click, captcha.
Related MCP Servers
- -licenseNot gradedqualityNot gradedmaintenanceUndetectable 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-
- AlicenseAqualityBmaintenanceMCP 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.211MIT
- AlicenseAqualityDmaintenanceA 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.2427 PyPI2MIT
- AlicenseBqualityDmaintenanceBrowser automation MCP server using Camoufox anti-detect browser with fingerprint spoofing, geolocation/timezone spoofing, and human-like cursor movement.141Apache 2.0