CloakBrowser MCP

io.github.swimmwatch/cloakbrowser-mcp·v1.8.0·Browser Automation

Playwright MCP-compatible browser automation bridge for CloakBrowser Chromium.

In-path gate · all MCP tools

Using CloakBrowser MCP in Claude, Cursor, Gemini CLI, Cline, or Zed?

MCP tool contracts can change remotely with no version bump. The mcpindex gate pins each contract and HOLDs the call when it drifts—before your agent acts. Zero credentials. This is not the package install for this server itself (use Install this server for that).

Install the mcpindex gate (one command)

Rewrites your MCP host config so each server launches behind the gate. Inspect first: curl -fsSL https://mcpindex.ai/install.sh | less

curl -fsSL https://mcpindex.ai/install.sh | sh

Auditable install path →Watch it hold a drift →

Trust verdict · v1 advisory · method

REVIEWstatus: PARTIALfresh until 2026-08-02 19:02 UTC

screened 2026-07-03tier: scannedgranularity: description-levelsource: registry

Semantic screen found no manipulation pattern in the description. Conformance probe not yet run.

mcpindex.integrity.descriptionpassINFO

evidence“No malicious instructions found”via static_description

Limits of this verdict

- Semantic screen only - the deterministic conformance probe has not run on this server
- Confidence is reported but not yet calibrated (v1)
- Screen reads the tool description, not the live behavior
- advisory
- registry description only no input schema
- screen model 8b

Semantic screen: an LLM judge reads the tool description for hidden instructions (status PARTIAL). A pass means the description is not lying, not that the tool is safe: a high-capability tool with an honest description still warrants caution. The deterministic conformance probe has not been run on this server yet, so the screen here is semantic-only. Posture: advisory. Confidences are reported but not yet calibrated (calibrated=false at v1). Full verdict history is not shown on this page.

Own this server? Screen its description →

Embed this badge

A live verdict badge for your README or listing. It reflects the current screen, links back here, and updates when the verdict does.

Markdown

[![mcpindex](https://mcpindex.ai/api/v1/badge/io-github-swimmwatch-cloakbrowser-mcp)](https://mcpindex.ai/server/io-github-swimmwatch-cloakbrowser-mcp)

HTML

<a href="https://mcpindex.ai/server/io-github-swimmwatch-cloakbrowser-mcp"><img src="https://mcpindex.ai/api/v1/badge/io-github-swimmwatch-cloakbrowser-mcp" alt="mcpindex verdict" height="20" /></a>

Environment variables

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_OUTPUT_MODE

Return snapshots, console logs, and network logs through stdout or files.

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.

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_OUTPUT_MODE

Return snapshots, console logs, and network logs through stdout or files.

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.

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_OUTPUT_MODE

Return snapshots, console logs, and network logs through stdout or files.

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.

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_OUTPUT_MODE

Return snapshots, console logs, and network logs through stdout or files.

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.

MCP quality score · maturity, not trust · methodology

freshness

completeness

installability

documentation

stability

Alternatives in Browser Automation

ai.foura/mcp

Web scraping for AI agents: fetch any page via proxy or full browser, past anti-bot defenses.

ai.openhelm/openhelm

Autonomous cloud agent tasks: real browser + your tools, structured evidence-backed results.

ai.smithery/ImRonAI-mcp-server-browserbase

Automate cloud browsers to navigate websites, interact with elements, and extract structured data.…

Install this server

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "cloakbrowser-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "cloakbrowser-mcp"
      ],
      "env": {
        "PLAYWRIGHT_MCP_BROWSER_ENGINE": "cloak",
        "PLAYWRIGHT_MCP_HEADLESS": "true",
        "PLAYWRIGHT_MCP_OUTPUT_DIR": "/data",
        "PLAYWRIGHT_MCP_OUTPUT_MODE": "stdout",
        "PLAYWRIGHT_MCP_USER_DATA_DIR": "<playwright_mcp_user_data_dir>",
        "CLOAK_PLAYWRIGHT_MCP_CONTEXT_OPTIONS": "<cloak_playwright_mcp_context_options>",
        "CLOAK_PLAYWRIGHT_MCP_EXTENSION_PATHS": "<cloak_playwright_mcp_extension_paths>",
        "CLOAK_PLAYWRIGHT_MCP_CONSOLE_FALLBACK": "true",
        "CLOAK_PLAYWRIGHT_MCP_GEOIP_PROXY_MATCH": "false",
        "CLOAK_PLAYWRIGHT_MCP_EXTRA_ARGS": "<cloak_playwright_mcp_extra_args>",
        "CLOAK_PLAYWRIGHT_MCP_HTTP_HOST": "127.0.0.1",
        "CLOAK_PLAYWRIGHT_MCP_HTTP_PORT": "3000",
        "CLOAK_PLAYWRIGHT_MCP_HTTP_ENDPOINT": "/mcp",
        "CLOAK_PLAYWRIGHT_MCP_HTTP_AUTH_TOKEN": "<your-cloak_playwright_mcp_http_auth_token>",
        "CLOAK_PLAYWRIGHT_MCP_HTTP_SESSION_BACKEND": "memory",
        "CLOAK_PLAYWRIGHT_MCP_HTTP_SESSION_IDLE_TTL_MS": "3600000",
        "CLOAK_PLAYWRIGHT_MCP_HTTP_SESSION_MAX": "32"
      }
    }
  }
}

Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "cloakbrowser-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "cloakbrowser-mcp"
      ],
      "env": {
        "PLAYWRIGHT_MCP_BROWSER_ENGINE": "cloak",
        "PLAYWRIGHT_MCP_HEADLESS": "true",
        "PLAYWRIGHT_MCP_OUTPUT_DIR": "/data",
        "PLAYWRIGHT_MCP_OUTPUT_MODE": "stdout",
        "PLAYWRIGHT_MCP_USER_DATA_DIR": "<playwright_mcp_user_data_dir>",
        "CLOAK_PLAYWRIGHT_MCP_CONTEXT_OPTIONS": "<cloak_playwright_mcp_context_options>",
        "CLOAK_PLAYWRIGHT_MCP_EXTENSION_PATHS": "<cloak_playwright_mcp_extension_paths>",
        "CLOAK_PLAYWRIGHT_MCP_CONSOLE_FALLBACK": "true",
        "CLOAK_PLAYWRIGHT_MCP_GEOIP_PROXY_MATCH": "false",
        "CLOAK_PLAYWRIGHT_MCP_EXTRA_ARGS": "<cloak_playwright_mcp_extra_args>",
        "CLOAK_PLAYWRIGHT_MCP_HTTP_HOST": "127.0.0.1",
        "CLOAK_PLAYWRIGHT_MCP_HTTP_PORT": "3000",
        "CLOAK_PLAYWRIGHT_MCP_HTTP_ENDPOINT": "/mcp",
        "CLOAK_PLAYWRIGHT_MCP_HTTP_AUTH_TOKEN": "<your-cloak_playwright_mcp_http_auth_token>",
        "CLOAK_PLAYWRIGHT_MCP_HTTP_SESSION_BACKEND": "memory",
        "CLOAK_PLAYWRIGHT_MCP_HTTP_SESSION_IDLE_TTL_MS": "3600000",
        "CLOAK_PLAYWRIGHT_MCP_HTTP_SESSION_MAX": "32"
      }
    }
  }
}

Cline (cline_mcp_settings.json)

npx -y cloakbrowser-mcp

Claude Code (claude mcp add)

claude mcp add --scope user cloakbrowser-mcp -- npx -y cloakbrowser-mcp

Gemini CLI (gemini mcp add)

gemini mcp add -s user cloakbrowser-mcp npx -y cloakbrowser-mcp

Claude Desktop (Docker)

{
  "mcpServers": {
    "cloakbrowser-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "ghcr.io/swimmwatch/cloakbrowser-mcp:1.8.0"
      ],
      "env": {
        "PLAYWRIGHT_MCP_BROWSER_ENGINE": "cloak",
        "PLAYWRIGHT_MCP_HEADLESS": "true",
        "PLAYWRIGHT_MCP_OUTPUT_DIR": "/data",
        "PLAYWRIGHT_MCP_OUTPUT_MODE": "stdout",
        "PLAYWRIGHT_MCP_USER_DATA_DIR": "<playwright_mcp_user_data_dir>",
        "CLOAK_PLAYWRIGHT_MCP_CONTEXT_OPTIONS": "<cloak_playwright_mcp_context_options>",
        "CLOAK_PLAYWRIGHT_MCP_EXTENSION_PATHS": "<cloak_playwright_mcp_extension_paths>",
        "CLOAK_PLAYWRIGHT_MCP_CONSOLE_FALLBACK": "true",
        "CLOAK_PLAYWRIGHT_MCP_GEOIP_PROXY_MATCH": "false",
        "CLOAK_PLAYWRIGHT_MCP_EXTRA_ARGS": "<cloak_playwright_mcp_extra_args>",
        "CLOAK_PLAYWRIGHT_MCP_HTTP_HOST": "127.0.0.1",
        "CLOAK_PLAYWRIGHT_MCP_HTTP_PORT": "3000",
        "CLOAK_PLAYWRIGHT_MCP_HTTP_ENDPOINT": "/mcp",
        "CLOAK_PLAYWRIGHT_MCP_HTTP_AUTH_TOKEN": "<your-cloak_playwright_mcp_http_auth_token>",
        "CLOAK_PLAYWRIGHT_MCP_HTTP_SESSION_BACKEND": "memory",
        "CLOAK_PLAYWRIGHT_MCP_HTTP_SESSION_IDLE_TTL_MS": "3600000",
        "CLOAK_PLAYWRIGHT_MCP_HTTP_SESSION_MAX": "32"
      }
    }
  }
}

Verdict API

curl -s mcpindex.ai/api/v1/trust/server/io-github-swimmwatch-cloakbrowser-mcp

Free-tier verdict as JSON: decision + dimensions + severity. Call it from your agent before it invokes a tool it just discovered.

Details

version: v1.8.0
category: Browser Automation
verdict expires: 2026-08-02
quality: 100 / 100
operator: swimmwatch

Provenance

Verdict history is anchored to Bitcoin via OpenTimestamps. The anchor proof is public and any skeptic can recompute it offline.

Links

Repository →Website →