browser_click
Perform click on a web page
LABSCO SUMMARY
Playwright MCP calls, on a Chromium that behaves less like a robot.
Because the tool surface is upstream Playwright MCP unchanged, anything already written against it runs here with no edits — what changes sits underneath: CloakBrowser's Chromium, persistent profiles, loaded extensions, humanised input, and a proxy whose GeoIP can be matched to the fingerprint's timezone and locale. One tool is honestly named: browser_run_code_unsafe executes arbitrary JavaScript inside the Playwright server process and is equivalent to remote code execution, so keep it out of any surface you do not fully control.
What it is
A bridge that runs upstream @playwright/mcp as the canonical tool surface and points that runtime at CloakBrowser's Chromium, adding two introspection tools of its own. Anything already written against Playwright MCP keeps working unchanged.
What you get
- The upstream Playwright MCP tools unchanged: navigate and go back, click, hover, type, fill a whole form at once, press keys, select options, drag and drop, upload and drop files, resize, manage tabs, wait for text or time
- An accessibility snapshot as the basis for acting, with screenshots kept for looking rather than for clicking
- That snapshot searched by text or regular expression, returning the matching nodes with surrounding context
- Console messages filtered by level, and a numbered network-request list with full headers and body available for any one of them
- JavaScript evaluated against the page or a specific element, and — labelled unsafe in its own name — an arbitrary Playwright snippet run in the server process
- Dialogs handled, and artifacts written to a configurable output directory
- Persistent Chromium profiles, validated context options (viewport, locale, timezone, permissions, geolocation, headers) and Chrome extension directories loaded
- GeoIP-aware proxy matching, so the fingerprint's timezone and locale line up with the proxy's country
- Humanised mouse, keyboard and scroll behaviour for flows that watch how you interact
- Two local tools reporting the resolved browser binary and the bridge's own runtime metadata
- Session code generated in typescript, python, java or csharp, or turned off
Requirements
Node.js 22.13 or newer in the 22.x line, or Node.js 24 and above. npx -y cloakbrowser-mcp@latest runs it over stdio, and its doctor command checks the environment before you wire a client up. --transport streamable-http with --http-port serves HTTP instead, bound to 127.0.0.1 on port 3000 by default. Docker images are published for linux/amd64 and linux/arm64, write artifacts to /data, and set CLOAK_PLAYWRIGHT_MCP_NO_SANDBOX to true by default because Chromium sandboxing is often unavailable in containers — set it false where your runtime supports it, and keep network access and mounted directories tightly scoped for untrusted pages. PLAYWRIGHT_MCP_BROWSER_ENGINE switches between cloak and plain playwright, PLAYWRIGHT_MCP_HEADLESS defaults to true, and PLAYWRIGHT_MCP_USER_DATA_DIR has to be set before extensions can load.
Setup effort
One command — npx -y cloakbrowser-mcp@latest
USE CASES
01
Automating a site that watches how you type
Drive it through the ordinary Playwright tools with humanised input, acting from the accessibility snapshot rather than a screenshot.
02
Staying signed in between runs
Point it at a persistent Chromium profile directory so cookies and logins survive, and confirm which binary it resolved.
03
Filling a long form in one go
Send every field in a single call instead of one per input, then wait for the confirmation text.
04
Finding out what the page really requests
List the numbered network requests, then open the one that matters with its headers and body.
05
Debugging why a page misbehaves
Read the console messages at the level you want, and evaluate an expression against the element in question.
06
Locating something in a complicated page
Search the accessibility snapshot by text or regex and take the matching nodes with their context.
07
Testing what a user in another country sees
Run behind a proxy with the timezone and locale fingerprint matched to its GeoIP, and check what the bridge resolved.
26 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
browser_close
Close the page
browser_console_messages
Returns all console messages
browser_drag
Perform drag and drop between two elements
browser_drop
Drop files or MIME-typed data onto an element, as if dragged from outside the page. At least one of "paths" or "data" must be provided.
browser_evaluate
Evaluate JavaScript expression on page or element
browser_file_upload
Upload one or multiple files
browser_fill_form
Fill multiple form fields
browser_find
Search the accessibility snapshot of the current page for text or a regular expression. Returns matching snapshot nodes with a few lines of surrounding context (like search snippets), each shown under its path from the root of the tree, which is cheaper than capturing the whole snapshot when you only need to locate an element and its ref.
browser_handle_dialog
Handle a dialog
browser_hover
Hover over element on page
browser_navigate
Navigate to a URL
browser_navigate_back
Go back to the previous page in the history
browser_network_request
Returns full details (headers and body) of a single network request, or a single part if part is set. Use the number from browser_network_requests.
browser_network_requests
Returns a numbered list of network requests since loading the page. Use browser_network_request with the number to get full details.
browser_press_key
Press a key on the keyboard
browser_resize
Resize the browser window
browser_run_code_unsafe
Run a Playwright code snippet. Unsafe: executes arbitrary JavaScript in the Playwright server process and is RCE-equivalent.
browser_select_option
Select an option in a dropdown
browser_snapshot
Capture accessibility snapshot of the current page, this is better than screenshot
browser_tabs
List, create, close, or select a browser tab.
browser_take_screenshot
Take a screenshot of the current page. You can't perform actions based on the screenshot, use browser_snapshot for actions.
browser_type
Type text into editable element
browser_wait_for
Wait for text to appear or disappear or a specified time to pass
cloakbrowser_binary_info
Return CloakBrowser package, cache, platform, and resolved browser binary information.
cloakbrowser_bridge_info
Return runtime metadata for the CloakBrowser bridge over upstream Playwright MCP.
BEFORE YOU INSTALL
What to know first
Tools you get
26 tools when we connected. Only cloakbrowser_binary_info and cloakbrowser_bridge_info are this project's own; the other 24 browser_* tools come from a pinned @playwright/mcp version and can change with it.
Requires
npx on PATH
Where it runs
All 8 documented clients run the server on your machine.
CONTEXT COST
Moderate Standing cost
Rated by the size of the 26 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npx -y cloakbrowser-mcp@latestMCP Clients
Codex
CODEX · TERMINAL
codex mcp add cloakbrowser -- npx -y cloakbrowser-mcp@latestClaude Code
CLAUDE CODE · TERMINAL
claude mcp add --transport stdio cloakbrowser -- npx -y cloakbrowser-mcp@latestGitHub Copilot in VS Code
GITHUB COPILOT IN VS CODE · JSON
{
"servers": {
"cloakbrowser": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"cloakbrowser-mcp@latest"
]
}
}
}Claude Desktop, Cursor, Cline, Windsurf, Warp
JSON
{
"mcpServers": {
"cloakbrowser": {
"command": "npx",
"args": [
"-y",
"cloakbrowser-mcp@latest"
]
}
}
}
