@zennolab/zennobrowser

GitHub Actions

MCP server for ZennoBrowser antidetect browser: manage browser profiles, proxies, cookies, threads and browser instances through the Public API from AI agents

Devops Developer Tools

Add to Cursor Add to VS Code Run on PlugMCP

GitHub npm Website

Add to Cursor Add to VS Code Run on PlugMCP

1{2  "mcpServers": {3    "zennolab-zennobrowser-mcp-server": {4      "command": "npx",5      "args": [6        "-y",7        "@zennolab/[email protected]"8      ]9    }10  }11}

.cursor/mcp.jsonMCP server

Transport: stdio
Status: Local

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y @zennolab/[email protected]

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1claude mcp add zennolab-zennobrowser-mcp-server -- npx -y @zennolab/zennobrowser-mcp-server@1.2.0

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "zennolab-zennobrowser-mcp-server": {4      "command": "npx",5      "args": [6        "-y",7        "@zennolab/[email protected]"8      ]9    }10  }11}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 1.2.0
Last checked: 2026-10-28

Stars: —
Tools: —
Uptime: —

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

How do I install @zennolab/zennobrowser?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does @zennolab/zennobrowser need an API key?

No required environment variable is listed on this record.

What transport does @zennolab/zennobrowser use?

@zennolab/zennobrowser runs locally over stdio.

When was @zennolab/zennobrowser last checked?

Last checked 2026-10-28. MCP server for ZennoBrowser antidetect browser: manage browser profiles, proxies, cookies, threads and browser instances through the Public API from AI agents

From the publisher

Documentation

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

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

Tools such as delete_profile, bulk_delete_profile and delete_proxy 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 claude_desktop_config.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

npm install -g @zennolab/zennobrowser-mcp-server@latest

Then use zennobrowser-mcp-server as the command instead of npx ... @zennolab/zennobrowser-mcp-server:

{
  "mcpServers": {
    "zennobrowser": {
      "command": "zennobrowser-mcp-server",
      "env": {
        "ZB_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Environment Variables

Variable	Required	Default	Description
`ZB_API_TOKEN`	Yes	—	Authentication token for the ZennoBrowser Public API
`ZB_API_BASE_URL`	No	`http://localhost:8160`	Base URL of the ZennoBrowser Public API

Tools

Workspaces

Tool	Description
`get_workspaces`	List accessible workspaces

Profiles

Tool	Description
`get_profiles`	List profiles with filtering and sorting
`get_profile`	Get a single profile with full fingerprint details
`create_profile`	Create a new profile
`bulk_create_profile`	Create multiple profiles at once
`update_profile`	Update profile settings
`delete_profile`	Delete a profile
`bulk_delete_profile`	Delete multiple profiles
`move_profile`	Move profiles to a folder
`recover_profile`	Recover a profile from an invalid state
`force_unlock_profile`	Force-unlock a cloud-locked profile
`import_cookies`	Import cookies (JSON or Netscape format)
`export_cookies`	Export cookies as JSON
`copy_cookies`	Copy cookies from one profile to another
`bulk_update_profile_preset`	Assign a preset to multiple profiles
`bulk_update_profile_proxy`	Update the proxy for multiple profiles
`bulk_update_profile_tags`	Update tags for multiple profiles
`cleanup_profile`	Clear profile cache

Profile Folders

Tool	Description
`get_profile_folders`	List profile folders
`create_profile_folder`	Create a profile folder
`update_profile_folder`	Rename a profile folder
`delete_profile_folder`	Delete a profile folder

Proxies

Tool	Description
`get_proxies`	List proxies
`create_proxy`	Create a proxy
`bulk_create_proxy`	Create multiple proxies
`update_proxy`	Update a proxy
`delete_proxy`	Delete a proxy
`bulk_delete_proxy`	Delete multiple proxies
`change_mobile_proxy_ip`	Trigger IP rotation for a mobile proxy

Proxy Folders

Tool	Description
`get_proxy_folders`	List proxy folders
`create_proxy_folder`	Create a proxy folder
`update_proxy_folder`	Rename a proxy folder
`delete_proxy_folder`	Delete a proxy folder

Threads

Tool	Description
`get_threads`	List threads
`create_thread`	Create a thread
`bulk_create_thread`	Create multiple threads
`continue_use_thread`	Extend thread lifetime
`bulk_continue_use_thread`	Extend lifetime of multiple threads
`stop_thread`	Stop a thread
`bulk_stop_thread`	Stop multiple threads

Browser Instances

Tool	Description
`get_browser_instances`	List active browser instances
`start_browser_instance`	Launch a browser instance for a profile
`bulk_start_browser_instance`	Launch browser instances for multiple profiles
`stop_browser_instance`	Stop a browser instance
`bulk_stop_browser_instance`	Stop multiple browser instances
`set_browser_instance_visibility`	Show or hide a browser window

Presets & Extensions

Tool	Description
`get_presets`	List presets
`create_preset`	Create a preset
`delete_preset`	Delete a preset
`get_extensions`	List extensions
`create_extension_from_web`	Add an extension from the Chrome Web Store
`create_extension_from_file`	Add an extension from a local .crx or .zip file
`delete_extension`	Remove an extension

Product

Tool	Description
`get_product_version`	Get ZennoBrowser version
`get_browser_version`	Get browser engine version
`get_limits`	Get workspace resource limits
`get_tariff`	Get current tariff information

Example Prompts

Create a profile and start the browser:

Create a new profile named "Test Profile", then start a browser instance for it.

Full end-to-end flow:

Create a profile named "Scraper", create a proxy with URI "socks5://user:[email protected]:1080", assign the proxy to the profile, create a thread, then start a browser instance for the profile using that thread.

Bulk operations:

List all profiles in my default workspace and delete any that haven't been used in the last 30 days.

Cookie management:

Export cookies from profile "Session A" and import them into profile "Session B".

Troubleshooting

Error: Missing required environment variable ZB_API_TOKEN Set the ZB_API_TOKEN environment variable to your ZennoBrowser API token.

Error: connect ECONNREFUSED 127.0.0.1:8160 ZennoBrowser is not running or the Public API is not working. If the API runs on a different port, set ZB_API_BASE_URL=http://localhost:<port>.

Tool calls return errors with "Unauthenticated" Your API token is invalid or expired. Generate a new token in personal account on ZennoLab.

npx downloads the package every time Install globally with npm install -g @zennolab/zennobrowser-mcp-server@latest to avoid re-downloading on each start.

ZennoBrowser — the antidetect browser this server controls
ZennoLab documentation — product guides (in Russian)
ZennoBrowser community forum — questions, bug reports and feature requests
zennoposter-mcp — MCP servers for ZennoPoster and ZennoDroid

License

MIT

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install @zennolab/zennobrowser?

Does @zennolab/zennobrowser need an API key?

What transport does @zennolab/zennobrowser use?

When was @zennolab/zennobrowser last checked?

Documentation

ZennoBrowser MCP Server — Antidetect Browser Automation for AI Agents

Why ZennoBrowser MCP Server

Quick start

Requirements

Installation

npx (no install required)

Global install

Environment Variables

Tools

Workspaces

Profiles

Profile Folders

Proxies

Proxy Folders

Threads

Browser Instances

Presets & Extensions

Product

Example Prompts

Troubleshooting

Related

License

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install @zennolab/zennobrowser?

Does @zennolab/zennobrowser need an API key?

What transport does @zennolab/zennobrowser use?

When was @zennolab/zennobrowser last checked?

Documentation

ZennoBrowser MCP Server — Antidetect Browser Automation for AI Agents

Why ZennoBrowser MCP Server

Quick start

Requirements

Installation

npx (no install required)

Global install

Environment Variables

Tools

Workspaces

Profiles

Profile Folders

Proxies

Proxy Folders

Threads

Browser Instances

Presets & Extensions

Product

Example Prompts

Troubleshooting

Related

License