swimmwatch avatar

CloakBrowser MCP

swimmwatch/cloakbrowser-mcp

A Playwright browser automation bridge that swaps the standard Chromium binary for CloakBrowser, exposing the same MCP tool set you'd get from Microsoft's @playwright/mcp but with fingerprint resistance baked in. All the upstream Playwright tools for navigation, screenshots, form fills, and DOM queries work unchanged. The package stays intentionally thin: it just points launchOptions.executablePath at CloakBrowser and passes through the tool schemas. Runs over stdio or Streamable HTTP, works from npm or Docker, and includes a compatibility matrix that tracks pinned versions of Playwright MCP, CloakBrowser, and the base Docker image. Reach for this when you need browser automation that looks less like a bot to fingerprinting scripts.

GitHub stars
176
tools
2
auth
Secret needed
transport
STDIO, HTTP
env vars
19
last updated
Oct 18, 2026

Tools

2 tools

Public tool metadata for what this MCP can expose to an agent.

cloakbrowser_binary_inforeturns CloakBrowser package, platform, cache, and resolved binary data.

returns CloakBrowser package, platform, cache, and resolved binary data.

No parameter schema in public metadata yet.

cloakbrowser_bridge_inforeturns bridge metadata, upstream package/version, and local tool names.

returns bridge metadata, upstream package/version, and local tool names.

No parameter schema in public metadata yet.

Sponsors

Configuration

PLAYWRIGHT_MCP_BROWSER_ENGINEdefault: cloak

Bridge browser engine: cloak or playwright.

PLAYWRIGHT_MCP_HEADLESSdefault: true

Run the browser in headless mode.

PLAYWRIGHT_MCP_OUTPUT_DIRdefault: .playwright-mcp

Directory where upstream Playwright MCP writes artifacts.

PLAYWRIGHT_MCP_CODEGENdefault: typescript

Generate code in typescript, python, java, csharp, or none.

PLAYWRIGHT_MCP_SNAPSHOT_BOXESdefault: false

Include element bounding boxes in browser snapshots.

PLAYWRIGHT_MCP_TIMEOUT_SETTLEdefault: 500

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_FALLBACKdefault: true

Patch upstream console message collection for CloakBrowser compatibility.

CLOAK_PLAYWRIGHT_MCP_GEOIP_PROXY_MATCHdefault: false

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_HOSTdefault: 127.0.0.1

Streamable HTTP bind host.

CLOAK_PLAYWRIGHT_MCP_HTTP_PORTdefault: 3000

Streamable HTTP bind port.

CLOAK_PLAYWRIGHT_MCP_HTTP_ENDPOINTdefault: /mcp

Streamable HTTP endpoint path.

CLOAK_PLAYWRIGHT_MCP_HTTP_AUTH_TOKENsecret

Optional Streamable HTTP Bearer token.

CLOAK_PLAYWRIGHT_MCP_HTTP_SESSION_BACKENDdefault: memory

Session metadata backend. Only memory is implemented in this release.

CLOAK_PLAYWRIGHT_MCP_HTTP_SESSION_IDLE_TTL_MSdefault: 3600000

Idle TTL for Streamable HTTP sessions.

CLOAK_PLAYWRIGHT_MCP_HTTP_SESSION_MAXdefault: 32

Maximum active Streamable HTTP sessions in one process.

Readme

cloakbrowser-mcp

CloakBrowser MCP


View the full README on GitHub

Details

Repository
github.com/swimmwatch/cloakbrowser-mcp
Website
swimmwatch.github.io/cloakbrowser-mcp
Categories
Web & Browser Automation, Automation & Workflows
Package
cloakbrowser-mcp
Transport
STDIO, HTTP
Auth
Required
Registry
MCP registry, active

Related Web & Browser Automation MCP servers

View all
1aishwaryshrivastav avatarVibe Test — Browser Testing Agentaishwaryshrivastav/vibe-testingCode-aware browser testing agent — 14 Playwright tools for AI code editors via MCP18stars
2leonting1010 avatarTapleonting1010/tapBrowser MCP for logged-in tasks. Uses your Chrome — credentials stay local. Zero-token replay.18stars
3avivgerz-hue avatarghost-qaavivgerz-hue/ghost-qaAutonomous headless browser QA & self-healing verification loop for AI coding agents.13stars
4riproductions avatarWingmanProtocol Agent Gatewayriproductions/wingman-agent-gatewayDurable memory, headless browser and research for agents. Pay per call: x402 USDC on Base or credits0stars
5hmakt99 avatarVedhahmakt99/vedhaBrowser testing on Playwright that checks the server, not just the screen, before it reports a pass.1stars
6kultmember6banger avatarKloaktkultmember6banger/kloaktCloaked headless browser for AI agents — stealth TLS, smart extraction, SPA fallback1stars