Browserbase MCP Server

Browserbase MCP server enables AI models to control cloud browsers with Stagehand AI, providing automated page navigation, data extraction, element observation, and web actions.

June 10, 2026
MCP ServerDevelopment Tools & DevOpsBrowserbase MCP Server
GitHub starsnpm version

Overview

The Browserbase MCP Server gives AI models the ability to control real cloud browsers using Stagehand, an AI-powered browser automation framework. Unlike local Puppeteer or Playwright, Browserbase runs browsers in the cloud with stealth detection avoidance, making it ideal for web scraping, testing, and autonomous browsing.

Official Server:

Developed and maintained by Browserbase. Hosted MCP available at https://mcp.browserbase.com/mcp.

Key Features

🌐

Cloud Browsers

Headless browsers running in the cloud with no local resource consumption

🤖

Stagehand AI

AI-powered browser actions using natural language instructions via Stagehand

🕵️

Stealth Detection Avoidance

Built-in fingerprinting evasion and bot detection bypass

📊

Data Extraction

Extract structured data from web pages with natural language instructions

🎭

Session Persistence

Keep browser sessions alive across multiple interactions with Keep Alive mode

🎯

Element Observation

Observe and identify actionable elements on the page for interaction

Available Tools

Quick Reference

ToolPurposeCategory
startCreate or reuse a Browserbase sessionSession
endClose the current Browserbase sessionSession
navigateNavigate to a URLNavigation
actPerform an action on the pageInteraction
observeObserve actionable elements on the pageObservation
extractExtract structured data from the pageExtraction

Detailed Usage

navigate

Navigate the browser to a specified URL. Must be called after starting a session.

{
  "url": "https://github.com/browserbase/mcp-server-browserbase"
}
act

Perform a browser action described in natural language. Powered by Stagehand AI.

{
  "action": "Click the star button on the repository page",
  "modelName": "google/gemini-2.5-flash-lite"
}
extract

Extract structured data from the current page using natural language instructions.

{
  "instruction": "Get the repository name, star count, and last commit date"
}
observe

Observe and identify actionable elements on the page, returning a list of candidates.

{
  "instruction": "Find all navigation links in the header"
}

Installation

{
  "mcpServers": {
    "browserbase": {
      "type": "http",
      "url": "https://mcp.browserbase.com/mcp"
    }
  }
}

Configuration Options

The self-hosted server accepts these command-line flags:

FlagDescription
--proxiesEnable Browserbase proxies for the session
--verifiedEnable Verified Identity for bot detection avoidance
--keepAliveKeep browser session alive across multiple interactions
--modelName <model>Model for Stagehand (default: google/gemini-2.5-flash-lite)
--modelApiKey <key>API key for custom model provider
--browserWidth <px>Browser viewport width (default: 1024)
--browserHeight <px>Browser viewport height (default: 768)

Docker Image:

Build the image first: git clone https://github.com/browserbase/mcp-server-browserbase.git && cd mcp-server-browserbase && docker build -t mcp-browserbase .

API Keys Required:

Sign up at browserbase.com for a Browserbase API key and project ID. A Gemini API key is required for Stagehand's AI-powered actions.

Security

  • API key authenticated — no direct system access to your machine
  • Browsers run in isolated cloud sandboxes, not on your local device
  • Stagehand actions are scoped to the current page only
  • Session isolation prevents cross-session data leakage
  • Hosted MCP uses HTTPS with OAuth authentication

Comparison: Browserbase vs Playwright/Puppeteer MCP

FeatureBrowserbasePlaywright/Puppeteer MCP
Browser LocationCloud (Browserbase infra)Local machine
Bot DetectionBuilt-in stealthManual configuration
AI-Powered ActionsStagehand (natural language)Code-based selectors only
Session PersistenceKeep Alive modePer-command sessions
InfrastructureZero setupRequires local browser install
ScalingCloud auto-scalingLimited by local resources

Sources