# CloakBrowser MCP

> CloakBrowser MCP is an open-source MCP server for browser automation. Playwright MCP-compatible browser automation running on CloakBrowser Chromium. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Linux, macOS, Windows, self-hosted
- **Website:** https://swimmwatch.github.io/cloakbrowser-mcp/
- **Repository:** https://github.com/swimmwatch/cloakbrowser-mcp
- **MCP Registry name:** io.github.swimmwatch/cloakbrowser-mcp
- **Categories:** browser automation
- **Listing updated:** 2026-11-16

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add cloakbrowser-mcp -- npx -y cloakbrowser-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "cloakbrowser-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "cloakbrowser-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "cloakbrowser-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "cloakbrowser-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "cloakbrowser-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "cloakbrowser-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "cloakbrowser-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "cloakbrowser-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "cloakbrowser-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "cloakbrowser-mcp"
      ]
    }
  }
}
```

## Tools

- `cloakbrowser_binary_info`: Reports information about the CloakBrowser binary
- `cloakbrowser_bridge_info`: Reports information about the bridge

## 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

- [Browser Use](https://ai-powered.com/mcp/browser-use): Browser Use is a freemium MCP server for browser automation.
- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [Oya Browser](https://ai-powered.com/mcp/oya-browser): Oya Browser is a freemium MCP server for browser automation.
- [Mantis](https://ai-powered.com/mcp/mantis-2): Mantis is an open-source MCP server for browser automation.
- [Auto-building agents](https://ai-powered.com/mcp/auto-building-agents): Auto-building agents is a paid MCP server for browser automation.
- [pour](https://ai-powered.com/mcp/pour): pour is an open-source MCP server for developer tools.
- [AgentFarm](https://ai-powered.com/mcp/agentfarm): AgentFarm is a freemium MCP server for browser automation.
- [OpenAdapt: your agent decides, OpenAdapt enters it and checks it saved](https://ai-powered.com/mcp/openadapt-your-agent-decides-openadapt-enters-it-and-checks): OpenAdapt: your agent decides, OpenAdapt enters it and checks it saved is an open-source MCP server for browser automation.

---
Source: https://ai-powered.com/mcp/cloakbrowser-mcp
