cdpfleet Docs GitHub Dashboard

MCP server

cdpfleet-mcp gives an AI assistant a real browser on the fleet through the Model Context Protocol: it picks the browser the site should see, browses through a residential IP (by country) or your own proxy, reads pages as accessibility snapshots, and can hand the browser to a person — to solve a captcha or type a code — through live view. Every session is recorded, so you can watch afterwards what the agent did.

Hosted: nothing to install

Step-by-step for Claude, ChatGPT, Claude Code, Codex and Cursor: MCP setup.

The same tools run at https://cdpfleet.com/mcp (MCP over Streamable HTTP). Your browsers are billed and limited by your plan exactly as from code.

Each MCP connection gets its own browser; one left idle for 30 minutes is closed, which ends its browser session.

Or run it locally

Claude Code:

claude mcp add cdpfleet -e CDPFLEET_API_KEY=your-key -- npx -y cdpfleet-mcp

Claude Desktop, Cursor, Windsurf and other clients — add to the client's MCP configuration (claude_desktop_config.json, .cursor/mcp.json, …):

{
  "mcpServers": {
    "cdpfleet": {
      "command": "npx",
      "args": [
        "-y",
        "cdpfleet-mcp"
      ],
      "env": {
        "CDPFLEET_API_KEY": "your key"
      }
    }
  }
}

Optional: CDPFLEET_PROXY sets the default proxy (your own proxy URL); without it the agent uses the cdpfleet residential proxy, billed per GB from your balance by tier ($5 free credit).

Tools

ToolWhat it does
launch_browserStarts a browser: browser (chrome, edge, brave, opera, whale, yandex, chromium, patchright, camoufox, firefox, webkit), headless (default headful), proxy, country (residential exit), record, and any other launch option.
navigateOpens a URL; returns the status, final URL and title.
snapshotThe page (or one element) as an accessibility snapshot — roles, names, text and links, a fraction of the HTML's size (case).
click, type, press, wait_forAct on the page by CSS selector or by role and name from the snapshot.
screenshotA JPEG of the viewport or the whole page.
evaluateRuns JavaScript in the page and returns the result (data extraction).
live_viewHands the browser to a person: they watch or take control in the dashboard's Sessions page while the agent waits.
close_browserEnds the session; its recording appears under Sessions shortly after.
list_browsers, accountThe browsers and versions on offer; your usage, live sessions and residential balance.

Good to know