# Clearcote Browser

> Clearcote Browser is a freemium MCP server for browser automation. Drive a fingerprint-controlled Chromium from MCP: read, click, fill and capture pages. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $15 a month
- **Platforms:** CLI, Windows, Linux, API
- **Website:** https://clearcotelabs.com
- **Repository:** https://github.com/clearcotelabs/clearcote-browser/tree/HEAD/mcp
- **MCP Registry name:** io.github.clearcotelabs/clearcote-mcp
- **Categories:** browser automation
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [Browser Use](https://ai-powered.com/mcp/browser-use): Browser Use is a freemium MCP server for browser automation.
- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [Oya Browser](https://ai-powered.com/mcp/oya-browser): Oya Browser is a freemium MCP server for browser automation.
- [Mantis](https://ai-powered.com/mcp/mantis-2): Mantis is an open-source MCP server for browser automation.
- [Auto-building agents](https://ai-powered.com/mcp/auto-building-agents): Auto-building agents is a paid MCP server for browser automation.
- [pour](https://ai-powered.com/mcp/pour): pour is an open-source MCP server for developer tools.
- [AgentFarm](https://ai-powered.com/mcp/agentfarm): AgentFarm is a freemium MCP server for browser automation.
- [OpenAdapt: your agent decides, OpenAdapt enters it and checks it saved](https://ai-powered.com/mcp/openadapt-your-agent-decides-openadapt-enters-it-and-checks): OpenAdapt: your agent decides, OpenAdapt enters it and checks it saved is an open-source MCP server for browser automation.

---
Source: https://ai-powered.com/mcp/clearcote-browser
