How do I install Browse Bridge?

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

Does Browse Bridge need an API key?

No required environment variable is listed on this record.

What transport does Browse Bridge use?

Browse Bridge is reached over HTTP.

When was Browse Bridge last checked?

Last checked 2026-11-08. Let AI agents observe and control Chrome tabs you explicitly share via Browse Bridge.

Browse Bridge MCP server

Power your agent

Add this server

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

Add to Cursor Add in Claude Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Server URL

https://mcp.browsebridge.com/mcp

The Claude button above opens Claude with the name and URL filled in. You still confirm it there.

shClaude Code

1claude mcp add --transport http com.browsebridge-browse-bridge https://mcp.browsebridge.com/mcp

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "com.browsebridge-browse-bridge": {4      "command": "npx",5      "args": [6        "-y",7        "mcp-remote",8        "https://mcp.browsebridge.com/mcp"9      ]10    }11  }12}

claude_desktop_config.json

Remote · HTTPPublisher 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

Remote

Transport: http
Version: 1.0.0
Last checked

Tools

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

FAQ

Questions

Browse Bridge for Cursor

Cursor Plugin that wires Browse Bridge remote MCP into Cursor so agents can observe and control browser tabs you have Explicitly Enabled in the Chrome extension.

MCP: https://mcp.browsebridge.com/mcp
Site: https://browsebridge.com
Chrome extension: listed on the Chrome Web Store
License: MIT

Prerequisites

Create an account at https://browsebridge.com/sign-up (plans: https://browsebridge.com/plans).
Install the Browse Bridge Chrome extension from the Chrome Web Store and sign in with the same account.
Sign in and open Connections to create an API key (starts with bbk_). Keep it secret.
Cursor with plugin/MCP support.

Install (Marketplace / local)

Official Marketplace (after listing)

Install browse-bridge from the Cursor Marketplace and paste your API key when prompted (BROWSEBRIDGE_API_KEY).

Local test (before / without Marketplace)

# Copy (do not symlink outside this folder)
cp -R /path/to/browsebridge-cursor-plugin ~/.cursor/plugins/local/browse-bridge

Reload Window, open Customize, configure BROWSEBRIDGE_API_KEY, confirm MCP tools appear (browser_observe, browser_click, etc.).

Manual `mcp.json` snippet

{
  "mcpServers": {
    "browse-bridge": {
      "url": "https://mcp.browsebridge.com/mcp",
      "headers": {
        "Authorization": "Bearer ${BROWSEBRIDGE_API_KEY}"
      }
    }
  }
}

Plugin variables only fill in inside the plugin, so for a manual config use your real key or ${env:BROWSEBRIDGE_API_KEY}.

Usage

Open a normal website tab (not chrome://).
Click the Browse Bridge toolbar icon, then Enable on the tab you want to share. Accept the confirmation and any Chrome permission prompt. Use Take control (or Ctrl+Shift+Period) to take the tab back at any time.
In Cursor, use MCP tools such as browser_list_sessions, browser_observe, browser_click, browser_screenshot.
Challenges / sensitive sites may pause the agent for human Take over or Approve.

Tools (19)

Tool	What it does
`browser_list_sessions`	List Enabled shared tabs.
`browser_get_status`	Control mode, URL, `deviceOnline`, pending approvals, remaining monthly quota (`actionsRemaining`, `screenshotsRemaining`, `quotaExceeded`, `quotaResetAt`). Tools return `QUOTA_EXCEEDED` when a monthly quota is exhausted.
`browser_observe`	Semantic page tree + `observationId` / `elementId`s.
`browser_screenshot`	Visible-tab JPEG as MCP image content.
`browser_click`	Click an observed element. Optional `button`: `"left"` (default), `"right"`, or `"middle"`.
`browser_type`	Set a control's value (not a password).
`browser_select`	Choose a listed `<option>`.
`browser_press_key`	Key in the focused (or named) element.
`browser_hover`	`mouseover` / `mouseenter` on an observed element.
`browser_scroll`	Scroll the page or an element into view.
`browser_navigate`	Go to an allowed http(s) URL.
`browser_back`	History back.
`browser_forward`	History forward.
`browser_reload`	Reload the tab.
`browser_wait`	Pause 0–30000 ms.
`browser_release_control`	Give the tab back to the human (`controlMode: "human"`).
`browser_handle_dialog`	Accept or dismiss a pending JavaScript `alert` / `confirm` / `prompt` (`action`: accept\|dismiss; optional when accepting a prompt).

JavaScript dialogs

While the agent has control, a page alert / confirm / prompt stays pending until browser_handle_dialog (or about a 30-second timeout dismiss). Other click, type, and navigate calls while a dialog is open return DIALOG_PENDING. Native HTTP basic or digest sign-in prompts are not JavaScript dialogs (HTTP_AUTH_REQUIRED). The human completes or cancels them. Browse Bridge never types those credentials.

Approvals

Sensitive-site clicks/types/navigations and cross-origin navigations (and cross-origin link clicks) return APPROVAL_REQUIRED. The human Approves or Denies in the Chrome side panel. The agent can withdraw its own request with browser_cancel_approval (APPROVAL_CANCELLED — that is not a human Deny). While an approval is pending, observe/screenshot/wait/get_status/list_sessions/release_control still run.

Configuration

Variable	Required	Description
`BROWSEBRIDGE_API_KEY`	Yes	API key from the Browse Bridge dashboard

Declared in .cursor-plugin/plugin.json → variables and referenced only as ${BROWSEBRIDGE_API_KEY} in mcp.json.

Privacy & security

See PRIVACY.md and SECURITY.md.

Repo layout

.cursor-plugin/plugin.json
mcp.json
assets/logo.svg
README.md
LICENSE
PRIVACY.md
SECURITY.md
SUPPORT.md

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Browse Bridge?

Does Browse Bridge need an API key?

What transport does Browse Bridge use?

When was Browse Bridge last checked?

Documentation

Browse Bridge for Cursor

Prerequisites

Install (Marketplace / local)

Official Marketplace (after listing)

Local test (before / without Marketplace)

Manual mcp.json snippet

Usage

Tools (19)

JavaScript dialogs

Approvals

Configuration

Privacy & security

Repo layout

Manual `mcp.json` snippet