# Cat Burglar

> Cat Burglar is a free MCP server for browser automation. Browser MCP with three engines, proxy pools, remote CDP and change-only page observations. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, self-hosted, macOS, Linux, Windows
- **Repository:** https://github.com/drmkdaddy/cat-burglar
- **MCP Registry name:** io.github.DrMkdaddy/cat-burglar
- **Categories:** [browser automation](https://ai-powered.com/categories/browser-automation), [web search and scraping](https://ai-powered.com/categories/web-search-and-scraping)
- **Listing updated:** 2026-11-18

## About

Most browser servers resend the whole page after every click. Cat Burglar returns stable element references and a bounded diff of what changed, which the README says cut observation text by 29.9% and calls by 15% at the same success rate on its 12-task local suite.

One session can run on one of three engines: patchright (patched stealth Chromium for protected sites and logins), stock chromium (devtools, traces, PDF, local app testing) or obscura, a roughly 43 MB Rust engine for low-memory reads. It can also attach to Browserbase, Steel, Browserless or any Chrome DevTools Protocol endpoint, and route traffic through HTTP, HTTPS or SOCKS5 proxy pools with sticky or rotating sessions.

Guardrails are on by default: SSRF protection, origin lists, untrusted-content markers and a confirmation gate for destructive actions. When a CAPTCHA appears, the agent opens a window and waits for a person to solve it. Per-site memory shortens repeated tasks. It installs with a script, Docker or pnpm and runs over stdio.

## Features

- **Three engines:** Switch between stealth Chromium, stock Chromium and a 43 MB Rust engine.
- **Diff observations:** Returns only what changed after an action.
- **Proxy pools:** HTTP, HTTPS and SOCKS5 with auth, rotation and geo matching.
- **Remote browsers:** Attaches over CDP to cloud providers or a local Chrome.
- **Human CAPTCHA handoff:** Pauses so a person can finish the challenge.
- **DevTools capture:** HAR, CPU profiles, heap snapshots and coverage on demand.
- **Safety gates:** SSRF guard, origin lists and confirmation for risky actions.

## Good for

- Read and fill forms on a staging site and report what changed
- Run an agent on a logged-in Chrome session
- Test a local app and collect console errors
- Capture a performance trace and summarise slow scripts
- Run high-volume page reads on a small footprint

## Install

### Claude Code (Terminal)

```sh
claude mcp add cat-burglar --env BROWSER_MCP_CDP_URL='<BROWSER_MCP_CDP_URL>' -- docker run -i --rm -e BROWSER_MCP_CDP_URL ghcr.io/drmkdaddy/cat-burglar:v0.5.2
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "cat-burglar": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "BROWSER_MCP_CDP_URL",
        "ghcr.io/drmkdaddy/cat-burglar:v0.5.2"
      ],
      "env": {
        "BROWSER_MCP_CDP_URL": "<BROWSER_MCP_CDP_URL>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "cat-burglar": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "BROWSER_MCP_CDP_URL",
        "ghcr.io/drmkdaddy/cat-burglar:v0.5.2"
      ],
      "env": {
        "BROWSER_MCP_CDP_URL": "<BROWSER_MCP_CDP_URL>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "cat-burglar": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "BROWSER_MCP_CDP_URL",
        "ghcr.io/drmkdaddy/cat-burglar:v0.5.2"
      ],
      "env": {
        "BROWSER_MCP_CDP_URL": "<BROWSER_MCP_CDP_URL>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "cat-burglar": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "BROWSER_MCP_CDP_URL",
        "ghcr.io/drmkdaddy/cat-burglar:v0.5.2"
      ],
      "env": {
        "BROWSER_MCP_CDP_URL": "<BROWSER_MCP_CDP_URL>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "cat-burglar": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "BROWSER_MCP_CDP_URL",
        "ghcr.io/drmkdaddy/cat-burglar:v0.5.2"
      ],
      "env": {
        "BROWSER_MCP_CDP_URL": "<BROWSER_MCP_CDP_URL>"
      }
    }
  }
}
```

## FAQ

### Which clients does it work with?

Claude Desktop, Claude Code, Cursor, Codex, Gemini CLI, VS Code, Windsurf, Cline, OpenCode and any stdio client.

### How do I install it?

Run the install script, use the Docker image ghcr.io/drmkdaddy/cat-burglar, or install the pnpm package.

### Can it reach localhost?

Only if you set BROWSER_MCP_ALLOW_PRIVATE_NETWORK=1.

### What happens at a CAPTCHA?

It opens the page in a browser window and waits for a person.

### Is Cat Burglar free?

Yes. Cat Burglar is free to use.

### How do I add Cat Burglar to Claude Code?

Run this command in your terminal: claude mcp add cat-burglar --env BROWSER_MCP_CDP_URL='<BROWSER_MCP_CDP_URL>' -- docker run -i --rm -e BROWSER_MCP_CDP_URL ghcr.io/drmkdaddy/cat-burglar:v0.5.2

### What are the best alternatives to Cat Burglar?

The closest alternatives to Cat Burglar are Browser Use, Scrapling MCP Server, Chrome DevTools MCP, Firecrawl MCP Server and Douyin_TikTok_Download_API.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## 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.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Firecrawl MCP Server](https://ai-powered.com/mcp/firecrawl-mcp-server): Firecrawl MCP Server is a freemium MCP server for web search and scraping.
- [Douyin_TikTok_Download_API](https://ai-powered.com/mcp/douyin-tiktok-download-api): Douyin_TikTok_Download_API is an open-source MCP server for web search and scraping.
- [SearXNG Search](https://ai-powered.com/mcp/searxng-search): SearXNG Search 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.
- [playwright_mcp](https://ai-powered.com/mcp/playwright-mcp-3): playwright_mcp is an open-source MCP server for browser automation.

---
Source: https://ai-powered.com/mcp/cat-burglar
