# Cdpilot

> Cdpilot is an open-source MCP server for browser automation. Browser automation over raw CDP in one Python file, with an MCP server for AI agents. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Chrome extension
- **Website:** https://cdpilot.ndr.ist
- **Repository:** https://github.com/mehmetnadir/cdpilot
- **MCP Registry name:** io.github.mehmetnadir/cdpilot
- **Categories:** browser automation, developer tools
- **Listing updated:** 2026-11-14

## About

Everything runs from a single file with no node_modules, and the site compares its install size and dependencies against Playwright, Puppeteer and Selenium using each tool's own metadata. It talks directly to Chrome's DevTools Protocol.

For agents, the a11y-snapshot command returns semantic elements with short @ref handles so the agent acts on text rather than pixels. The site reports its own measurement on four real pages, where snapshots were 1.4 to 42 times smaller than raw HTML, and says a screenshot was smaller on link-heavy pages. It also withdrew an earlier unmeasured claim.

Other features include three-tier stealth, CAPTCHA and press-and-hold solvers, named proxy pools, per-host cookie persistence, session replay with secrets supplied at run time, and HAR export.

## Features

- **Zero npm dependencies:** One file and no node_modules.
- **Accessibility snapshots:** Returns elements with @ref handles for text-only agents.
- **Smart commands:** Click or fill by visible text without CSS selectors.
- **Project isolation:** Each project gets its own browser with separate cookies.
- **Stealth and proxies:** Stealth tiers, proxy pools and CAPTCHA solvers.

## Good for

- Let a coding agent drive a browser without installing Playwright
- Test a checkout flow with isolated sessions
- Record and replay a login with secrets injected
- Capture a masked HAR of a navigation

## Install

### Claude Code (Terminal)

```sh
claude mcp add cdpilot -- npx -y cdpilot
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "cdpilot": {
      "command": "npx",
      "args": [
        "-y",
        "cdpilot"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "cdpilot": {
      "command": "npx",
      "args": [
        "-y",
        "cdpilot"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "cdpilot": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "cdpilot"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "cdpilot": {
      "command": "npx",
      "args": [
        "-y",
        "cdpilot"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "cdpilot": {
      "command": "npx",
      "args": [
        "-y",
        "cdpilot"
      ]
    }
  }
}
```

## FAQ

### Does it need Playwright or Puppeteer?

No. It uses raw CDP and lists no npm dependencies.

### Which clients work?

Claude Code, Cursor, Windsurf and any MCP client.

### How many commands are there?

The site says 70 or more.

### Does it use a vision model?

No. Snapshots are structured text, though annotated screenshots are available.

### Is Cdpilot free?

Yes. Cdpilot is open source, so you can use and self-host it for free.

### How do I add Cdpilot to Claude Code?

Run this command in your terminal: claude mcp add cdpilot -- npx -y cdpilot

### What are the best alternatives to Cdpilot?

The closest alternatives to Cdpilot are REA, Browser Use, Scrapling MCP Server, Codebase Memory and GitHub.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [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.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/cdpilot
