Skip to content
MCP server

CloakBrowser MCP

Playwright MCP-compatible browser automation running on CloakBrowser Chromium

Install
Pricing
Open source
Platforms
CLI, Linux, macOS
Runs
Locally or Remotely
Version
1.15.1
Listing updated
1 day ago

About CloakBrowser MCP

CloakBrowser MCP is an open-source MCP server for browser automation. It can run locally on your machine or as a hosted remote server.

This bridge starts the upstream Playwright MCP as a child process and forwards its browser tool calls unchanged, but points it at CloakBrowser's Chromium build. The only tools it adds are two local introspection tools, cloakbrowser_binary_info and cloakbrowser_bridge_info. Versions are mapped to specific upstream Playwright MCP and CloakBrowser releases in a published compatibility table.

Extras aimed at deployment include persistent browser profiles, validated Playwright context options, Chrome extension loading, opt-in managed CDP access, and GeoIP-aware proxy matching that aligns timezone and locale flags with a configured proxy for regional QA. A humanized input layer routes mouse, keyboard and scroll actions through CloakBrowser for interaction-sensitive flows. Because those features target browser fingerprinting and bot detection, it is worth reviewing for site terms compliance.

It installs with npx or Docker, runs over stdio or Streamable HTTP, and needs Node.js 22.13 or later. A doctor command checks the setup.

Install

Run in a terminal

claude mcp add cloakbrowser-mcp -- npx -y cloakbrowser-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "cloakbrowser-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "cloakbrowser-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "cloakbrowser-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "cloakbrowser-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "cloakbrowser-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "cloakbrowser-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • PLAYWRIGHT_MCP_BROWSER_ENGINEBridge browser engine: cloak or playwright.
  • PLAYWRIGHT_MCP_HEADLESSRun the browser in headless mode.
  • PLAYWRIGHT_MCP_OUTPUT_DIRDirectory where upstream Playwright MCP writes artifacts.
  • PLAYWRIGHT_MCP_CODEGENGenerate code in typescript, python, java, csharp, or none.
  • PLAYWRIGHT_MCP_SNAPSHOT_BOXESInclude element bounding boxes in browser snapshots.
  • PLAYWRIGHT_MCP_TIMEOUT_SETTLEMilliseconds to wait after actions for triggered work to settle.
  • PLAYWRIGHT_MCP_USER_DATA_DIRPersistent Chromium profile directory. The bridge resolves it to an absolute path and writes it to generated Playwright MCP config.
  • CLOAK_PLAYWRIGHT_MCP_CONTEXT_OPTIONSJSON object with validated Playwright context options such as viewport, locale, timezoneId, permissions, geolocation, and headers.
  • CLOAK_PLAYWRIGHT_MCP_EXTENSION_PATHSJSON array or comma-separated list of Chrome extension directories. Requires PLAYWRIGHT_MCP_USER_DATA_DIR.
  • CLOAK_PLAYWRIGHT_MCP_CONSOLE_FALLBACKPatch upstream console message collection for CloakBrowser compatibility.
  • CLOAK_PLAYWRIGHT_MCP_GEOIP_PROXY_MATCHResolve proxy GeoIP and match CloakBrowser timezone/locale fingerprint flags when PLAYWRIGHT_MCP_PROXY_SERVER is set.
  • CLOAK_PLAYWRIGHT_MCP_EXTRA_ARGSComma-separated or JSON array of extra Chromium launch arguments.
  • CLOAK_PLAYWRIGHT_MCP_HTTP_HOSTStreamable HTTP bind host.
  • CLOAK_PLAYWRIGHT_MCP_HTTP_PORTStreamable HTTP bind port.
  • CLOAK_PLAYWRIGHT_MCP_HTTP_ENDPOINTStreamable HTTP endpoint path.
  • CLOAK_PLAYWRIGHT_MCP_HTTP_AUTH_TOKENOptional Streamable HTTP Bearer token.
  • CLOAK_PLAYWRIGHT_MCP_HTTP_SESSION_BACKENDSession metadata backend. Only memory is implemented in this release.
  • CLOAK_PLAYWRIGHT_MCP_HTTP_SESSION_IDLE_TTL_MSIdle TTL for Streamable HTTP sessions.
  • CLOAK_PLAYWRIGHT_MCP_HTTP_SESSION_MAXMaximum active Streamable HTTP sessions in one process.
  • PLAYWRIGHT_MCP_BROWSER_ENGINEBridge browser engine: cloak or playwright.
  • PLAYWRIGHT_MCP_HEADLESSRun the browser in headless mode.
  • PLAYWRIGHT_MCP_OUTPUT_DIRDirectory where upstream Playwright MCP writes artifacts.
  • PLAYWRIGHT_MCP_CODEGENGenerate code in typescript, python, java, csharp, or none.
  • PLAYWRIGHT_MCP_SNAPSHOT_BOXESInclude element bounding boxes in browser snapshots.
  • PLAYWRIGHT_MCP_TIMEOUT_SETTLEMilliseconds to wait after actions for triggered work to settle.
  • PLAYWRIGHT_MCP_USER_DATA_DIRPersistent Chromium profile directory. The bridge resolves it to an absolute path and writes it to generated Playwright MCP config.
  • CLOAK_PLAYWRIGHT_MCP_CONTEXT_OPTIONSJSON object with validated Playwright context options such as viewport, locale, timezoneId, permissions, geolocation, and headers.
  • CLOAK_PLAYWRIGHT_MCP_EXTENSION_PATHSJSON array or comma-separated list of Chrome extension directories. Requires PLAYWRIGHT_MCP_USER_DATA_DIR.
  • CLOAK_PLAYWRIGHT_MCP_CONSOLE_FALLBACKPatch upstream console message collection for CloakBrowser compatibility.
  • CLOAK_PLAYWRIGHT_MCP_GEOIP_PROXY_MATCHResolve proxy GeoIP and match CloakBrowser timezone/locale fingerprint flags when PLAYWRIGHT_MCP_PROXY_SERVER is set.
  • CLOAK_PLAYWRIGHT_MCP_EXTRA_ARGSComma-separated or JSON array of extra Chromium launch arguments.
  • PLAYWRIGHT_MCP_BROWSER_ENGINEBridge browser engine: cloak or playwright.
  • PLAYWRIGHT_MCP_HEADLESSRun the browser in headless mode.
  • PLAYWRIGHT_MCP_OUTPUT_DIRDirectory inside the container where upstream Playwright MCP writes artifacts.
  • PLAYWRIGHT_MCP_CODEGENGenerate code in typescript, python, java, csharp, or none.
  • PLAYWRIGHT_MCP_SNAPSHOT_BOXESInclude element bounding boxes in browser snapshots.
  • PLAYWRIGHT_MCP_TIMEOUT_SETTLEMilliseconds to wait after actions for triggered work to settle.
  • PLAYWRIGHT_MCP_USER_DATA_DIRPersistent Chromium profile directory inside the container. Use /data/profiles/... with the existing /data volume.
  • CLOAK_PLAYWRIGHT_MCP_CONTEXT_OPTIONSJSON object with validated Playwright context options such as viewport, locale, timezoneId, permissions, geolocation, and headers.
  • CLOAK_PLAYWRIGHT_MCP_EXTENSION_PATHSJSON array or comma-separated list of Chrome extension directories inside the container. Requires PLAYWRIGHT_MCP_USER_DATA_DIR.
  • CLOAK_PLAYWRIGHT_MCP_CONSOLE_FALLBACKPatch upstream console message collection for CloakBrowser compatibility.
  • CLOAK_PLAYWRIGHT_MCP_GEOIP_PROXY_MATCHResolve proxy GeoIP and match CloakBrowser timezone/locale fingerprint flags when PLAYWRIGHT_MCP_PROXY_SERVER is set.
  • CLOAK_PLAYWRIGHT_MCP_EXTRA_ARGSComma-separated or JSON array of extra Chromium launch arguments.
  • PLAYWRIGHT_MCP_BROWSER_ENGINEBridge browser engine: cloak or playwright.
  • PLAYWRIGHT_MCP_HEADLESSRun the browser in headless mode.
  • PLAYWRIGHT_MCP_OUTPUT_DIRDirectory inside the container where upstream Playwright MCP writes artifacts.
  • PLAYWRIGHT_MCP_CODEGENGenerate code in typescript, python, java, csharp, or none.
  • PLAYWRIGHT_MCP_SNAPSHOT_BOXESInclude element bounding boxes in browser snapshots.
  • PLAYWRIGHT_MCP_TIMEOUT_SETTLEMilliseconds to wait after actions for triggered work to settle.
  • PLAYWRIGHT_MCP_USER_DATA_DIRPersistent Chromium profile directory inside the container. Use /data/profiles/... with the existing /data volume.
  • CLOAK_PLAYWRIGHT_MCP_CONTEXT_OPTIONSJSON object with validated Playwright context options such as viewport, locale, timezoneId, permissions, geolocation, and headers.
  • CLOAK_PLAYWRIGHT_MCP_EXTENSION_PATHSJSON array or comma-separated list of Chrome extension directories inside the container. Requires PLAYWRIGHT_MCP_USER_DATA_DIR.
  • CLOAK_PLAYWRIGHT_MCP_CONSOLE_FALLBACKPatch upstream console message collection for CloakBrowser compatibility.
  • CLOAK_PLAYWRIGHT_MCP_GEOIP_PROXY_MATCHResolve proxy GeoIP and match CloakBrowser timezone/locale fingerprint flags when PLAYWRIGHT_MCP_PROXY_SERVER is set.
  • CLOAK_PLAYWRIGHT_MCP_EXTRA_ARGSComma-separated or JSON array of extra Chromium launch arguments.

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

cloakbrowser_binary_info
Reports information about the CloakBrowser binary
cloakbrowser_bridge_info
Reports information about the bridge

What it does

Upstream parity
Playwright MCP tools are forwarded unchanged.
Persistent profiles
Keep login state with a user data directory.
Extension loading
Load Chrome extensions into the profile.
GeoIP proxy matching
Match timezone and locale to a proxy location.
Humanized input
Human-like mouse, keyboard and scroll behavior.
npm and Docker
Run over stdio or Streamable HTTP.

Good for

  • Run web research or testing with persistent logins
  • Check regional page variants behind a proxy
  • Test flows with a Chrome extension loaded
  • Host a browser automation endpoint in Docker

Pricing

Open source

Open source, MIT-style license badge on the repository

Prices change. Check swimmwatch.github.io before you buy.

CloakBrowser MCP FAQ

Does it change the Playwright tools?

No, upstream tools are unchanged and two introspection tools are added.

What does it need?

Node.js 22.13 or later in the 22 line, or Node 24 and above.

Which transports?

stdio and Streamable HTTP.

How do I check my setup?

Run npx cloakbrowser-mcp@latest doctor.

Is CloakBrowser MCP free?

Yes. CloakBrowser MCP is open source, so you can use and self-host it for free.

How do I add CloakBrowser MCP to Claude Code?

Run this command in your terminal: claude mcp add cloakbrowser-mcp -- npx -y cloakbrowser-mcp

What are the best alternatives to CloakBrowser MCP?

The closest alternatives to CloakBrowser MCP are Browser Use, Scrapling MCP Server, Oya Browser, Mantis and Auto-building agents.

Alternatives to CloakBrowser MCP

  1. Browser Use

    MCP server

    Browser agents and cloud browsers for AI, with an MCP server for web tasks

    • 7 tools
    • Remote
    • Freemium
    • 121K GitHub stars
    • Browser automation
  2. MCP server for AI clients to scrape sites with HTTP and stealth browser sessions

    Runs locally
    • 17 tools
    • Open source
    • 104K GitHub stars
    • Web search and scraping
  3. Oya Browser

    MCP server

    HIPAA-oriented agentic browser with replayable playbooks, reachable over MCP

    • 32 tools
    • Remote
    • Freemium
    • 349 GitHub stars
    • Browser automation
  4. Mantis

    MCP server

    Browser MCP server that gives agents numbered text pages instead of screenshots

    Runs locally
    • 1 tool
    • Open source
    • 5 Hacker News points
    • Browser automation
  5. Build and continue browser and Mac automation scripts for Super through Claude

    • Remote
    • Paid
    • Browser automation
  6. pour

    MCP server

    Run WCAG 2.2 accessibility audits and vision simulations on any URL from an agent

    Runs locally
    • Open source
    • Developer tools