Skip to content
MCP server

Clearcote Browser

Drive a fingerprint-controlled Chromium from MCP: read, click, fill and capture pages

Runs locallyStatus and history
Pricing
Freemium
Platforms
CLI, Windows, Linux
Runs
Locally
Version
0.3.1
Listing updated
3 days ago

About Clearcote Browser

Clearcote Browser is a freemium MCP server for browser automation. It runs locally on your machine and is started by your AI client.

The browser behind this server is a de-Googled Chromium build in which identity values such as canvas, WebGL, audio, fonts and hardware are set in Chromium's own C++ rather than by injected page scripts. A seed gives a stable device: the same seed is the same machine on every run, and a different seed is unrelated. Environment variables choose the platform persona (Windows, Linux, macOS or Android), the browser brand, a proxy, and whether timezone, locale and WebRTC address follow the proxy's exit IP.

The stdio server, started with npx or pip, offers around twenty tools for reading pages as Markdown, listing interactive elements, clicking, filling fields, taking screenshots or PDFs, and saving or loading cookie-and-storage profiles. It also has get_cdp_endpoint, which gives the same browser to Playwright, Puppeteer, browser-use or Crawl4AI clients. Driving over CDP adds no automation flags, so navigator.webdriver stays false.

The binary is downloaded and SHA-256 verified on first use, with native Windows and Linux x64 builds. A hosted mode runs the session on Clearcote's servers and needs an API key, which also enables a run_task tool. Local file writes can be sandboxed to a chosen directory.

Install

Run in a terminal

claude mcp add clearcote-mcp --env CLEARCOTE_PROXY='<CLEARCOTE_PROXY>' --env CLEARCOTE_API_KEY='<CLEARCOTE_API_KEY>' -- npx -y clearcote-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "clearcote-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "clearcote-mcp"
      ],
      "env": {
        "CLEARCOTE_PROXY": "<CLEARCOTE_PROXY>",
        "CLEARCOTE_API_KEY": "<CLEARCOTE_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "clearcote-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "clearcote-mcp"
      ],
      "env": {
        "CLEARCOTE_PROXY": "<CLEARCOTE_PROXY>",
        "CLEARCOTE_API_KEY": "<CLEARCOTE_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "clearcote-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "clearcote-mcp"
      ],
      "env": {
        "CLEARCOTE_PROXY": "<CLEARCOTE_PROXY>",
        "CLEARCOTE_API_KEY": "<CLEARCOTE_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "clearcote-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "clearcote-mcp"
      ],
      "env": {
        "CLEARCOTE_PROXY": "<CLEARCOTE_PROXY>",
        "CLEARCOTE_API_KEY": "<CLEARCOTE_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "clearcote-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "clearcote-mcp"
      ],
      "env": {
        "CLEARCOTE_PROXY": "<CLEARCOTE_PROXY>",
        "CLEARCOTE_API_KEY": "<CLEARCOTE_API_KEY>"
      }
    }
  }
}

Configuration

  • CLEARCOTE_FINGERPRINTSeed for one stable identity (the same seed is the same device on every run)
  • CLEARCOTE_PLATFORMPlatform persona
  • CLEARCOTE_PROXYProxy for all traffic, http://user:pass@host:port
  • CLEARCOTE_GEOIP1: timezone, locale and WebRTC IP follow the proxy's exit IP
  • CLEARCOTE_CLOUD1: the browser is a hosted Clearcote session (needs CLEARCOTE_API_KEY)
  • CLEARCOTE_API_KEYAPI key for cloud mode and the run_task tool
  • CLEARCOTE_FINGERPRINTSeed for one stable identity (the same seed is the same device on every run)
  • CLEARCOTE_PLATFORMPlatform persona
  • CLEARCOTE_PROXYProxy for all traffic, http://user:pass@host:port
  • CLEARCOTE_GEOIP1: timezone, locale and WebRTC IP follow the proxy's exit IP
  • CLEARCOTE_CLOUD1: the browser is a hosted Clearcote session (needs CLEARCOTE_API_KEY)
  • CLEARCOTE_API_KEYAPI key for cloud mode and the run_task tool

Tools this server provides (20)

Taken from the project documentation; the running server may differ.

read_page
Reads a page as Markdown, text or both.
get_page_html
Returns the page HTML.
page_elements
Lists interactive elements and their selectors.
evaluate_js
Runs JavaScript in the page.
wait_for
Waits for a condition on the page.
current_page
Returns the current page.
get_cookies
Returns cookies.
list_tabs
Lists open tabs.
navigate
Opens a URL and returns http_status and page_state.
click
Clicks by selector or visible text.
fill_field
Fills a field by selector, label, placeholder or name.
press_key
Presses a key.
new_tab
Opens a tab.
close_tab
Closes a tab.
screenshot_page
Saves a screenshot, returning small ones inline.
save_page_pdf
Saves the page as a PDF.
save_profile
Saves cookies and storage.
load_profile
Loads saved cookies and storage.
get_egress_info
Returns the public IP and active persona.
get_cdp_endpoint
Returns a CDP endpoint so other clients can attach to the same browser.

What it does

Engine-level fingerprint
Identity values are set inside Chromium's C++ so the main thread, workers and iframes agree.
Seeded personas
One seed gives one stable device; platform and browser brand are chosen by environment variable.
Read and act tools
Read pages as Markdown, click by selector or visible text, fill fields and press keys.
Profiles and capture
Save and load cookies and storage, take screenshots and save PDFs.
CDP hand-off
get_cdp_endpoint lets other CDP clients attach to the same browser.
Hosted option
CLEARCOTE_CLOUD runs the browser as a hosted session with a residential IP.
Hardening settings
Tool timeouts, a write sandbox directory and private-network egress limits are configurable.

Good for

  • Let an agent browse and fill forms with a consistent per-account identity
  • Extract page content as Markdown for an assistant to reason over
  • Attach Playwright or Puppeteer to the same browser an agent is driving
  • Test how your own site responds to different device personas
  • Check what a browser reveals about itself

Pricing

Freemium, from $15 a month

Free for one browser; Personal $15/mo, Pro $49/mo; hosted €1 per GB

Prices change. Check clearcotelabs.com before you buy.

Clearcote Browser FAQ

How do I run it?

Start it with npx clearcote-mcp or pip install clearcote-mcp; it runs as a stdio server and downloads a verified Clearcote binary on first use.

Does it cost anything?

The free key allows one browser at a time; Personal is $15 a month for up to 15, and Pro is $49 a month for up to 250. Hosted use is €1 per GB with proxy included.

Which platforms does the binary support?

The README names native Windows x64 and Linux x64 builds.

How is the identity set?

Through environment variables such as CLEARCOTE_FINGERPRINT, CLEARCOTE_PLATFORM and CLEARCOTE_PROXY.

Is Clearcote Browser free?

Clearcote Browser has a free plan, with paid plans for more usage or features. Paid plans start at $15 a month.

How do I add Clearcote Browser to Claude Code?

Run this command in your terminal: claude mcp add clearcote-mcp --env CLEARCOTE_PROXY='<CLEARCOTE_PROXY>' --env CLEARCOTE_API_KEY='<CLEARCOTE_API_KEY>' -- npx -y clearcote-mcp

What are the best alternatives to Clearcote Browser?

The closest alternatives to Clearcote Browser are Browser Use, Scrapling MCP Server, Oya Browser, Mantis and Auto-building agents.

Alternatives to Clearcote Browser

  1. Browser Use

    MCP server

    Browser agents and cloud browsers for AI, with an MCP server for web tasks

    • 7 tools
    • Remote
    • Freemium
    • 121K GitHub stars
    • Browser automation
  2. MCP server for AI clients to scrape sites with HTTP and stealth browser sessions

    Runs locally
    • 17 tools
    • Open source
    • 104K GitHub stars
    • Web search and scraping
  3. Oya Browser

    MCP server

    HIPAA-oriented agentic browser with replayable playbooks, reachable over MCP

    • 32 tools
    • Remote
    • Freemium
    • 349 GitHub stars
    • Browser automation
  4. Mantis

    MCP server

    Browser MCP server that gives agents numbered text pages instead of screenshots

    Runs locally
    • 1 tool
    • Open source
    • 5 Hacker News points
    • Browser automation
  5. Build and continue browser and Mac automation scripts for Super through Claude

    • Remote
    • Paid
    • Browser automation
  6. pour

    MCP server

    Run WCAG 2.2 accessibility audits and vision simulations on any URL from an agent

    Runs locally
    • Open source
    • Developer tools