🔌 MCP ServersMCP

mcp-server-browserbase

Allow LLMs to control a browser with Browserbase and Stagehand

browserbaseTypeScriptgit

View on GitHub

Overview

Review mcp-server-browserbase through its repository signals, setup path, and structured documentation.

Key Features

Documentation available at https://docs.browserbase.com/integrations/mcp/introduction
Built around typescript tooling

Best For

Mcp Server research

Keep exploring from this skill

Use these paths to move from a single repository into the broader category, platform, and workflow hubs that users usually compare next.

Install

git clone https://github.com/browserbase/mcp-server-browserbase.git

Repository

Stars

3,398

Forks

358

You can either use our server hosted on NPM or run it completely locally by cloning this repo.

Note: If you want to use a different model you have to add --modelName to the args and provide that respective key as an arg. More info below.

To run via NPM (Recommended)

Go into your MCP Config JSON and add the Browserbase Server:

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

That's it! Reload your MCP client and you're ready to go.

To run 100% local:

Option 1: Direct installation

git clone https://github.com/browserbase/mcp-server-browserbase.git
cd mcp-server-browserbase
npm install && npm run build

Option 2: Docker

git clone https://github.com/browserbase/mcp-server-browserbase.git
cd mcp-server-browserbase
docker build -t mcp-browserbase .

Then in your MCP Config JSON run the server:

Using Direct Installation

{
  "mcpServers": {
    "browserbase": {
      "command": "node",
      "args": ["/path/to/mcp-server-browserbase/cli.js"],
      "env": {
        "BROWSERBASE_API_KEY": "",
        "BROWSERBASE_PROJECT_ID": "",
        "GEMINI_API_KEY": ""
      }
    }
  }
}

Using Docker

{
  "mcpServers": {
    "browserbase": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "BROWSERBASE_API_KEY",
        "-e",
        "BROWSERBASE_PROJECT_ID",
        "-e",
        "GEMINI_API_KEY",
        "mcp-browserbase"
      ],
      "env": {
        "BROWSERBASE_API_KEY": "",
        "BROWSERBASE_PROJECT_ID": "",
        "GEMINI_API_KEY": ""
      }
    }
  }
}

Tools

This server exposes 6 tools that match the hosted Browserbase MCP server:

Tool	Description	Input
`start`	Create or reuse a Browserbase session	(none)
`end`	Close the current Browserbase session	(none)
`navigate`	Navigate to a URL	`{ url: string }`
`act`	Perform an action on the page	`{ action: string }`
`observe`	Observe actionable elements on the page	`{ instruction: string }`
`extract`	Extract data from the page	`{ instruction?: string }`

Requirements

typescript runtime or toolinggit compatible environmentan MCP-compatible host

Trust Signals

FeaturedVerifiedDocs AvailableHomepage Available

Flag	Description
`--proxies`	Enable Browserbase proxies for the session
`--verified`	Enable Browserbase Verified Identity (Only for Scale Plan Users)
`--advancedStealth`	Deprecated alias for `--verified`
`--keepAlive`	Enable Browserbase Keep Alive Session
`--contextId <contextId>`	Specify a Browserbase Context ID to use
`--persist`	Whether to persist the Browserbase context (default: true)
`--port <port>`	Port to listen on for HTTP/SHTTP transport
`--host <host>`	Host to bind server to (default: localhost, use 0.0.0.0 for all interfaces)
`--browserWidth <width>`	Browser viewport width (default: 1024)
`--browserHeight <height>`	Browser viewport height (default: 768)
`--modelName <model>`	The model to use for Stagehand (default: google/gemini-2.5-flash-lite)
`--modelApiKey <key>`	API key for the custom model provider (required when using custom models)
`--experimental`	Enable experimental features (default: false)

mcp-server-browserbase

What the docs cover