Browserbase MCP (Stagehand)

Add to your client

Copy the config for your MCP client and paste it into its config file.

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

Before you start

• Node.js 18+ (run via npx) — or use the hosted endpoint with no local runtime
• A Browserbase API key and Project ID from your Browserbase dashboard (browserbase.com)
• A model API key for Stagehand — defaults to Google Gemini (GEMINI_API_KEY); custom models (Claude, GPT-4o) need the matching key via --modelApiKey

About Browserbase MCP (Stagehand)

Tools & capabilities (8)

When to use it

• Use it when you want to automate a browser with natural language instead of writing selectors
• Use it when you need cloud browsers with proxies and stealth to avoid blocks during scraping
• Use it when you need to extract structured data from pages into a schema
• Use it when you want parallel multi-session automation for scale (scraping, A/B testing, multiple accounts)
• Use it when you need persistent auth/context across sessions via Browserbase contexts
• Use it when you want browser automation without managing local Chrome or Playwright infrastructure

Quick setup

1. 1Create a Browserbase account and copy your API key and Project ID
2. 2Choose hosted (point your client at https://mcp.browserbase.com/mcp) or self-hosted via `npx @browserbasehq/mcp`
3. 3For self-hosted, set BROWSERBASE_API_KEY, BROWSERBASE_PROJECT_ID, and GEMINI_API_KEY (or pass --modelName/--modelApiKey)
4. 4Add the server to your MCP client config and restart the client
5. 5Optionally add flags like --proxies, --advancedStealth, or --contextId
6. 6Verify by asking the agent to start a session, navigate to a URL, and extract some data

Browserbase MCP (Stagehand) FAQ