CloakBrowser MCP

Stealth browser automation for AI agents — a Model Context Protocol server combining CloakBrowser's anti-detection with Playwright MCP-inspired architecture.

CloakBrowser is a source-level patched Chromium that passes Cloudflare Turnstile, reCAPTCHA v3 (0.9 score), FingerprintJS, BrowserScan, and 30+ bot detection services.

Why CloakBrowser MCP?

Feature	Playwright MCP	CloakBrowser MCP
Anti-detection	❌ None	✅ Source-patched Chromium
Cloudflare bypass	❌	✅
reCAPTCHA v3	❌	✅ 0.9 score
Snapshot-first	✅	✅
Markdown extraction	❌	✅ Readability-style
Annotated screenshots	❌	✅ browser-use style
Smart page settling	Basic	✅ MutationObserver + networkidle
Auto-retry clicks	❌	✅
Humanized input	❌	✅ Mouse curves, keyboard timing
Capability gating	✅ --caps	✅ --caps

Quick Start

Install

pip install cloakbrowsermcp

Use with Claude Desktop

Add to your claude_desktop_config.json:

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

Use with VS Code / Cursor

Add to .vscode/mcp.json:

{
  "servers": {
    "cloakbrowser": {
      "command": "cloakbrowsermcp",
      "args": ["--caps", "all"]
    }
  }
}

Use with Hermes Agent

Add to ~/.hermes/config.yaml:

mcp_servers:
  cloakbrowser:
    command: cloakbrowsermcp
    args: ["--caps", "all"]
    timeout: 120

How It Works

Snapshot-First Architecture

CloakBrowser MCP uses accessibility tree snapshots as the primary way for AI models to understand web pages — not screenshots, not raw HTML.

1. cloak_launch()           → Start stealth browser
2. cloak_navigate(pid, url) → Go to page (auto-waits for settle)
3. cloak_snapshot(pid)      → Get interactive elements with [@eN] refs
4. cloak_click(pid, '@e5')  → Click element by ref
5. cloak_type(pid, '@e3', 'hello')  → Type into input
6. cloak_read_page(pid)     → Get content as clean markdown
7. cloak_close()            → Done

Each interactive element gets a [@eN] ref ID. All interaction tools use these refs — no CSS selectors needed.

Three Ways to See a Page

1. cloak_snapshot() — Accessibility tree with [@eN] refs. Fast, cheap, reliable. Use this.
2. cloak_read_page() — Clean markdown extraction. For reading content, not interacting.
3. cloak_screenshot() — Annotated screenshot with element indices. For visual context (images, charts, CAPTCHAs).

Stealth by Default

All anti-detection features are ON by default:

• Source-patched Chromium binary (not Playwright patches — actual Chromium source modifications)
• Human-like mouse curves, keyboard timing, and scroll patterns (humanize=True)
• Stealth fingerprint arguments (consistent canvas, WebGL, audio fingerprints)
• Proxy support with GeoIP-based timezone/locale detection

Tools

Core Tools (20 — always available)

Tool	Description
cloak_launch	Start stealth browser (all anti-detection ON)
cloak_close	Close browser and release resources
cloak_snapshot	PRIMARY — accessibility tree with [@eN] refs
cloak_click	Click element by ref (auto-retry)
cloak_type	Type into input by ref (with submit option)
cloak_select	Select dropdown option by ref
cloak_hover	Hover over element by ref
cloak_check	Check/uncheck checkbox by ref
cloak_read_page	Page content as clean markdown
cloak_screenshot	Annotated screenshot with element indices
cloak_navigate	Go to URL (auto-waits for settle)
cloak_back	Navigate back in history
cloak_forward	Navigate forward in history
cloak_press_key	Press keyboard key
cloak_scroll	Scroll page up/down
cloak_wait	Wai

... View full README on GitHub