ZennoBrowser MCP Server

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.

Local serverstdioMIT

What is the ZennoBrowser MCP Server?

zennobrowser-mcp-server is an MCP project maintained in the zennolab/zennobrowser-mcp-server repository. The maintainer describes its purpose as “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…”. Read the project documentation for the complete scope.

Installation

The documented npm package is @zennolab/zennobrowser-mcp-server. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares ZB_API_TOKEN. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-13.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
get_workspacesList accessible workspaces
get_profilesList profiles with filtering and sorting
get_profileGet a single profile with full fingerprint details
create_profileCreate a new profile
bulk_create_profileCreate multiple profiles at once
update_profileUpdate profile settings
delete_profileDelete a profile
bulk_delete_profileDelete multiple profiles
move_profileMove profiles to a folder
recover_profileRecover a profile from an invalid state
force_unlock_profileForce-unlock a cloud-locked profile
import_cookiesImport cookies (JSON or Netscape format)
export_cookiesExport cookies as JSON
copy_cookiesCopy cookies from one profile to another
bulk_update_profile_presetAssign a preset to multiple profiles
bulk_update_profile_proxyUpdate the proxy for multiple profiles
bulk_update_profile_tagsUpdate tags for multiple profiles
cleanup_profileClear profile cache
get_profile_foldersList profile folders
create_profile_folderCreate a profile folder
update_profile_folderRename a profile folder
delete_profile_folderDelete a profile folder
get_proxiesList proxies
create_proxyCreate a proxy
bulk_create_proxyCreate multiple proxies
update_proxyUpdate a proxy
delete_proxyDelete a proxy
bulk_delete_proxyDelete multiple proxies
change_mobile_proxy_ipTrigger IP rotation for a mobile proxy
get_proxy_foldersList proxy folders
create_proxy_folderCreate a proxy folder
update_proxy_folderRename a proxy folder
delete_proxy_folderDelete a proxy folder
get_threadsList threads
create_threadCreate a thread
bulk_create_threadCreate multiple threads
continue_use_threadExtend thread lifetime
bulk_continue_use_threadExtend lifetime of multiple threads
stop_threadStop a thread
bulk_stop_threadStop multiple threads
get_browser_instancesList active browser instances
start_browser_instanceLaunch a browser instance for a profile
bulk_start_browser_instanceLaunch browser instances for multiple profiles
stop_browser_instanceStop a browser instance
bulk_stop_browser_instanceStop multiple browser instances
set_browser_instance_visibilityShow or hide a browser window
get_presetsList presets
create_presetCreate a preset
delete_presetDelete a preset
get_extensionsList extensions
create_extension_from_webAdd an extension from the Chrome Web Store
create_extension_from_fileAdd an extension from a local .crx or .zip file
delete_extensionRemove an extension
get_product_versionGet ZennoBrowser version
get_browser_versionGet browser engine version
get_limitsGet workspace resource limits
get_tariffGet current tariff information

How to install the ZennoBrowser MCP Server

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

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
ZB_API_TOKENDeclared in the maintainer’s client configuration.Yes