# ZennoBrowser MCP Server

> ZennoBrowser MCP Server is a freemium MCP server for browser automation. Manage ZennoBrowser antidetect profiles, proxies and threads from an agent. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** Windows, API, CLI
- **Website:** https://zennolab.com/en/products/zennobrowser/
- **Repository:** https://github.com/zennolab/zennobrowser-mcp-server
- **MCP Registry name:** io.github.ZennoLab/zennobrowser
- **Categories:** browser automation
- **Listing updated:** 2026-11-16

## About

ZennoBrowser is an antidetect browser for Windows, and this local server wraps its Public API in 57 tools so an agent can manage it by prompt. The README groups them around workspaces, profiles, folders, proxies, threads, browser instances, presets, extensions and product info.

Bulk tools create, update, start and stop many profiles, proxies, threads and browser instances in one call, and cookies can be imported, exported or copied between profiles. Full fingerprint details of any profile can be read back. The README warns that delete_profile, bulk_delete_profile and delete_proxy cannot be undone, so review those calls before approving.

It runs over stdio with Node.js 20+, needs ZennoBrowser running locally and a `ZB_API_TOKEN` from your ZennoLab account. The API base URL defaults to http://localhost:8160. The README says the START plan includes unlimited local profiles and two simultaneous browsers. Because antidetect tooling can be used to evade site protections, check the terms of any site you automate.

## Features

- **57 API tools:** Covers workspaces, profiles, folders, proxies, threads, instances, presets and extensions.
- **Bulk operations:** Create, update, start or stop many profiles and proxies per call.
- **Cookie handling:** Import, export and copy cookies between profiles.
- **Fingerprint details:** Read the full fingerprint of any profile.
- **Local stdio server:** Runs through npx in Claude Desktop, Cursor or VS Code.

## Good for

- Create and launch a batch of browser profiles
- Assign proxies to profiles in bulk
- Copy cookies from one profile to another
- Audit profile fingerprints

## Install

### Claude Code (Terminal)

```sh
claude mcp add zennobrowser --env ZB_API_TOKEN='<ZB_API_TOKEN>' -- npx -y @zennolab/zennobrowser-mcp-server
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "zennobrowser": {
      "command": "npx",
      "args": [
        "-y",
        "@zennolab/zennobrowser-mcp-server"
      ],
      "env": {
        "ZB_API_TOKEN": "<ZB_API_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "zennobrowser": {
      "command": "npx",
      "args": [
        "-y",
        "@zennolab/zennobrowser-mcp-server"
      ],
      "env": {
        "ZB_API_TOKEN": "<ZB_API_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "zennobrowser": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@zennolab/zennobrowser-mcp-server"
      ],
      "env": {
        "ZB_API_TOKEN": "<ZB_API_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "zennobrowser": {
      "command": "npx",
      "args": [
        "-y",
        "@zennolab/zennobrowser-mcp-server"
      ],
      "env": {
        "ZB_API_TOKEN": "<ZB_API_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "zennobrowser": {
      "command": "npx",
      "args": [
        "-y",
        "@zennolab/zennobrowser-mcp-server"
      ],
      "env": {
        "ZB_API_TOKEN": "<ZB_API_TOKEN>"
      }
    }
  }
}
```

## Tools

- `delete_profile`: Deletes a browser profile; cannot be undone
- `bulk_delete_profile`: Deletes many profiles at once; cannot be undone
- `delete_proxy`: Deletes a proxy; cannot be undone

## FAQ

### What do I need to run it?

Node.js 20+, ZennoBrowser running locally and an API token set as ZB_API_TOKEN.

### Is there a free tier of ZennoBrowser?

The README says the START plan includes unlimited local profiles and 2 simultaneous browsers.

### Which operations are irreversible?

delete_profile, bulk_delete_profile and delete_proxy cannot be undone.

### Which clients are documented?

Claude Desktop, Cursor and VS Code.

### Is ZennoBrowser MCP Server free?

ZennoBrowser MCP Server has a free plan, with paid plans for more usage or features.

### How do I add ZennoBrowser MCP Server to Claude Code?

Run this command in your terminal: claude mcp add zennobrowser --env ZB_API_TOKEN='<ZB_API_TOKEN>' -- npx -y @zennolab/zennobrowser-mcp-server

### What are the best alternatives to ZennoBrowser MCP Server?

The closest alternatives to ZennoBrowser MCP Server are Browser Use, Scrapling MCP Server, Oya Browser, Mantis and Auto-building agents.

## 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.
- [Oya Browser](https://ai-powered.com/mcp/oya-browser): Oya Browser is a freemium MCP server for browser automation.
- [Mantis](https://ai-powered.com/mcp/mantis-2): Mantis is an open-source MCP server for browser automation.
- [Auto-building agents](https://ai-powered.com/mcp/auto-building-agents): Auto-building agents is a paid MCP server for browser automation.
- [pour](https://ai-powered.com/mcp/pour): pour is an open-source MCP server for developer tools.
- [AgentFarm](https://ai-powered.com/mcp/agentfarm): AgentFarm is a freemium MCP server for browser automation.
- [OpenAdapt: your agent decides, OpenAdapt enters it and checks it saved](https://ai-powered.com/mcp/openadapt-your-agent-decides-openadapt-enters-it-and-checks): OpenAdapt: your agent decides, OpenAdapt enters it and checks it saved is an open-source MCP server for browser automation.

---
Source: https://ai-powered.com/mcp/zennobrowser-mcp-server
