Camoufox

Camoufox MCP provides a dedicated server wrapper for automating browser tasks with the anti-detection Camoufox Firefox-based browser. It enables you to run browser automation in a controlled MCP environment, with built-in anti-detection features and configurable proxy support to help you operate in varied network conditions.

How to use

You use an MCP client to connect to the Camoufox MCP server. Start the server wrapper locally, then point your MCP client to the Camoufox endpoint or launch it as a local process through your MCP client workflow. The server exposes automation capabilities powered by Camoufox, including realistic cursor movements, human-like interaction delays, and proxy-enabled operation. You can run tasks that interact with web pages, manage cookies, intercept network activity, and capture console output while leveraging anti-detection features.

How to install

Prerequisites you need before installing:

• Node.js (16.x or later) and npm or npx installed on your machine.

Step-by-step install and run flow:

1. Install Camoufox MCP by running the MCP launcher command:

npx camoufox-mcp

Additional configuration and startup notes

If you want to route traffic through a proxy, configure the MCP server with proxy details and, optionally, environment variables for proxy authentication. You can provide proxy settings via the MCP server configuration and the client’s environment, enabling GeoIP-based adjustments and authenticated proxies.

Example configurations you can apply in your environment to enable proxy support and startup parameters are shown below.

Configuration examples

{
  "mcpServers": {
    "camoufox": {
      "command": "npx",
      "args": ["camoufox-mcp"]
    }
  }
}

{
  "mcpServers": {
    "camoufox": {
      "command": "npx",
      "args": ["camoufox-mcp"],
      "env": {
        "PROXY_SERVER": "http://1.2.3.4:8080",
        "PROXY_USER": "username",
        "PROXY_PASS": "password"
      }
    }
  }
}

// Client-side settings example (proxy configuration)
{
  "proxy": {
    "enabled": true,
    "server": "${PROXY_SERVER}",
    "username": "${PROXY_USER}",
    "password": "${PROXY_PASS}",
    "geoip": true
  }
}

Notes on settings and proxy behavior

You can keep the browser visible for debugging by setting the browser to headful mode and adjusting the viewport and timeouts in the settings. Proxy settings may enable GeoIP-based timezone and locale adjustments to better match the proxy location.

Security and best practices

Use authenticated proxies only when required and ensure your environment securely stores credentials. Regularly review network interception and console capture settings to balance visibility with privacy and compliance.

Troubleshooting tips

If the server fails to start, verify Node.js installation, ensure the MCP launcher command is accessible, and confirm proxy environment variables are correctly set. Check that the configured proxy server is reachable and that authentication credentials are valid.

Available tools

Bot detection bypass

Built-in capabilities to bypass common bot detection techniques to allow automated interactions to proceed without triggering deterrents.

Fingerprint randomization

Randomizes browser fingerprint characteristics to reduce traceability across runs.

WebRTC leak protection

Prevents WebRTC-related IP leakage that could reveal automated activity.

Canvas fingerprint spoofing

Spoofs canvas fingerprint to reduce unique fingerprint visibility.

Humanized cursor movement

Generates realistic cursor paths rather than instantaneous movements.

Click with human-like delays

Introduces delays between click events to mimic human behavior.

Proxy with GeoIP auto-config

Automatically configures proxy-based geography and timezone settings to align with the proxy location.

MainWorld eval

Supports evaluating code in the main document context, including special data structures like __NUXT__ and __NEXT_DATA__.

Isolated eval (async/await)

Allows isolated code evaluation in an asynchronous context to keep executions separate.

Cookie popup auto-dismiss

Automatically dismisses common cookie consent popups using multiple selectors.

User action recording

Captures user-like actions for reproducibility and scripting.

Network interception

Intercepts network requests for monitoring and manipulation.

Console capture

Captures console output for debugging and analysis.