CloakBrowserMCP

MCP server for CloakBrowser — giving AI models full access to a stealth Chromium that passes every bot detection test.

What is this?

CloakBrowserMCP exposes CloakBrowser's stealth browser automation as an MCP (Model Context Protocol) server. Any AI model that speaks MCP can launch a source-level patched Chromium, navigate pages, interact with elements, take screenshots, and extract content — all while passing Cloudflare Turnstile, reCAPTCHA v3, FingerprintJS, and 30+ other detection services.

CloakBrowser is not a JS injection or config hack — it's a real Chromium binary with 33 C++ source-level patches. This MCP server wraps its full Python API into 21 tools that models can call directly.

Install

One-line setup (clones, installs, downloads the stealth binary, runs tests):

curl -fsSL https://raw.githubusercontent.com/overtimepog/CloakMCP/main/setup.sh | bash

pip install:

pip install cloakbrowsermcp

From source:

git clone https://github.com/overtimepog/CloakMCP.git
cd CloakMCP
pip install -e ".[dev]"

Quick Start

Claude Desktop / Claude Code

Add to your MCP config:

{
  "mcpServers": {
    "cloakbrowser": {
      "command": "cloakbrowsermcp"
    }
  }
}

Run standalone

cloakbrowsermcp

Tools

Browser Lifecycle

Tool	Description
`launch_browser`	Launch stealth Chromium with anti-detection. Supports proxy, humanize, persistent profiles, fingerprint seeds, timezone/locale, and custom viewport.
`close_browser`	Close the browser and all pages.

Page Management

Tool	Description
`new_page`	Open a new tab, optionally navigating to a URL.
`close_page`	Close a specific page by ID.
`list_pages`	List all open pages with IDs and URLs.

Navigation

Tool	Description
`navigate`	Go to a URL with configurable wait strategy and timeout.

Interaction

Tool	Description
`click`	Click an element. With `humanize=True`, uses Bézier mouse curves.
`type_text`	Type with per-key events — better for reCAPTCHA than fill.
`fill_form`	Set a form field value directly.
`hover`	Hover over an element with realistic mouse movement.
`select_option`	Select from a `<select>` dropdown by value, label, or index.
`press_key`	Press keyboard keys (Enter, Tab, Escape, etc).
`scroll`	Scroll with realistic acceleration curves when humanized.

Content & Data

Tool	Description
`screenshot`	Capture full page, viewport, or element screenshots (base64 PNG).
`get_content`	Extract HTML, visible text, or outer HTML from a selector.
`evaluate`	Run JavaScript in the page context and return results.
`wait_for_selector`	Wait for elements to appear, disappear, attach, or detach.
`get_cookies`	Get all cookies from the browser context.
`set_cookies`	Set cookies in the browser context.
`get_page_info`	Get current URL and title.
`pdf`	Generate a PDF of the page.

Key Features

Anti-Detection Stealth

Every browser session uses CloakBrowser's source-level patches:

33 C++ patches — canvas, WebGL, audio, fonts, GPU, screen, automation signals
0.9 reCAPTCHA v3 score — human-level, server-verified
Passes Cloudflare Turnstile, FingerprintJS, BrowserScan, and 30+ detection services
navigator.webdriver = false at the source level

Human-Like Behavior

launch_browser(humanize=True)

One flag makes all interactions behave like a real user:

Mouse: Bézier curves with easing and slight overshoot
Keyboard: per-character timing, thinking pauses, occasional typos
Scroll: accelerate → cruise → decelerate micro-steps

Persistent Profiles

launch_browser(user_data_dir="./my-profile")

Cookies, localStorage, and cache persist across sessions. Bypasses incognito detection.

Fingerprint Pinning

launch_browser(fingerprint_seed="42069")

Same seed = same fingerprint across launches. Look like a returning visitor instead of a new device each time.

Proxy Support

launch_browser(proxy="http://user:pass@proxy:8080", geoip=True)

Auto-detects timezone and locale from the proxy IP.

Architecture

┌─────────────┐     MCP Protocol      ┌──────────────────┐
│  AI Model   │ ◄──────────────────► │  CloakBrowserMCP  │
│ (Claude,    │    stdio / HTTP       │                  │
│  GPT, etc)  │                       │  21 tools        │
└─────────────┘                       │  session mgmt    │
                                      │  page tracking   │
                                      └────────┬─────────┘
                                               │
                                      ┌────────▼─────────┐
                                      │   CloakBrowser    │
                                      │                  │
                                      │  Patched Chromium │
                                      │  33 C++ patches   │
                                      │  Playwright API   │
                                      └──────────────────┘

cloakbrowsermcp/server.py — MCP server with all tool registrations
cloakbrowsermcp/session.py — Browser lifecycle & page management
cloakbrowsermcp/tools.py — Core tool handlers (navigate, click, type, screenshot, etc.)
cloakbrowsermcp/tools_advanced.py — Stealth config, network interception, viewport, media emulation

Development

git clone https://github.com/overtimepog/CloakMCP.git
cd CloakMCP
pip install -e ".[dev]"

# Run tests (80 tests, all mocked — no browser needed)
pytest

# Run tests with verbose output
pytest -v

License

MIT — see LICENSE.

Credits

Built on CloakBrowser by CloakHQ and the Model Context Protocol Python SDK.

CloakMCP