# Clearcote Browser (MCP server)

> Clearcote Browser is an MCP server that adds web browsing tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Drive the Clearcote Chromium browser from any MCP client: read pages, click, fill, screenshot. It has 267 GitHub stars, is released under the BSD-3-Clause license and runs locally with npx -y clearcote-mcp.

Drive the open-source Clearcote stealth Chromium from any MCP client — Claude Desktop, Cursor, Cline, Continue, or your own agent. One shared, coherent stealth browser; ~20 tools to navigate, read, extract, click, fill, screenshot, and persist sessions — plus getcdpendpoint, which hands the same stealth browser to any Playwright / Puppeteer / browser-use / Crawl4AI client.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/clearcotelabs/clearcote-browser |
| GitHub stars | 267 |
| License | BSD-3-Clause |
| Language | Python |
| Transport | stdio |
| Packages | pypi: clearcote-mcp; npm: clearcote-mcp |
| Remote URL | none |
| Needs API key | yes |
| Official | no |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | Web & browsing |
| Latest release | v0.1.0-pre.25 (Oct 28, 2026) |
| Last commit | Nov 13, 2026 |
| MCP registry name | io.github.clearcotelabs/clearcote-mcp |

## Install

### Claude Desktop (claude_desktop_config.json)

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

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --env CLEARCOTE_PROXY=your-value --env CLEARCOTE_API_KEY=your-value --transport stdio clearcote-browser -- npx -y clearcote-mcp
```

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

```json
{
  "mcpServers": {
    "clearcote-browser": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "clearcote-mcp"
      ],
      "env": {
        "CLEARCOTE_PROXY": "your-value",
        "CLEARCOTE_API_KEY": "your-value"
      }
    }
  }
}
```

Project file; use ~/.cursor/mcp.json to enable it in every project.

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

```json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "clearcote_proxy",
      "description": "CLEARCOTE_PROXY",
      "password": true
    },
    {
      "type": "promptString",
      "id": "clearcote_api_key",
      "description": "CLEARCOTE_API_KEY",
      "password": true
    }
  ],
  "servers": {
    "clearcote-browser": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "clearcote-mcp"
      ],
      "env": {
        "CLEARCOTE_PROXY": "${input:clearcote_proxy}",
        "CLEARCOTE_API_KEY": "${input:clearcote_api_key}"
      }
    }
  }
}
```

Config formats checked against the official docs on 2026-10-07.

## Environment variables

- `CLEARCOTE_FINGERPRINT`: Seed for one stable identity (the same seed is the same device on every run)
- `CLEARCOTE_PLATFORM`: Platform persona
- `CLEARCOTE_PROXY` (secret): Proxy for all traffic, http://user:pass@host:port
- `CLEARCOTE_GEOIP`: 1: timezone, locale and WebRTC IP follow the proxy's exit IP
- `CLEARCOTE_CLOUD`: 1: the browser is a hosted Clearcote session (needs CLEARCOTEAPIKEY)
- `CLEARCOTE_API_KEY` (secret): API key for cloud mode and the run_task tool

## Similar MCP servers

- [Pagesift](https://appsgit.com/mcp-servers/pagesift): Self-hosted web scraper, crawler and document parser for AI agents: URLs, PDFs with OCR and Office files to clean Markdown/JSON. (275 stars, Apache-2.0)
- [PyScrappy](https://appsgit.com/mcp-servers/pyscrappy): Web-scraping toolkit with 22 tools for structured web data as JSON for AI agents. (265 stars, MIT)
- [Browsentic](https://appsgit.com/mcp-servers/browsentic): Agentic browser harness: your agent CLI in your real, signed-in browser, from a side panel or MCP. (294 stars, Apache-2.0)
- [reMarkable MCP Server](https://appsgit.com/mcp-servers/remarkable-mcp-server): Read, render, search, and manage reMarkable documents through MCP. (265 stars, MIT)
- [Google Surf MCP](https://appsgit.com/mcp-servers/google-surf-mcp): Web, academic and code search with graph RAG, data lineage, ontology and cross-project schema links. (301 stars, MIT, needs API key)
- [Qaskills](https://appsgit.com/mcp-servers/qaskills): Search, inspect, and install 400+ QA testing skills from qaskills.sh into any MCP client. (248 stars, MIT)

---

Canonical page: https://appsgit.com/mcp-servers/clearcote-browser
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed daily.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.
