Skip to content

Get started Compare Recipes

CloakBrowser MCP Server

cloakbrowser-mcp is a drop-in Playwright MCP-compatible browser automation server with unchanged upstream tools, CloakBrowser Chromium, and production-ready npm, Docker, and Streamable HTTP packaging. It runs upstream @playwright/mcp as the canonical browser tool surface and adds deployment-oriented CloakBrowser execution features around it.

30-second demo

30-second demo showing CloakBrowser MCP startup, humanized research prompt typing, web automation, and testing workflows

Watch the first run: start the npm package, connect an MCP client, ask for web research, automation, or testing, and inspect the real browser result.

Use it when you want Playwright MCP-compatible browser tools plus persistent profiles, extension loading, context validation, GeoIP-aware proxy matching for regional QA, or humanized input behavior for interaction-sensitive flows.

Current version: v1.7.0.

Version Compatibility

cloakbrowser-mcp @playwright/mcp Playwright MCP Docker base CloakBrowser Transport Parity
1.7.0 ^0.0.77 mcr.microsoft.com/playwright/mcp:v0.0.77 ^0.4.8 stdio, Streamable HTTP Compared in CI
1.6.1 ^0.0.77 mcr.microsoft.com/playwright/mcp:v0.0.77 ^0.4.7 stdio, Streamable HTTP Compared in CI
1.6.0 ^0.0.77 mcr.microsoft.com/playwright/mcp:v0.0.77 ^0.4.7 stdio, Streamable HTTP Compared in CI
1.5.0 ^0.0.76 mcr.microsoft.com/playwright/mcp:v0.0.76 ^0.4.3 stdio, Streamable HTTP Compared in CI
1.4.0 ^0.0.76 mcr.microsoft.com/playwright/mcp:v0.0.76 ^0.3.32 stdio, Streamable HTTP Compared in CI
1.3.0 ^0.0.75 mcr.microsoft.com/playwright/mcp:v0.0.75 ^0.3.31 stdio, Streamable HTTP Compared in CI
1.2.7 ^0.0.75 mcr.microsoft.com/playwright/mcp:v0.0.75 ^0.3.30 stdio, Streamable HTTP Compared in CI
1.2.6 ^0.0.75 mcr.microsoft.com/playwright/mcp:v0.0.75 ^0.3.30 stdio, Streamable HTTP Compared in CI
1.2.5 ^0.0.75 mcr.microsoft.com/playwright/mcp:v0.0.75 ^0.3.30 stdio, Streamable HTTP Compared in CI
1.2.3 ^0.0.75 mcr.microsoft.com/playwright/mcp:v0.0.75 ^0.3.30 stdio, Streamable HTTP Compared in CI
1.2.2 ^0.0.75 mcr.microsoft.com/playwright/mcp:v0.0.75 ^0.3.30 stdio, Streamable HTTP Compared in CI
1.2.1 ^0.0.75 mcr.microsoft.com/playwright/mcp:v0.0.75 ^0.3.30 stdio, Streamable HTTP Compared in CI
1.2.0 ^0.0.75 mcr.microsoft.com/playwright/mcp:v0.0.75 ^0.3.30 stdio, Streamable HTTP Compared in CI
1.1.0 ^0.0.75 mcr.microsoft.com/playwright/mcp:v0.0.75 ^0.3.30 stdio, Streamable HTTP Compared in CI
1.0.2 ^0.0.75 mcr.microsoft.com/playwright/mcp:v0.0.75 ^0.3.30 stdio Compared in CI
1.0.1 ^0.0.75 mcr.microsoft.com/playwright/mcp:v0.0.75 ^0.3.30 stdio Compared in CI
1.0.0 ^0.0.75 mcr.microsoft.com/playwright/mcp:v0.0.75 ^0.3.30 stdio Compared in CI

See Version Compatibility for the maintained mapping between this project's SemVer releases and upstream Playwright MCP versions.

What It Is

  • Bridge runtime

Starts upstream Playwright MCP as a child process and forwards browser tool calls unchanged.

  • CloakBrowser execution

Generates a Playwright MCP config with launchOptions.executablePath set to CloakBrowser.

  • npm CLI

Published as a thin Node.js CLI package for stdio and Streamable HTTP MCP clients.

  • Docker image

Based on the official Playwright MCP image and preloads the CloakBrowser binary cache.

  • GeoIP proxy matching

Aligns CloakBrowser timezone, language, and locale fingerprint flags with a configured proxy location.

  • Humanized input behavior

Routes page interactions through CloakBrowser's human-like mouse, keyboard, and scroll layer.

Tool Surface

The upstream Playwright MCP tool contracts are authoritative. This project adds only two local introspection tools:

  • cloakbrowser_binary_info
  • cloakbrowser_bridge_info

See @playwright/mcp vs cloakbrowser-mcp for a neutral feature comparison.

Next Steps