CloakBrowser MCP

Package (npm 1.13.0)

npx -y [email protected]

Or add to your MCP client config:

{
  "mcpServers": {
    "cloakbrowser-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "PLAYWRIGHT_MCP_BROWSER_ENGINE": "<YOUR_VALUE>",
        "PLAYWRIGHT_MCP_HEADLESS": "<YOUR_VALUE>",
        "PLAYWRIGHT_MCP_OUTPUT_DIR": "<YOUR_VALUE>",
        "PLAYWRIGHT_MCP_CODEGEN": "<YOUR_VALUE>",
        "PLAYWRIGHT_MCP_SNAPSHOT_BOXES": "<YOUR_VALUE>",
        "PLAYWRIGHT_MCP_TIMEOUT_SETTLE": "<YOUR_VALUE>",
        "PLAYWRIGHT_MCP_USER_DATA_DIR": "<YOUR_VALUE>",
        "CLOAK_PLAYWRIGHT_MCP_CONTEXT_OPTIONS": "<YOUR_VALUE>",
        "CLOAK_PLAYWRIGHT_MCP_EXTENSION_PATHS": "<YOUR_VALUE>",
        "CLOAK_PLAYWRIGHT_MCP_CONSOLE_FALLBACK": "<YOUR_VALUE>",
        "CLOAK_PLAYWRIGHT_MCP_GEOIP_PROXY_MATCH": "<YOUR_VALUE>",
        "CLOAK_PLAYWRIGHT_MCP_EXTRA_ARGS": "<YOUR_VALUE>"
      }
    }
  }
}

• PLAYWRIGHT_MCP_BROWSER_ENGINE — Bridge browser engine: cloak or playwright.
• PLAYWRIGHT_MCP_HEADLESS — Run the browser in headless mode.
• PLAYWRIGHT_MCP_OUTPUT_DIR — Directory where upstream Playwright MCP writes artifacts.
• PLAYWRIGHT_MCP_CODEGEN — Generate code in typescript, python, java, csharp, or none.
• PLAYWRIGHT_MCP_SNAPSHOT_BOXES — Include element bounding boxes in browser snapshots.
• PLAYWRIGHT_MCP_TIMEOUT_SETTLE — Milliseconds to wait after actions for triggered work to settle.
• PLAYWRIGHT_MCP_USER_DATA_DIR — Persistent Chromium profile directory. The bridge resolves it to an absolute path and writes it to generated Playwright MCP config.
• CLOAK_PLAYWRIGHT_MCP_CONTEXT_OPTIONS — JSON object with validated Playwright context options such as viewport, locale, timezoneId, permissions, geolocation, and headers.
• CLOAK_PLAYWRIGHT_MCP_EXTENSION_PATHS — JSON array or comma-separated list of Chrome extension directories. Requires PLAYWRIGHT_MCP_USER_DATA_DIR.
• CLOAK_PLAYWRIGHT_MCP_CONSOLE_FALLBACK — Patch upstream console message collection for CloakBrowser compatibility.
• CLOAK_PLAYWRIGHT_MCP_GEOIP_PROXY_MATCH — Resolve proxy GeoIP and match CloakBrowser timezone/locale fingerprint flags when PLAYWRIGHT_MCP_PROXY_SERVER is set.
• CLOAK_PLAYWRIGHT_MCP_EXTRA_ARGS — Comma-separated or JSON array of extra Chromium launch arguments.

Package (npm 1.13.0)

Package: npm cloakbrowser-mcp

• CLOAK_PLAYWRIGHT_MCP_HTTP_HOST — Streamable HTTP bind host.
• CLOAK_PLAYWRIGHT_MCP_HTTP_PORT — Streamable HTTP bind port.
• CLOAK_PLAYWRIGHT_MCP_HTTP_ENDPOINT — Streamable HTTP endpoint path.
• CLOAK_PLAYWRIGHT_MCP_HTTP_AUTH_TOKEN secret — Optional Streamable HTTP Bearer token.
• CLOAK_PLAYWRIGHT_MCP_HTTP_SESSION_BACKEND — Session metadata backend. Only memory is implemented in this release.
• CLOAK_PLAYWRIGHT_MCP_HTTP_SESSION_IDLE_TTL_MS — Idle TTL for Streamable HTTP sessions.
• CLOAK_PLAYWRIGHT_MCP_HTTP_SESSION_MAX — Maximum active Streamable HTTP sessions in one process.
• PLAYWRIGHT_MCP_BROWSER_ENGINE — Bridge browser engine: cloak or playwright.
• PLAYWRIGHT_MCP_HEADLESS — Run the browser in headless mode.
• PLAYWRIGHT_MCP_OUTPUT_DIR — Directory where upstream Playwright MCP writes artifacts.
• PLAYWRIGHT_MCP_CODEGEN — Generate code in typescript, python, java, csharp, or none.
• PLAYWRIGHT_MCP_SNAPSHOT_BOXES — Include element bounding boxes in browser snapshots.
• PLAYWRIGHT_MCP_TIMEOUT_SETTLE — Milliseconds to wait after actions for triggered work to settle.
• PLAYWRIGHT_MCP_USER_DATA_DIR — Persistent Chromium profile directory. The bridge resolves it to an absolute path and writes it to generated Playwright MCP config.
• CLOAK_PLAYWRIGHT_MCP_CONTEXT_OPTIONS — JSON object with validated Playwright context options such as viewport, locale, timezoneId, permissions, geolocation, and headers.
• CLOAK_PLAYWRIGHT_MCP_EXTENSION_PATHS — JSON array or comma-separated list of Chrome extension directories. Requires PLAYWRIGHT_MCP_USER_DATA_DIR.
• CLOAK_PLAYWRIGHT_MCP_CONSOLE_FALLBACK — Patch upstream console message collection for CloakBrowser compatibility.
• CLOAK_PLAYWRIGHT_MCP_GEOIP_PROXY_MATCH — Resolve proxy GeoIP and match CloakBrowser timezone/locale fingerprint flags when PLAYWRIGHT_MCP_PROXY_SERVER is set.
• CLOAK_PLAYWRIGHT_MCP_EXTRA_ARGS — Comma-separated or JSON array of extra Chromium launch arguments.

This server takes extra arguments — see its repository.

Package (oci)

docker run -i --rm ghcr.io/swimmwatch/cloakbrowser-mcp:1.13.0

Or add to your MCP client config:

{
  "mcpServers": {
    "cloakbrowser-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/swimmwatch/cloakbrowser-mcp:1.13.0"
      ],
      "env": {
        "PLAYWRIGHT_MCP_BROWSER_ENGINE": "<YOUR_VALUE>",
        "PLAYWRIGHT_MCP_HEADLESS": "<YOUR_VALUE>",
        "PLAYWRIGHT_MCP_OUTPUT_DIR": "<YOUR_VALUE>",
        "PLAYWRIGHT_MCP_CODEGEN": "<YOUR_VALUE>",
        "PLAYWRIGHT_MCP_SNAPSHOT_BOXES": "<YOUR_VALUE>",
        "PLAYWRIGHT_MCP_TIMEOUT_SETTLE": "<YOUR_VALUE>",
        "PLAYWRIGHT_MCP_USER_DATA_DIR": "<YOUR_VALUE>",
        "CLOAK_PLAYWRIGHT_MCP_CONTEXT_OPTIONS": "<YOUR_VALUE>",
        "CLOAK_PLAYWRIGHT_MCP_EXTENSION_PATHS": "<YOUR_VALUE>",
        "CLOAK_PLAYWRIGHT_MCP_CONSOLE_FALLBACK": "<YOUR_VALUE>",
        "CLOAK_PLAYWRIGHT_MCP_GEOIP_PROXY_MATCH": "<YOUR_VALUE>",
        "CLOAK_PLAYWRIGHT_MCP_EXTRA_ARGS": "<YOUR_VALUE>"
      }
    }
  }
}

• PLAYWRIGHT_MCP_BROWSER_ENGINE — Bridge browser engine: cloak or playwright.
• PLAYWRIGHT_MCP_HEADLESS — Run the browser in headless mode.
• PLAYWRIGHT_MCP_OUTPUT_DIR — Directory inside the container where upstream Playwright MCP writes artifacts.
• PLAYWRIGHT_MCP_CODEGEN — Generate code in typescript, python, java, csharp, or none.
• PLAYWRIGHT_MCP_SNAPSHOT_BOXES — Include element bounding boxes in browser snapshots.
• PLAYWRIGHT_MCP_TIMEOUT_SETTLE — Milliseconds to wait after actions for triggered work to settle.
• PLAYWRIGHT_MCP_USER_DATA_DIR — Persistent Chromium profile directory inside the container. Use /data/profiles/... with the existing /data volume.
• CLOAK_PLAYWRIGHT_MCP_CONTEXT_OPTIONS — JSON object with validated Playwright context options such as viewport, locale, timezoneId, permissions, geolocation, and headers.
• CLOAK_PLAYWRIGHT_MCP_EXTENSION_PATHS — JSON array or comma-separated list of Chrome extension directories inside the container. Requires PLAYWRIGHT_MCP_USER_DATA_DIR.
• CLOAK_PLAYWRIGHT_MCP_CONSOLE_FALLBACK — Patch upstream console message collection for CloakBrowser compatibility.
• CLOAK_PLAYWRIGHT_MCP_GEOIP_PROXY_MATCH — Resolve proxy GeoIP and match CloakBrowser timezone/locale fingerprint flags when PLAYWRIGHT_MCP_PROXY_SERVER is set.
• CLOAK_PLAYWRIGHT_MCP_EXTRA_ARGS — Comma-separated or JSON array of extra Chromium launch arguments.

Package (oci)

docker run -i --rm docker.io/swimmwatch/cloakbrowser-mcp:1.13.0

Or add to your MCP client config:

{
  "mcpServers": {
    "cloakbrowser-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/swimmwatch/cloakbrowser-mcp:1.13.0"
      ],
      "env": {
        "PLAYWRIGHT_MCP_BROWSER_ENGINE": "<YOUR_VALUE>",
        "PLAYWRIGHT_MCP_HEADLESS": "<YOUR_VALUE>",
        "PLAYWRIGHT_MCP_OUTPUT_DIR": "<YOUR_VALUE>",
        "PLAYWRIGHT_MCP_CODEGEN": "<YOUR_VALUE>",
        "PLAYWRIGHT_MCP_SNAPSHOT_BOXES": "<YOUR_VALUE>",
        "PLAYWRIGHT_MCP_TIMEOUT_SETTLE": "<YOUR_VALUE>",
        "PLAYWRIGHT_MCP_USER_DATA_DIR": "<YOUR_VALUE>",
        "CLOAK_PLAYWRIGHT_MCP_CONTEXT_OPTIONS": "<YOUR_VALUE>",
        "CLOAK_PLAYWRIGHT_MCP_EXTENSION_PATHS": "<YOUR_VALUE>",
        "CLOAK_PLAYWRIGHT_MCP_CONSOLE_FALLBACK": "<YOUR_VALUE>",
        "CLOAK_PLAYWRIGHT_MCP_GEOIP_PROXY_MATCH": "<YOUR_VALUE>",
        "CLOAK_PLAYWRIGHT_MCP_EXTRA_ARGS": "<YOUR_VALUE>"
      }
    }
  }
}

• PLAYWRIGHT_MCP_BROWSER_ENGINE — Bridge browser engine: cloak or playwright.
• PLAYWRIGHT_MCP_HEADLESS — Run the browser in headless mode.
• PLAYWRIGHT_MCP_OUTPUT_DIR — Directory inside the container where upstream Playwright MCP writes artifacts.
• PLAYWRIGHT_MCP_CODEGEN — Generate code in typescript, python, java, csharp, or none.
• PLAYWRIGHT_MCP_SNAPSHOT_BOXES — Include element bounding boxes in browser snapshots.
• PLAYWRIGHT_MCP_TIMEOUT_SETTLE — Milliseconds to wait after actions for triggered work to settle.
• PLAYWRIGHT_MCP_USER_DATA_DIR — Persistent Chromium profile directory inside the container. Use /data/profiles/... with the existing /data volume.
• CLOAK_PLAYWRIGHT_MCP_CONTEXT_OPTIONS — JSON object with validated Playwright context options such as viewport, locale, timezoneId, permissions, geolocation, and headers.
• CLOAK_PLAYWRIGHT_MCP_EXTENSION_PATHS — JSON array or comma-separated list of Chrome extension directories inside the container. Requires PLAYWRIGHT_MCP_USER_DATA_DIR.
• CLOAK_PLAYWRIGHT_MCP_CONSOLE_FALLBACK — Patch upstream console message collection for CloakBrowser compatibility.
• CLOAK_PLAYWRIGHT_MCP_GEOIP_PROXY_MATCH — Resolve proxy GeoIP and match CloakBrowser timezone/locale fingerprint flags when PLAYWRIGHT_MCP_PROXY_SERVER is set.
• CLOAK_PLAYWRIGHT_MCP_EXTRA_ARGS — Comma-separated or JSON array of extra Chromium launch arguments.