ZennoBrowser MCP Server

ZennoBrowser MCP Server — Antidetect Browser Automation for AI Agents

Control the ZennoBrowser antidetect browser from AI agents. Manage browser profiles, proxies, cookies, threads and browser instances from Claude Desktop, Cursor and VS Code through the Model Context Protocol (MCP).

Quick start · Installation · Tools · Example prompts · Troubleshooting

MCP (Model Context Protocol) server for ZennoBrowser Public API. Exposes browser automation and profile management capabilities to AI agents such as Claude Desktop, Cursor, and VS Code MCP clients.

Why ZennoBrowser MCP Server

• Full Public API coverage. 57 tools for workspaces, profiles, folders, proxies, threads, browser instances, presets, extensions and product info.
• Built for scale. Bulk tools create, update, start and stop many profiles, proxies, threads and browser instances in one call.
• Cookies and fingerprints. Import, export and copy cookies between profiles, and read full fingerprint details of any profile.
• Works with your AI client. Runs as a local stdio server in Claude Desktop, Cursor and VS Code.
• Free to start. ZennoBrowser is available for Windows. Its START plan includes unlimited local profiles and 2 simultaneous browsers.

Quick start

1. Start ZennoBrowser on your computer and get an API token in your personal account on ZennoLab.
2. Add the server to your MCP client using one of the configurations in Installation.
3. Ask your agent, for example: "Create a new profile named "Test Profile", then start a browser instance for it."

Tools such as deleteprofile, bulkdeleteprofile and deleteproxy cannot be undone. Review the agent's actions before approving destructive calls.

Requirements

• Node.js 20+
• ZennoBrowser running locally
• A valid ZennoBrowser API token

Installation

The package is published as @zennolab/zennobrowser-mcp-server. Versions up to 1.0.0 were published as the unscoped zennobrowser-mcp-server, which no longer receives updates — replace it with @zennolab/zennobrowser-mcp-server in your MCP client config.

npx (no install required)

Claude Desktop — edit claudedesktopconfig.json:

{
  "mcpServers": {
    "zennobrowser": {
      "command": "npx",
      "args": ["-y", "@zennolab/zennobrowser-mcp-server@latest"],
      "env": {
        "ZB_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Cursor — add to MCP settings (.cursor/mcp.json or Settings → MCP):

{
  "mcpServers": {
    "zennobrowser": {
      "command": "npx",
      "args": ["-y", "@zennolab/zennobrowser-mcp-server@latest"],
      "env": {
        "ZB_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

VS Code (with GitHub Copilot MCP support) — add to .vscode/mcp.json:

{
  "servers": {
    "zennobrowser": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@zennolab/zennobrowser-mcp-server@latest"],
      "env": {
        "ZB_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Global install

Shortened. The full README is on GitHub.