Clearcote Browser — Claude Code MCP server: what it does
The Clearcote Browser MCP server for Claude Code controls a Chromium browser to read pages, click elements, and fill fields. It runs on browser tasks sent through an agent chat.
BSD-3-Clause ★ 273 updated 2026-11-13
claude mcp add --env CLEARCOTE_FINGERPRINT=<CLEARCOTE_FINGERPRINT> --env CLEARCOTE_PLATFORM=<CLEARCOTE_PLATFORM> --env CLEARCOTE_PROXY=<CLEARCOTE_PROXY> --env CLEARCOTE_GEOIP=<CLEARCOTE_GEOIP> --env CLEARCOTE_CLOUD=<CLEARCOTE_CLOUD> --transport stdio mcp -- npx -y clearcote-mcpWhat Clearcote Browser does
Clearcote Browser controls Chromium through MCP. It can open pages, return text or HTML, interact with page elements, fill forms, and capture screenshots. It also saves browser profiles with cookies and storage; get_cdp_endpoint lets other CDP clients attach to the same session.
Running it with npx requires Node.js. On first use, it downloads a Clearcote binary for Windows x64 or Linux x64. The Python option installs with pip install clearcote-mcp. By default, the server rejects private addresses and URL schemes other than http and https.
CLEARCOTE_API_KEY is required for cloud mode and the run_task tool; cloud mode also needs CLEARCOTE_CLOUD=1. A local setup can route traffic through CLEARCOTE_PROXY, while CLEARCOTE_GEOIP=1 derives timezone and language settings from the proxy IP.
What it helps with
- read the contents of a web page
- click a page element or fill a form field
- save a page screenshot or PDF
- connect another CDP client to the browser session
Example prompts for the agent
- Read this page and return its contents as Markdown.
- Find the sign-in button and click it.
- Save the current page as a PDF.
How to install Clearcote Browser
Platform CLI
claude mcp add --env CLEARCOTE_FINGERPRINT=<CLEARCOTE_FINGERPRINT> --env CLEARCOTE_PLATFORM=<CLEARCOTE_PLATFORM> --env CLEARCOTE_PROXY=<CLEARCOTE_PROXY> --env CLEARCOTE_GEOIP=<CLEARCOTE_GEOIP> --env CLEARCOTE_CLOUD=<CLEARCOTE_CLOUD> --transport stdio mcp -- npx -y clearcote-mcpReplace <…> with your own values. 1 more environment variable is in the server README
Platform CLI
codex mcp add mcp --env CLEARCOTE_FINGERPRINT=<CLEARCOTE_FINGERPRINT> --env CLEARCOTE_PLATFORM=<CLEARCOTE_PLATFORM> --env CLEARCOTE_PROXY=<CLEARCOTE_PROXY> --env CLEARCOTE_GEOIP=<CLEARCOTE_GEOIP> --env CLEARCOTE_CLOUD=<CLEARCOTE_CLOUD> -- npx -y clearcote-mcpReplace <…> with your own values. 1 more environment variable is in the server README
Config file
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"clearcote-mcp"
],
"env": {
"CLEARCOTE_FINGERPRINT": "<CLEARCOTE_FINGERPRINT>",
"CLEARCOTE_PLATFORM": "<CLEARCOTE_PLATFORM>",
"CLEARCOTE_PROXY": "<CLEARCOTE_PROXY>",
"CLEARCOTE_GEOIP": "<CLEARCOTE_GEOIP>",
"CLEARCOTE_CLOUD": "<CLEARCOTE_CLOUD>"
}
}
}
}Replace <…> with your own values. 1 more environment variable is in the server README
Config file
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"clearcote-mcp"
],
"env": {
"CLEARCOTE_FINGERPRINT": "<CLEARCOTE_FINGERPRINT>",
"CLEARCOTE_PLATFORM": "<CLEARCOTE_PLATFORM>",
"CLEARCOTE_PROXY": "<CLEARCOTE_PROXY>",
"CLEARCOTE_GEOIP": "<CLEARCOTE_GEOIP>",
"CLEARCOTE_CLOUD": "<CLEARCOTE_CLOUD>"
}
}
}
}Replace <…> with your own values. 1 more environment variable is in the server README
Platform CLI
gemini mcp add -e CLEARCOTE_FINGERPRINT=<CLEARCOTE_FINGERPRINT> -e CLEARCOTE_PLATFORM=<CLEARCOTE_PLATFORM> -e CLEARCOTE_PROXY=<CLEARCOTE_PROXY> -e CLEARCOTE_GEOIP=<CLEARCOTE_GEOIP> -e CLEARCOTE_CLOUD=<CLEARCOTE_CLOUD> mcp npx -y clearcote-mcpReplace <…> with your own values. 1 more environment variable is in the server README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Clearcote Browser
How do I install Clearcote Browser in Claude Code?
Run: claude mcp add clearcote-mcp -e CLEARCOTE_PROXY=<CLEARCOTE_PROXY> -e CLEARCOTE_API_KEY=<CLEARCOTE_API_KEY> -- npx -y clearcote-mcp.
What does Clearcote Browser do?
It controls Chromium through an MCP client. The server can read pages, interact with elements, fill fields, and save screenshots or PDFs.
What does Clearcote Browser require?
The npx launcher needs Node.js. CLEARCOTE_API_KEY is required for cloud mode and run_task; cloud mode also requires CLEARCOTE_CLOUD=1.