CLI Reference¶

Usage: cloakbrowser-mcp [options] [command]

Playwright MCP bridge backed by CloakBrowser.

Options:
  -V, --version                     output the version number
  -h, --help                        display help for command

Transport
  --transport <mode>                MCP transport exposed by the bridge.
                                    (choices: "stdio", "streamable-http",
                                    default: stdio, env:
                                    CLOAK_PLAYWRIGHT_MCP_TRANSPORT)

Bridge
  --geoip-proxy-match               Match CloakBrowser timezone and locale to
                                    the configured proxy GeoIP. (default: false,
                                    env: CLOAK_PLAYWRIGHT_MCP_GEOIP_PROXY_MATCH)
  --humanize                        Enable CloakBrowser human-like mouse,
                                    keyboard, and scroll behavior. (default:
                                    false, env: CLOAK_PLAYWRIGHT_MCP_HUMANIZE)
  --human-preset <preset>           CloakBrowser human behavior preset. Used
                                    only when humanize is enabled. (choices:
                                    "default", "careful", default: default, env:
                                    CLOAK_PLAYWRIGHT_MCP_HUMAN_PRESET)

Streamable HTTP
  --http-protocol <protocol>        Streamable HTTP listener protocol. (choices:
                                    "http", "https", default: http, env:
                                    CLOAK_PLAYWRIGHT_MCP_HTTP_PROTOCOL)
  --http-host <host>                Streamable HTTP bind host. (default:
                                    127.0.0.1, env:
                                    CLOAK_PLAYWRIGHT_MCP_HTTP_HOST)
  --http-port <port>                Streamable HTTP bind port. Use 0 for an
                                    ephemeral port in tests. (default: 3000,
                                    env: CLOAK_PLAYWRIGHT_MCP_HTTP_PORT)
  --http-endpoint <path>            Streamable HTTP endpoint path. Reserved
                                    probe paths: /healthz, /readyz. (default:
                                    /mcp, env:
                                    CLOAK_PLAYWRIGHT_MCP_HTTP_ENDPOINT)
  --http-auth-token <token>         Optional Bearer token required on Streamable
                                    HTTP requests. (env:
                                    CLOAK_PLAYWRIGHT_MCP_HTTP_AUTH_TOKEN)
  --https-cert <path>               TLS certificate PEM file for HTTPS
                                    Streamable HTTP. (env:
                                    CLOAK_PLAYWRIGHT_MCP_HTTPS_CERT)
  --https-key <path>                TLS private key PEM file for HTTPS
                                    Streamable HTTP. (env:
                                    CLOAK_PLAYWRIGHT_MCP_HTTPS_KEY)
  --https-pfx <path>                TLS PFX/PKCS12 file for HTTPS Streamable
                                    HTTP. (env: CLOAK_PLAYWRIGHT_MCP_HTTPS_PFX)
  --https-passphrase <value>        Passphrase for an encrypted HTTPS key or
                                    PFX. (env:
                                    CLOAK_PLAYWRIGHT_MCP_HTTPS_PASSPHRASE)
  --http-session-backend <backend>  Session metadata backend. Only memory is
                                    implemented in this release. (choices:
                                    "memory", default: memory, env:
                                    CLOAK_PLAYWRIGHT_MCP_HTTP_SESSION_BACKEND)
  --http-session-idle-ttl-ms <ms>   Idle TTL for Streamable HTTP sessions.
                                    (default: 3600000, env:
                                    CLOAK_PLAYWRIGHT_MCP_HTTP_SESSION_IDLE_TTL_MS)
  --http-session-max <count>        Maximum active Streamable HTTP sessions in
                                    one process. (default: 32, env:
                                    CLOAK_PLAYWRIGHT_MCP_HTTP_SESSION_MAX)

Commands:
  doctor [options]                  Run local diagnostics without starting the
                                    MCP bridge.

Usage: doctor [options]

Run local diagnostics without starting the MCP bridge.

Options:
  --json      Output diagnostics as JSON.
  -h, --help  display help for command