Browserbase

by Browserbase

v2.4.3

Apache-2.0

Repository Docs npm

Featured Web & Search

browserautomationcloudstagehand

Summary

Browserbase's official MCP server — cloud browser automation with Stagehand's natural-language actions.

Features

Cloud browser sessions with proxies and stealth built in
Natural-language page actions via Stagehand
Structured data extraction from any page

Installation

Set up this MCP server in your favorite AI agent — copy a ready-made configuration below.

Any MCP-compatible agent

Most agents (Claude, Cursor, Windsurf, VS Code, and more) read a standard mcpServers configuration.

Open your agent's MCP configuration file.
Merge the snippet below into it, filling in the environment variables with your own values.
Restart the agent — the "Browserbase" tools will be available.

{
  "mcpServers": {
    "browserbase-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@browserbasehq/mcp-server-browserbase"
      ],
      "env": {
        "BROWSERBASE_API_KEY": "your-api-key",
        "BROWSERBASE_PROJECT_ID": "your-project-id"
      }
    }
  }
}

Claude Code

Add the server with a single CLI command.

claude mcp add browserbase-mcp -e BROWSERBASE_API_KEY=your-api-key -e BROWSERBASE_PROJECT_ID=your-project-id -- npx -y @browserbasehq/mcp-server-browserbase

Claude Desktop

Add the server to claude_desktop_config.json (Settings → Developer → Edit Config).

{
  "mcpServers": {
    "browserbase-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@browserbasehq/mcp-server-browserbase"
      ],
      "env": {
        "BROWSERBASE_API_KEY": "your-api-key",
        "BROWSERBASE_PROJECT_ID": "your-project-id"
      }
    }
  }
}

Cursor

{
  "command": "npx",
  "args": [
    "-y",
    "@browserbasehq/mcp-server-browserbase"
  ],
  "env": {
    "BROWSERBASE_API_KEY": "your-api-key",
    "BROWSERBASE_PROJECT_ID": "your-project-id"
  }
}

Windsurf

{
  "command": "npx",
  "args": [
    "-y",
    "@browserbasehq/mcp-server-browserbase"
  ],
  "env": {
    "BROWSERBASE_API_KEY": "your-api-key",
    "BROWSERBASE_PROJECT_ID": "your-project-id"
  }
}

VS Code

{
  "command": "npx",
  "args": [
    "-y",
    "@browserbasehq/mcp-server-browserbase"
  ],
  "env": {
    "BROWSERBASE_API_KEY": "your-api-key",
    "BROWSERBASE_PROJECT_ID": "your-project-id"
  }
}

Description

Browserbase's official MCP server gives an assistant a cloud browser rather than a local one, which removes the infrastructure problems that make local automation fragile at scale.

What it provides

Managed sessions. Browsers run in Browserbase's cloud with proxy support, fingerprint management, and captcha handling.
Stagehand actions. Instead of CSS selectors, the assistant describes what to do — "click the login button", "fill in the search field" — and Stagehand resolves it against the page. Selectors break when a site changes markup; descriptions usually do not.
Structured extraction. Define the shape of the data you want and get typed results back rather than raw HTML.
Observation. Ask what actions are available on the current page before choosing one.
Live session view for watching what the browser is doing, which is invaluable when an agent silently goes wrong.

When to choose it over a local browser

When you need concurrency, when the target site blocks datacentre traffic, or when you want session recordings for debugging. Requires a Browserbase account; runs with npx @browserbasehq/mcp-server-browserbase.