How do I install Parallel Browser MCP?

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 Parallel Browser MCP need an API key?

The publisher lists these environment variables: BROWSER_MCP_CONFIG, BROWSER_MCP_CONFIG_PATH, BROWSERBASE_API_KEY, BROWSERBASE_PROJECT_ID, ANCHOR_API_KEY, CLOUDFLARE_API_TOKEN, CLOUDFLARE_ACCOUNT_ID, PLAYWRIGHT_USE_CLOAKBROWSER.

What transport does Parallel Browser MCP use?

Parallel Browser MCP runs locally over stdio.

When was Parallel Browser MCP last checked?

Last checked 2026-11-09. MCP server for parallel browser automation across multiple providers.

Parallel Browser MCP server

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 [email protected]

Credentials from the publisher

BROWSER_MCP_CONFIG — Inline JSON configuration for providers and defaults. See README for shape.
BROWSER_MCP_CONFIG_PATH — Path to a JSON file with provider configuration.
BROWSERBASE_API_KEY — Browserbase API key (required when using the browserbase provider).
BROWSERBASE_PROJECT_ID — Browserbase project ID (required when using the browserbase provider, unless set in config).
ANCHOR_API_KEY — Anchor Browser API key (required when using the anchor provider).
CLOUDFLARE_API_TOKEN — Cloudflare API token (required when using the cloudflare provider).
CLOUDFLARE_ACCOUNT_ID — Cloudflare account ID (required when using the cloudflare provider).
PLAYWRIGHT_USE_CLOAKBROWSER — Set to 'true' to launch the local Playwright provider via CloakBrowser (https://cloakbrowser.dev/) stealth Chromium. Requires installing the optional 'cloakbrowser' npm package.

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

shClaude Code

1BROWSER_MCP_CONFIG=<value> BROWSER_MCP_CONFIG_PATH=<value> BROWSERBASE_API_KEY=<secret> BROWSERBASE_PROJECT_ID=<value> ANCHOR_API_KEY=<secret> CLOUDFLARE_API_TOKEN=<secret> CLOUDFLARE_ACCOUNT_ID=<value> PLAYWRIGHT_USE_CLOAKBROWSER=<value> claude mcp add io.github.etairl-parallel-browser-mcp -- npx -y parallel-browser-mcp@0.1.14

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.etairl-parallel-browser-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ],9      "env": {10        "BROWSER_MCP_CONFIG": "<value>",11        "BROWSER_MCP_CONFIG_PATH": "<value>",12        "BROWSERBASE_API_KEY": "<secret>",13        "BROWSERBASE_PROJECT_ID": "<value>",14        "ANCHOR_API_KEY": "<secret>",15        "CLOUDFLARE_API_TOKEN": "<secret>",16        "CLOUDFLARE_ACCOUNT_ID": "<value>",17        "PLAYWRIGHT_USE_CLOAKBROWSER": "<value>"18      }19    }20  }21}

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

Tools

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

FAQ

Questions

parallel-browser-mcp

parallel-browser-mcp is an MCP server for parallel browser automation. It exposes a numeric session model over MCP so one client can create and control multiple browser sessions at the same time across multiple browser providers.

Supported providers:

playwright for local Chromium
browserbase via @browserbasehq/sdk
anchor via anchorbrowser
cloudflare via Cloudflare Browser Run

Each browser session gets a numeric ID like 1, 2, 3, and every browser_* tool accepts a sessionId.

Features

Multiple concurrent browser sessions in memory
Provider abstraction shared across Browserbase, Anchor Browser, Cloudflare Browser Run, and local Playwright
MCP session tools:
- start_session
- close_session
- close_all_sessions
- get_sessions
Browser tools:
- browser_navigate
- browser_go_back
- browser_click
- browser_fill
- browser_fill_form
- browser_screenshot
- browser_snapshot
- browser_hover
- browser_drag
- browser_select_option
- browser_generate_locator
- browser_get_page_structure
- browser_evaluate
- browser_keyboard_press
- browser_keyboard_type
- browser_mouse_move
- browser_mouse_click_xy
- browser_mouse_drag
- browser_upload_file
- browser_wait_for_selector
- browser_wait_for_timeout

Quick Start

corepack pnpm install
corepack pnpm build

Run locally over stdio:

node dist/index.js

Run it as an npm package CLI:

npx parallel-browser-mcp@latest

Configuration

Provider-specific settings are configured at the MCP server configuration level, not per tool call.

The server reads config in this order:

BROWSER_MCP_CONFIG
BROWSER_MCP_CONFIG_PATH
direct env defaults
built-in defaults

Recommended config shape:

{
  "defaultProvider": "playwright",
  "providers": {
    "browserbase": {
      "projectId": "proj_123",
      "keepAlive": true
    },
    "anchor": {
      "recording": false
    },
    "playwright": {
      "launchOptions": {
        "headless": true
      },
      "useCloakBrowser": false
    }
  }
}

Stealth Chromium via CloakBrowser

The playwright provider can optionally launch CloakBrowser instead of vanilla Chromium for sessions that need to bypass bot detection. Enable it per-config or via env:

{
  "providers": {
    "playwright": { "useCloakBrowser": true }
  }
}

PLAYWRIGHT_USE_CLOAKBROWSER=true

cloakbrowser is an optional peer — install it only when you need stealth:

npm install cloakbrowser

The CloakBrowser binary (~200MB stealth Chromium) is downloaded automatically on the first session launch. Existing launchOptions / contextOptions continue to apply, and the rest of the provider behaves identically to standard Playwright.

Required credentials by provider:

playwright: none
browserbase: BROWSERBASE_API_KEY, plus a projectId in config or BROWSERBASE_PROJECT_ID
anchor: ANCHOR_API_KEY
cloudflare: CLOUDFLARE_API_TOKEN, CLOUDFLARE_ACCOUNT_ID

Optional env defaults:

BROWSERBASE_PROJECT_ID
BROWSERBASE_KEEP_ALIVE
BROWSERBASE_CONTEXT_ID
BROWSERBASE_PERSIST
PLAYWRIGHT_STORAGE_STATE_PATH
PLAYWRIGHT_EXECUTABLE_PATH
PLAYWRIGHT_CHANNEL
PLAYWRIGHT_USE_CLOAKBROWSER (true to launch stealth Chromium via CloakBrowser; requires npm install cloakbrowser)

Installation

Use the standard config below in any MCP client that supports stdio:

{
  "mcpServers": {
    "parallel-browser-mcp": {
      "command": "npx",
      "args": ["parallel-browser-mcp@latest"],
      "env": {
        "BROWSER_MCP_CONFIG": "{\"defaultProvider\":\"playwright\",\"providers\":{\"playwright\":{\"launchOptions\":{\"headless\":true}}}}",
        "BROWSERBASE_API_KEY": "your_browserbase_key",
        "ANCHOR_API_KEY": "your_anchor_key"
      }
    }
  }
}

Use the Claude Code CLI to add the server:

claude mcp add parallel-browser-mcp npx parallel-browser-mcp@latest

If you need provider configuration, add the environment variables in your Claude MCP config using the standard config above.

Follow the Claude Desktop MCP install flow and use the standard config above in the local MCP configuration file.

Use the Codex CLI:

codex mcp add parallel-browser-mcp npx "parallel-browser-mcp@latest"

Or add this to ~/.codex/config.toml:

[mcp_servers.parallel-browser-mcp]
command = "npx"
args = ["parallel-browser-mcp@latest"]

Use the Copilot CLI interactive flow:

/mcp add

Or add this to ~/.copilot/mcp-config.json:

{
  "mcpServers": {
    "parallel-browser-mcp": {
      "type": "local",
      "command": "npx",
      "tools": ["*"],
      "args": ["parallel-browser-mcp@latest"],
      "env": {
        "BROWSER_MCP_CONFIG": "{\"defaultProvider\":\"playwright\",\"providers\":{\"playwright\":{\"launchOptions\":{\"headless\":true}}}}",
        "BROWSERBASE_API_KEY": "your_browserbase_key",
        "ANCHOR_API_KEY": "your_anchor_key"
      }
    }
  }
}

Go to Cursor Settings -> MCP -> Add new MCP Server, then use:

command: npx
args: parallel-browser-mcp@latest

Or paste the standard config above into the MCP config editor.

Add the server to .gemini/settings.json:

{
  "mcpServers": {
    "parallel-browser-mcp": {
      "command": "npx",
      "args": ["parallel-browser-mcp@latest"],
      "env": {
        "BROWSER_MCP_CONFIG": "{\"defaultProvider\":\"playwright\",\"providers\":{\"playwright\":{\"launchOptions\":{\"headless\":true}}}}",
        "BROWSERBASE_API_KEY": "your_browserbase_key",
        "ANCHOR_API_KEY": "your_anchor_key"
      }
    }
  }
}

Use the MCP install flow in VS Code with the standard config above, or install with the VS Code CLI:

code --add-mcp '{"name":"parallel-browser-mcp","command":"npx","args":["parallel-browser-mcp@latest"]}'

Example Flow

Call start_session with { "provider": "playwright" }
Read the returned session id
Call browser_navigate with { "sessionId": 1, "url": "https://example.com" }
Call any additional browser_* tool with the same sessionId
Call close_session when done

Development

corepack pnpm install
corepack pnpm typecheck
corepack pnpm test
corepack pnpm test:coverage
corepack pnpm build
corepack pnpm smoke:local

Publishing

This repo is set up to publish as an npm package:

the CLI entrypoint is parallel-browser-mcp
production builds exclude tests and smoke scripts
the published package only includes dist, README.md, and .env.example

Before publishing:

corepack pnpm typecheck
corepack pnpm test
corepack pnpm build
npm pack --dry-run

GitHub Actions publishing:

.github/workflows/publish.yml publishes to npm on GitHub release publication or manual dispatch
set the NPM_TOKEN repository secret before using the publish workflow

Examples

examples/local contains a standalone npm package that connects to parallel-browser-mcp with @langchain/mcp-adapters and runs a LangChain agent against the local Playwright provider.
examples/browserbase contains a standalone npm package that connects LangChain to the published MCP server with Browserbase config and prompts the agent to use browser_screenshot.
examples/anchor contains a standalone npm package that connects LangChain to the published MCP server with Anchor config and prompts the agent to use browser_snapshot.
examples/cloudflare contains a standalone npm package that connects LangChain to the published MCP server with Cloudflare Browser Run config and prompts the agent to use browser_snapshot.
The root .npmignore excludes the full examples directory from npm publishing.

Testing

The repo includes:

unit coverage for config loading, providers, registry behavior, session tools, and representative browser tools
a local Playwright smoke script in src/smoke/localSmoke.ts

Notes

start_session is intentionally small. Provider-specific behavior belongs in MCP configuration, not tool inputs.
The server logs to stderr so stdout stays clean for MCP JSON-RPC traffic.
Browserbase and Anchor Browser are normalized to Playwright page operations after connection, so the browser tools stay provider-agnostic.

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Parallel Browser MCP?

Does Parallel Browser MCP need an API key?

What transport does Parallel Browser MCP use?

When was Parallel Browser MCP last checked?

Documentation

parallel-browser-mcp

Features

Quick Start

Configuration

Stealth Chromium via CloakBrowser

Installation

Example Flow

Development

Publishing

Examples

Testing

Notes