Skip to main content
Glama
CloakBrowser MCP Server

CloakBrowser MCP Server

by MiwooMiwoo

CloakBrowser MCP Server

English | 中文

Stealth browser automation via Model Context Protocol, powered by CloakBrowser.

A drop-in MCP server that wraps CloakBrowser's stealth Chromium with 57 source-level C++ fingerprint patches — not JS injection. Passes all 30/30 bot detection tests (reCAPTCHA v3 score: 0.9, Cloudflare Turnstile: PASS, FingerprintJS: PASS).

All tools use the cloak_ prefix to avoid conflicts with Hermes Agent's built-in browser_* tools.

Features

  • 22 cloak tools — navigate, click, type, screenshot, console, evaluate JS, form filling, drag & drop, and more

  • Stealth by default — navigator.webdriver = false, real Chrome TLS fingerprint, no CDP detection

  • Human-like behavior — humanize=True enables Bézier mouse curves, per-character keyboard timing

  • Proxy support — HTTP & SOCKS5 with GeoIP auto-detection

  • Session persistence — save/load cookies and localStorage

  • Compatible with any MCP client — Hermes Agent, Claude Desktop, Cursor, etc.

  • No naming conflicts — cloak_* prefix won't collide with Hermes built-in browser_* tools

Related MCP server: CloakMCP

Quick Start

Install

pip install mcp-cloakbrowser

Run

# As a stdio MCP server
mcp-cloakbrowser

# Or directly
python -m cloakbrowser_mcp.server

Use with Hermes Agent

Add to ~/.hermes/config.yaml:

mcp_servers:
  cloakbrowser:
    command: "python"
    args: ["-m", "cloakbrowser_mcp.server"]
    timeout: 120

Restart Hermes Agent. Tools will be registered as mcp_cloakbrowser_cloak_*.

Use with Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "cloakbrowser": {
      "command": "mcp-cloakbrowser"
    }
  }
}

Available Tools

All tools use the cloak_ prefix (registered as mcp_cloakbrowser_cloak_* in Hermes):

Tool

Description

cloak_launch

Launch a stealth CloakBrowser instance

cloak_close

Close the browser and clean up

cloak_navigate

Navigate to a URL, return compact snapshot

cloak_snapshot

Get accessibility tree with ref IDs

cloak_click

Click element by ref (e.g. @e5)

cloak_type

Type text into input field by ref

cloak_press

Press keyboard key (Enter, Tab, Escape...)

cloak_scroll

Scroll page up/down

cloak_back

Navigate back in history

cloak_forward

Navigate forward in history

cloak_console

Get console logs or evaluate JS

cloak_get_images

List all images with URLs and alt text

cloak_screenshot

Take PNG screenshot

cloak_wait_for

Wait for element or text to appear

cloak_evaluate

Evaluate JavaScript expression

cloak_get_content

Get text/HTML of page or element

cloak_extract_links

Extract all links as JSON

cloak_fill_form

Fill multiple form fields at once

cloak_hover

Hover over element by ref

cloak_select_option

Select options in <select> elements

cloak_drag

Drag element to another element

cloak_save_storage_state

Save cookies/localStorage to file

cloak_load_storage_state

Load cookies/localStorage from file

cloak_info

Get current page URL, title, viewport

Tool Usage Examples

Navigate and Interact

# Launch browser
await call_tool("cloak_launch", {"headless": True, "humanize": True})

# Navigate to a page
await call_tool("cloak_navigate", {"url": "https://example.com"})

# Get snapshot to see interactive elements
snapshot = await call_tool("cloak_snapshot", {})
# Shows: [@e1] <a>Link text, [@e2] <input>[type: text]...

# Click a link
await call_tool("cloak_click", {"ref": "@e1"})

# Type into search box
await call_tool("cloak_type", {"ref": "@e2", "text": "hello world", "submit": True})

# Take screenshot
await call_tool("cloak_screenshot", {})

Fill a Login Form

await call_tool("cloak_fill_form", {
    "fields": [
        {"ref": "@e1", "value": "username"},
        {"ref": "@e2", "value": "password123"},
    ],
    "submit_ref": "@e3",
})

Advanced: Custom Fingerprint & Proxy

await call_tool("cloak_launch", {
    "headless": True,
    "humanize": True,
    "proxy": "socks5://user:pass@proxy:1080",
    "fingerprint_seed": "my-unique-seed-123",
    "geoip": True,
    "locale": "zh-CN",
})

Save/Restore Session

# Save session after login
await call_tool("cloak_save_storage_state", {"path": "session.json"})

# Later: restore session
await call_tool("cloak_load_storage_state", {"path": "session.json"})

Why cloak_* Prefix?

Hermes Agent has built-in browser_* tools (browser_navigate, browser_click, etc.) that use its own Playwright instance. Using the same names would cause conflicts. The cloak_ prefix makes it clear these tools use CloakBrowser's stealth Chromium, and allows you to use both in the same session:

  • browser_navigate → Hermes built-in Playwright (fast, no stealth)

  • cloak_navigate → CloakBrowser stealth Chromium (passes bot detection)

Architecture

MCP Client (Hermes/Claude/etc.)
    │ stdio (JSON-RPC)
    ▼
mcp-cloakbrowser server
    │
    ▼
CloakBrowser (Playwright-compatible API)
    │
    ▼
Stealth Chromium (57 C++ patches)

The server maintains a single browser instance (singleton pattern). All tools operate on the current page. The browser is auto-launched on first tool call if not explicitly launched.

Development

git clone https://github.com/MiwooMiwoo/cloakbrowser-mcp.git
cd cloakbrowser-mcp
pip install -e ".[dev]"

License

MIT

Available Tools

24 tools
cloak_backA

Navigate back in browser history.

Inputs: no named parameters.

cloak_clickB

Click on an element identified by its ref ID from the snapshot (e.g. '@e5').

Inputs: ref (required).

cloak_closeA

Close the browser and clean up resources.

Inputs: no named parameters.

cloak_consoleC

Get browser console output or evaluate JavaScript expression.

Inputs: clear, expression.

cloak_dragB

Drag an element from one position to another.

Inputs: ref_from (required), ref_to (required).

cloak_evaluateC

Evaluate JavaScript expression in the page context.

Inputs: expression (required).

cloak_fill_formC

Fill multiple form fields at once.

Inputs: fields (required), submit_ref.

cloak_forwardB

Navigate forward in browser history.

Inputs: no named parameters.

cloak_get_contentB

Get text or HTML content of an element or the entire page.

Inputs: selector, text_only, max_length.

cloak_get_imagesA

Get a list of all images on the current page with URLs and alt text.

Inputs: no named parameters.

cloak_hoverB

Hover over an element identified by its ref ID.

Inputs: ref (required).

cloak_infoA

Get information about the current browser session (URL, title, viewport).

Inputs: no named parameters.

cloak_launchA

Launch a stealth CloakBrowser instance. Call this before any other cloak tool.

Inputs: headless, proxy, humanize, user_agent, +5 more.

cloak_load_storage_stateA

Load browser storage state from a JSON file.

Inputs: path (required).

cloak_navigateA

Navigate to a URL and return a compact snapshot of the page.

Inputs: url (required).

cloak_pressA

Press a keyboard key (Enter, Tab, Escape, ArrowDown, etc.).

Inputs: key (required).

cloak_save_storage_stateB

Save browser storage state (cookies, localStorage) to a JSON file.

Inputs: path (required).

cloak_screenshotC

Take a screenshot of the current page. Returns a PNG image.

Inputs: question, annotate.

cloak_scrollB

Scroll the page in a direction.

Inputs: direction.

cloak_select_optionC

Select option(s) in a element.

Inputs: ref (required), values (required).

cloak_snapshotC

Get a text-based snapshot of the current page's accessibility tree with ref IDs for interactive elements.

Inputs: full.

cloak_typeA

Type text into an input field identified by its ref ID.

Inputs: ref (required), text (required), submit.

cloak_wait_forB

Wait for an element or text to appear on the page.

Inputs: selector, text, timeout.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 24 tools

    Disambiguation5/5

    Each tool targets a distinct action: navigation, interaction, state management, information retrieval, or waiting. No two tools have overlapping purposes; even similar ones like cloak_console and cloak_evaluate are differentiated by scope (console output vs. arbitrary JS evaluation).

    Naming Consistency5/5

    All tools follow a consistent 'cloak_verb' pattern in snake_case, with descriptive and predictable verb choices (e.g., cloak_navigate, cloak_click, cloak_snapshot). No deviations or mixed styles.

    Tool Count4/5

    24 tools is on the higher end but each serves a clear and necessary function in browser automation. The count is justified by the breadth of tasks (navigation, DOM interaction, state management, etc.) and does not feel excessive.

    Completeness4/5

    The tool surface covers all core browser automation workflows: navigation, element interaction, form handling, state persistence, and information extraction. Minor gaps exist (e.g., no explicit tab management or dialog handling), but they do not critically impair common use cases.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      An MCP server that provides LLMs with stealth browser automation capabilities via CloakBrowser to bypass bot detection services like Cloudflare and reCAPTCHA. It supports full page interaction, content extraction, and human-like behavior through 30 specialized tools.
      20
      40 PyPI
      14
      Apache 2.0
    • A
      license
      B
      quality
      B
      maintenance
      A stealth browser MCP server with 69 tools for undetectable web automation. It bypasses bot detection systems like Cloudflare while providing full browser control for tasks like form filling, data scraping, and session management.
      133
      1,059 npm
      23
      MIT
    • -
      license
      Not graded
      quality
      Not graded
      maintenance
      Undetectable browser automation server for MCP-compatible AI agents, offering 225 tools across 32 sections to navigate, extract, clone pages, and bypass antibot systems like Cloudflare.
      1
      -