Skip to content
MCP server

ZennoBrowser MCP Server

Manage ZennoBrowser antidetect profiles, proxies and threads from an agent

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
Windows, API, CLI
Runs
Locally
Version
1.1.2
Listing updated
1 day ago

About ZennoBrowser MCP Server

ZennoBrowser MCP Server is a freemium MCP server for browser automation. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • ZB_API_TOKENAuthentication token for the ZennoBrowser Public APIRequired
  • ZB_API_BASE_URLBase URL of the ZennoBrowser Public API

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Freemium

START plan listed as free with limits; paid plans not detailed

Prices change. Check zennolab.com before you buy.

ZennoBrowser MCP Server 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 to ZennoBrowser MCP Server

  1. Browser Use

    MCP server

    Browser agents and cloud browsers for AI, with an MCP server for web tasks

    • 7 tools
    • Remote
    • Freemium
    • 121K GitHub stars
    • Browser automation
  2. MCP server for AI clients to scrape sites with HTTP and stealth browser sessions

    Runs locally
    • 17 tools
    • Open source
    • 104K GitHub stars
    • Web search and scraping
  3. Oya Browser

    MCP server

    HIPAA-oriented agentic browser with replayable playbooks, reachable over MCP

    • 32 tools
    • Remote
    • Freemium
    • 349 GitHub stars
    • Browser automation
  4. Mantis

    MCP server

    Browser MCP server that gives agents numbered text pages instead of screenshots

    Runs locally
    • 1 tool
    • Open source
    • 5 Hacker News points
    • Browser automation
  5. Build and continue browser and Mac automation scripts for Super through Claude

    • Remote
    • Paid
    • Browser automation
  6. pour

    MCP server

    Run WCAG 2.2 accessibility audits and vision simulations on any URL from an agent

    Runs locally
    • Open source
    • Developer tools