CloakBrowser MCP
Playwright MCP-compatible browser automation running on CloakBrowser Chromium
- Pricing
- Open source
- Platforms
- CLI, Linux, macOS
- Runs
- Locally or Remotely
- Version
- 1.15.1
- Listing updated
- 1 day ago
About CloakBrowser MCP
CloakBrowser MCP is an open-source MCP server for browser automation. It can run locally on your machine or as a hosted remote server.
This bridge starts the upstream Playwright MCP as a child process and forwards its browser tool calls unchanged, but points it at CloakBrowser's Chromium build. The only tools it adds are two local introspection tools, cloakbrowser_binary_info and cloakbrowser_bridge_info. Versions are mapped to specific upstream Playwright MCP and CloakBrowser releases in a published compatibility table.
Extras aimed at deployment include persistent browser profiles, validated Playwright context options, Chrome extension loading, opt-in managed CDP access, and GeoIP-aware proxy matching that aligns timezone and locale flags with a configured proxy for regional QA. A humanized input layer routes mouse, keyboard and scroll actions through CloakBrowser for interaction-sensitive flows. Because those features target browser fingerprinting and bot detection, it is worth reviewing for site terms compliance.
It installs with npx or Docker, runs over stdio or Streamable HTTP, and needs Node.js 22.13 or later. A doctor command checks the setup.
Install
Run in a terminal
claude mcp add cloakbrowser-mcp -- npx -y cloakbrowser-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"cloakbrowser-mcp": {
"command": "npx",
"args": [
"-y",
"cloakbrowser-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"cloakbrowser-mcp": {
"command": "npx",
"args": [
"-y",
"cloakbrowser-mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"cloakbrowser-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"cloakbrowser-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"cloakbrowser-mcp": {
"command": "npx",
"args": [
"-y",
"cloakbrowser-mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"cloakbrowser-mcp": {
"command": "npx",
"args": [
"-y",
"cloakbrowser-mcp"
]
}
}
}Configuration
PLAYWRIGHT_MCP_BROWSER_ENGINEBridge browser engine: cloak or playwright.PLAYWRIGHT_MCP_HEADLESSRun the browser in headless mode.PLAYWRIGHT_MCP_OUTPUT_DIRDirectory where upstream Playwright MCP writes artifacts.PLAYWRIGHT_MCP_CODEGENGenerate code in typescript, python, java, csharp, or none.PLAYWRIGHT_MCP_SNAPSHOT_BOXESInclude element bounding boxes in browser snapshots.PLAYWRIGHT_MCP_TIMEOUT_SETTLEMilliseconds to wait after actions for triggered work to settle.PLAYWRIGHT_MCP_USER_DATA_DIRPersistent Chromium profile directory. The bridge resolves it to an absolute path and writes it to generated Playwright MCP config.CLOAK_PLAYWRIGHT_MCP_CONTEXT_OPTIONSJSON object with validated Playwright context options such as viewport, locale, timezoneId, permissions, geolocation, and headers.CLOAK_PLAYWRIGHT_MCP_EXTENSION_PATHSJSON array or comma-separated list of Chrome extension directories. Requires PLAYWRIGHT_MCP_USER_DATA_DIR.CLOAK_PLAYWRIGHT_MCP_CONSOLE_FALLBACKPatch upstream console message collection for CloakBrowser compatibility.CLOAK_PLAYWRIGHT_MCP_GEOIP_PROXY_MATCHResolve proxy GeoIP and match CloakBrowser timezone/locale fingerprint flags when PLAYWRIGHT_MCP_PROXY_SERVER is set.CLOAK_PLAYWRIGHT_MCP_EXTRA_ARGSComma-separated or JSON array of extra Chromium launch arguments.CLOAK_PLAYWRIGHT_MCP_HTTP_HOSTStreamable HTTP bind host.CLOAK_PLAYWRIGHT_MCP_HTTP_PORTStreamable HTTP bind port.CLOAK_PLAYWRIGHT_MCP_HTTP_ENDPOINTStreamable HTTP endpoint path.CLOAK_PLAYWRIGHT_MCP_HTTP_AUTH_TOKENOptional Streamable HTTP Bearer token.CLOAK_PLAYWRIGHT_MCP_HTTP_SESSION_BACKENDSession metadata backend. Only memory is implemented in this release.CLOAK_PLAYWRIGHT_MCP_HTTP_SESSION_IDLE_TTL_MSIdle TTL for Streamable HTTP sessions.CLOAK_PLAYWRIGHT_MCP_HTTP_SESSION_MAXMaximum active Streamable HTTP sessions in one process.PLAYWRIGHT_MCP_BROWSER_ENGINEBridge browser engine: cloak or playwright.PLAYWRIGHT_MCP_HEADLESSRun the browser in headless mode.PLAYWRIGHT_MCP_OUTPUT_DIRDirectory where upstream Playwright MCP writes artifacts.PLAYWRIGHT_MCP_CODEGENGenerate code in typescript, python, java, csharp, or none.PLAYWRIGHT_MCP_SNAPSHOT_BOXESInclude element bounding boxes in browser snapshots.PLAYWRIGHT_MCP_TIMEOUT_SETTLEMilliseconds to wait after actions for triggered work to settle.PLAYWRIGHT_MCP_USER_DATA_DIRPersistent Chromium profile directory. The bridge resolves it to an absolute path and writes it to generated Playwright MCP config.CLOAK_PLAYWRIGHT_MCP_CONTEXT_OPTIONSJSON object with validated Playwright context options such as viewport, locale, timezoneId, permissions, geolocation, and headers.CLOAK_PLAYWRIGHT_MCP_EXTENSION_PATHSJSON array or comma-separated list of Chrome extension directories. Requires PLAYWRIGHT_MCP_USER_DATA_DIR.CLOAK_PLAYWRIGHT_MCP_CONSOLE_FALLBACKPatch upstream console message collection for CloakBrowser compatibility.CLOAK_PLAYWRIGHT_MCP_GEOIP_PROXY_MATCHResolve proxy GeoIP and match CloakBrowser timezone/locale fingerprint flags when PLAYWRIGHT_MCP_PROXY_SERVER is set.CLOAK_PLAYWRIGHT_MCP_EXTRA_ARGSComma-separated or JSON array of extra Chromium launch arguments.PLAYWRIGHT_MCP_BROWSER_ENGINEBridge browser engine: cloak or playwright.PLAYWRIGHT_MCP_HEADLESSRun the browser in headless mode.PLAYWRIGHT_MCP_OUTPUT_DIRDirectory inside the container where upstream Playwright MCP writes artifacts.PLAYWRIGHT_MCP_CODEGENGenerate code in typescript, python, java, csharp, or none.PLAYWRIGHT_MCP_SNAPSHOT_BOXESInclude element bounding boxes in browser snapshots.PLAYWRIGHT_MCP_TIMEOUT_SETTLEMilliseconds to wait after actions for triggered work to settle.PLAYWRIGHT_MCP_USER_DATA_DIRPersistent Chromium profile directory inside the container. Use /data/profiles/... with the existing /data volume.CLOAK_PLAYWRIGHT_MCP_CONTEXT_OPTIONSJSON object with validated Playwright context options such as viewport, locale, timezoneId, permissions, geolocation, and headers.CLOAK_PLAYWRIGHT_MCP_EXTENSION_PATHSJSON array or comma-separated list of Chrome extension directories inside the container. Requires PLAYWRIGHT_MCP_USER_DATA_DIR.CLOAK_PLAYWRIGHT_MCP_CONSOLE_FALLBACKPatch upstream console message collection for CloakBrowser compatibility.CLOAK_PLAYWRIGHT_MCP_GEOIP_PROXY_MATCHResolve proxy GeoIP and match CloakBrowser timezone/locale fingerprint flags when PLAYWRIGHT_MCP_PROXY_SERVER is set.CLOAK_PLAYWRIGHT_MCP_EXTRA_ARGSComma-separated or JSON array of extra Chromium launch arguments.PLAYWRIGHT_MCP_BROWSER_ENGINEBridge browser engine: cloak or playwright.PLAYWRIGHT_MCP_HEADLESSRun the browser in headless mode.PLAYWRIGHT_MCP_OUTPUT_DIRDirectory inside the container where upstream Playwright MCP writes artifacts.PLAYWRIGHT_MCP_CODEGENGenerate code in typescript, python, java, csharp, or none.PLAYWRIGHT_MCP_SNAPSHOT_BOXESInclude element bounding boxes in browser snapshots.PLAYWRIGHT_MCP_TIMEOUT_SETTLEMilliseconds to wait after actions for triggered work to settle.PLAYWRIGHT_MCP_USER_DATA_DIRPersistent Chromium profile directory inside the container. Use /data/profiles/... with the existing /data volume.CLOAK_PLAYWRIGHT_MCP_CONTEXT_OPTIONSJSON object with validated Playwright context options such as viewport, locale, timezoneId, permissions, geolocation, and headers.CLOAK_PLAYWRIGHT_MCP_EXTENSION_PATHSJSON array or comma-separated list of Chrome extension directories inside the container. Requires PLAYWRIGHT_MCP_USER_DATA_DIR.CLOAK_PLAYWRIGHT_MCP_CONSOLE_FALLBACKPatch upstream console message collection for CloakBrowser compatibility.CLOAK_PLAYWRIGHT_MCP_GEOIP_PROXY_MATCHResolve proxy GeoIP and match CloakBrowser timezone/locale fingerprint flags when PLAYWRIGHT_MCP_PROXY_SERVER is set.CLOAK_PLAYWRIGHT_MCP_EXTRA_ARGSComma-separated or JSON array of extra Chromium launch arguments.
Tools this server provides (2)
Taken from the project documentation; the running server may differ.
- cloakbrowser_binary_info
- Reports information about the CloakBrowser binary
- cloakbrowser_bridge_info
- Reports information about the bridge
What it does
- Upstream parity
- Playwright MCP tools are forwarded unchanged.
- Persistent profiles
- Keep login state with a user data directory.
- Extension loading
- Load Chrome extensions into the profile.
- GeoIP proxy matching
- Match timezone and locale to a proxy location.
- Humanized input
- Human-like mouse, keyboard and scroll behavior.
- npm and Docker
- Run over stdio or Streamable HTTP.
Good for
- Run web research or testing with persistent logins
- Check regional page variants behind a proxy
- Test flows with a Chrome extension loaded
- Host a browser automation endpoint in Docker
Pricing
Open source
Open source, MIT-style license badge on the repository
Prices change. Check swimmwatch.github.io before you buy.
CloakBrowser MCP FAQ
Does it change the Playwright tools?
No, upstream tools are unchanged and two introspection tools are added.
What does it need?
Node.js 22.13 or later in the 22 line, or Node 24 and above.
Which transports?
stdio and Streamable HTTP.
How do I check my setup?
Run npx cloakbrowser-mcp@latest doctor.
Is CloakBrowser MCP free?
Yes. CloakBrowser MCP is open source, so you can use and self-host it for free.
How do I add CloakBrowser MCP to Claude Code?
Run this command in your terminal: claude mcp add cloakbrowser-mcp -- npx -y cloakbrowser-mcp
What are the best alternatives to CloakBrowser MCP?
The closest alternatives to CloakBrowser MCP are Browser Use, Scrapling MCP Server, Oya Browser, Mantis and Auto-building agents.
Alternatives to CloakBrowser MCP

Browser Use
MCP serverBrowser agents and cloud browsers for AI, with an MCP server for web tasks
- 7 tools
- Remote
- Freemium
- 121K GitHub stars
- Browser automation

Scrapling MCP Server
MCP serverMCP server for AI clients to scrape sites with HTTP and stealth browser sessions
Runs locally- 17 tools
- Open source
- 104K GitHub stars
- Web search and scraping

Oya Browser
MCP serverHIPAA-oriented agentic browser with replayable playbooks, reachable over MCP
- 32 tools
- Remote
- Freemium
- 349 GitHub stars
- Browser automation
Mantis
MCP serverBrowser MCP server that gives agents numbered text pages instead of screenshots
Runs locally- 1 tool
- Open source
- 5 Hacker News points
- Browser automation

Auto-building agents
MCP serverBuild and continue browser and Mac automation scripts for Super through Claude
- Remote
- Paid
- Browser automation

pour
MCP serverRun WCAG 2.2 accessibility audits and vision simulations on any URL from an agent
Runs locally- Open source
- Developer tools