ZennoBrowser MCP Server
Manage ZennoBrowser antidetect profiles, proxies and threads from an agent
- 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-serverAdd 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 APIRequiredZB_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

Browser Use
MCP serverBrowser agents and cloud browsers for AI, with an MCP server for web tasks
- 7 tools
- Remote
- Freemium
- 121K GitHub stars
- Browser automation

Scrapling MCP Server
MCP serverMCP 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

Oya Browser
MCP serverHIPAA-oriented agentic browser with replayable playbooks, reachable over MCP
- 32 tools
- Remote
- Freemium
- 349 GitHub stars
- Browser automation
Mantis
MCP serverBrowser MCP server that gives agents numbered text pages instead of screenshots
Runs locally- 1 tool
- Open source
- 5 Hacker News points
- Browser automation

Auto-building agents
MCP serverBuild and continue browser and Mac automation scripts for Super through Claude
- Remote
- Paid
- Browser automation

pour
MCP serverRun WCAG 2.2 accessibility audits and vision simulations on any URL from an agent
Runs locally- Open source
- Developer tools