Skip to content

CLI Reference

This page is generated from the Commander.js CLI definition during MkDocs builds. Update the CLI definition in source code instead of editing this page by hand.

Usage

Usage: cloakbrowser-mcp [options]

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)

Streamable HTTP
  --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. (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)
  --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)

Options

Option Environment Default Values Description
--transport <mode> CLOAK_PLAYWRIGHT_MCP_TRANSPORT stdio stdio, streamable-http MCP transport exposed by the bridge.
--http-host <host> CLOAK_PLAYWRIGHT_MCP_HTTP_HOST 127.0.0.1 Streamable HTTP bind host.
--http-port <port> CLOAK_PLAYWRIGHT_MCP_HTTP_PORT 3000 Streamable HTTP bind port. Use 0 for an ephemeral port in tests.
--http-endpoint <path> CLOAK_PLAYWRIGHT_MCP_HTTP_ENDPOINT /mcp Streamable HTTP endpoint path.
--http-auth-token <token> CLOAK_PLAYWRIGHT_MCP_HTTP_AUTH_TOKEN unset Optional Bearer token required on Streamable HTTP requests.
--http-session-backend <backend> CLOAK_PLAYWRIGHT_MCP_HTTP_SESSION_BACKEND memory memory Session metadata backend. Only memory is implemented in this release.
--http-session-idle-ttl-ms <ms> CLOAK_PLAYWRIGHT_MCP_HTTP_SESSION_IDLE_TTL_MS 3600000 Idle TTL for Streamable HTTP sessions.
--http-session-max <count> CLOAK_PLAYWRIGHT_MCP_HTTP_SESSION_MAX 32 Maximum active Streamable HTTP sessions in one process.