Skip to main content
hc
Submit
mcpSource-backedReview first Safety ✓ Privacy ✓

Browserbase MCP Server

Browser automation MCP server that lets AI agents control cloud browser sessions through Browserbase and Stagehand for navigation, actions, observation, and extraction.

by Browserbase·added 2026-06-05·
Claude CodeClaude Desktop
HarnessClaude CodeClaude Desktop
Review first — review before installing

Open the source and read safety notes before installing.

Safety notes

  • Browserbase MCP can create browser sessions, navigate URLs, perform page actions, observe actionable elements, extract data, and close sessions.
  • Cloud browser automation can submit forms, change account state, trigger transactions, scrape sites, or violate website terms if not scoped.
  • Require human approval before login, purchase, messaging, account-change, destructive, or high-volume browsing actions.
  • Review proxy, verified identity, persisted context, and keep-alive options before using them with sensitive sites.

Privacy notes

  • Browser session URLs, page content, extracted data, screenshots or observations, cookies or persisted context, API keys, and prompts may be sent to Browserbase, Stagehand/model providers, and the MCP client.
  • Persisted browser contexts can retain login state, cookies, and site data across sessions.
  • Protect Browserbase, project, and model-provider keys in config files, logs, screenshots, and shared prompts.

Prerequisites

  • Browserbase account, API key, and project ID for self-hosted npm usage.
  • Model provider key when using a custom or self-hosted Stagehand model configuration.
  • MCP client with hosted HTTP support or a stdio bridge.
  • Clear target websites and automation boundaries for each browser session.

Schema details

Install type
cli
Troubleshooting
No
Source repository stats
Scope
Source repo
Collection metadata
Estimated setup
10 minutes
Difficulty
intermediate
Tool listing metadata
Full copyable content
{
  "mcpServers": {
    "browserbase": {
      "command": "npx",
      "args": ["@browserbasehq/mcp"],
      "env": {
        "BROWSERBASE_API_KEY": "YOUR_BROWSERBASE_API_KEY",
        "BROWSERBASE_PROJECT_ID": "YOUR_BROWSERBASE_PROJECT_ID",
        "GEMINI_API_KEY": "YOUR_GEMINI_API_KEY"
      }
    }
  }
}

About this resource

Content

Browserbase MCP Server gives AI agents cloud browser automation through Browserbase and Stagehand. It exposes tools for starting or reusing a browser session, navigating to URLs, acting on pages, observing actionable elements, extracting data, and ending sessions.

The repository describes this project as the self-hostable version of Browserbase's hosted MCP server, with support for hosted HTTP and self-hosted stdio usage through the @browserbasehq/mcp npm package.

Source Review

These sources were reviewed on 2026-06-05. Prefer the live docs for current hosted endpoint behavior, package name, Stagehand model options, Browserbase flags, and client-specific setup.

Features

  • Hosted Browserbase MCP endpoint and self-hostable npm package.
  • Tools for start, end, navigate, act, observe, and extract.
  • Browserbase cloud browser sessions.
  • Stagehand-powered browser automation and extraction.
  • Optional proxies, verified identity, keep-alive, persisted contexts, viewport sizing, and custom model configuration.
  • Docker and local build options for self-hosting.

Installation

For self-hosted stdio usage through npm:

{
  "mcpServers": {
    "browserbase": {
      "command": "npx",
      "args": ["@browserbasehq/mcp"],
      "env": {
        "BROWSERBASE_API_KEY": "YOUR_BROWSERBASE_API_KEY",
        "BROWSERBASE_PROJECT_ID": "YOUR_BROWSERBASE_PROJECT_ID",
        "GEMINI_API_KEY": "YOUR_GEMINI_API_KEY"
      }
    }
  }
}

For clients with hosted MCP support, the docs also describe the hosted Browserbase MCP endpoint. Use the repository and Browserbase docs for current transport, key, and model-provider setup.

Use Cases

  • Give an agent a cloud browser for web UI testing.
  • Extract structured data from pages after navigation.
  • Use Stagehand actions to interact with web apps.
  • Run browser automation without launching a local browser.
  • Compare hosted MCP and self-hosted npm setups for different client support.

Safety and Privacy

Cloud browser automation can affect real web accounts and third-party services. Keep sessions scoped, avoid high-volume automation unless authorized, and require review before submitting forms, making purchases, sending messages, changing account settings, or collecting personal data.

Treat Browserbase contexts, cookies, extracted page content, prompts, API keys, and model-provider traffic as sensitive. Review persisted-context settings before automating logged-in workflows.

Duplicate Check

No browserbase/mcp-server-browserbase entry or source URL was found in content/mcp. This entry is separate from local browser-profile tools, Playwright MCP, Chrome MCP, and BrowserMCP because it focuses on Browserbase cloud sessions and Stagehand.

#browser#automation#cloud#stagehand#scraping

Source citations

Signals

Loading live community signals…

More like this, weekly

A short, calm digest of reviewed Claude resources. Unsubscribe any time.