CloakBrowser MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@CloakBrowser MCP Server can you navigate to example.com and take a screenshot?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
CloakBrowser MCP Server
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 detectionHuman-like behavior —
humanize=Trueenables Bézier mouse curves, per-character keyboard timingProxy 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-inbrowser_*tools
Related MCP server: CloakMCP
Quick Start
Install
pip install mcp-cloakbrowserRun
# As a stdio MCP server
mcp-cloakbrowser
# Or directly
python -m cloakbrowser_mcp.serverUse with Hermes Agent
Add to ~/.hermes/config.yaml:
mcp_servers:
cloakbrowser:
command: "python"
args: ["-m", "cloakbrowser_mcp.server"]
timeout: 120Restart 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 |
| Launch a stealth CloakBrowser instance |
| Close the browser and clean up |
| Navigate to a URL, return compact snapshot |
| Get accessibility tree with ref IDs |
| Click element by ref (e.g. |
| Type text into input field by ref |
| Press keyboard key (Enter, Tab, Escape...) |
| Scroll page up/down |
| Navigate back in history |
| Navigate forward in history |
| Get console logs or evaluate JS |
| List all images with URLs and alt text |
| Take PNG screenshot |
| Wait for element or text to appear |
| Evaluate JavaScript expression |
| Get text/HTML of page or element |
| Extract all links as JSON |
| Fill multiple form fields at once |
| Hover over element by ref |
| Select options in |
| Drag element to another element |
| Save cookies/localStorage to file |
| Load cookies/localStorage from file |
| 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 toolscloak_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_extract_linksA
Extract all links from the current page as JSON.
Inputs: no named parameters.
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_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
Scored across 24 tools
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).
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.
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.
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
Related MCP Connectors
Browser automation MCP for whole web tasks in a cloud browser: saved logins, bot checks, replays.
Undetectable cloud browser sessions for AI agents and scrapers. Navigate, extract, click, captcha.
Stealth web browser for agents: search, fetch, click, download and type in persistent MCP sessions.
Browser agents and stealth cloud browsers for AI: run web tasks, fill forms, extract data.
Related MCP Servers
- AlicenseBqualityBmaintenanceAnti-detection browser automation MCP server. 18 tools wrapping CamoFox REST API with stealth fingerprinting that passes bot detection.47581 npm127MIT
- AlicenseAqualityCmaintenanceAn 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.2040 PyPI14Apache 2.0
- AlicenseBqualityBmaintenanceA 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.1331,059 npm23MIT
- -licenseNot gradedqualityNot gradedmaintenanceUndetectable 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-