Browserbase MCP Server

What is Browserbase MCP Server?

This server provides cloud browser automation capabilities using Browserbase and Stagehand. It enables LLMs to interact with web pages, extract information, and perform automated actions via the Model Context Protocol.

How to use Browserbase MCP Server?

You can connect via STDIO or SHTTP transport. For the easiest setup, use the hosted SHTTP server at https://mcp.browserbase.com/mcp. For self-hosted, run npx @browserbasehq/mcp with environment variables BROWSERBASE_API_KEY, BROWSERBASE_PROJECT_ID, and GEMINI_API_KEY (for the default model). Configuration flags can be passed to the CLI.

Key features of Browserbase MCP Server

• Six tools: start, end, navigate, act, observe, extract
• Supports STDIO and SHTTP transports
• Configurable model (default: Google Gemini 2.5 Flash Lite)
• Optional Browserbase proxies, verified identity, and keep-alive sessions
• Customizable browser viewport width and height
• Self-hostable via NPM or Docker

Use cases of Browserbase MCP Server

• Navigate to a URL using the navigate tool
• Perform an action on a page with the act tool
• Observe actionable elements based on an instruction using observe
• Extract structured data from a page with extract
• Start and end a browser session with start and end

FAQ from Browserbase MCP Server

What tools does the Browserbase MCP Server provide?

It provides six tools: start (create/reuse session), end (close session), navigate (go to a URL), act (perform action on page), observe (find actionable elements), and extract (extract data from page).

How do I use a custom model with this server?

Pass the --modelName flag with the model identifier and the --modelApiKey flag with your API key for that provider. The model must be supported by Stagehand.

What environment variables are required?

You need BROWSERBASE_API_KEY and BROWSERBASE_PROJECT_ID. For the default model, also set GEMINI_API_KEY. When using a custom model, omit GEMINI_API_KEY and provide --modelApiKey instead.

Can I run the Browserbase MCP Server locally?

Yes. You can run it via npx @browserbasehq/mcp with environment variables, or clone the repo and build with npm or Docker for a fully local installation.

What transports are supported?

STDIO and SHTTP are supported. The hosted SHTTP version at https://mcp.browserbase.com/mcp is recommended for easiest setup.