Browserbase MCP Server
Cloud browser automation for AI agents — headless sessions, navigation, and web actions via MCP.
Updated
What is Browserbase MCP?
The Browserbase MCP server is a Model Context Protocol server that lets AI agents drive a real, cloud-hosted browser — opening headless sessions, navigating to URLs, taking actions, and extracting data from live web pages.
Built on Browserbase and its Stagehand framework, the server exposes high-level, AI-native actions (act, observe, extract) so an agent can interact with pages using natural language rather than brittle selectors. It is well suited to web automation, scraping, form-filling, and agentic browsing tasks that need a managed browser environment.
Browserbase officially hosts the server at https://mcp.browserbase.com/mcp, authenticated with your Browserbase API key (passed as a bearer credential by the connecting client). You can also self-host it via npx @browserbasehq/mcp over STDIO, supplying your own BROWSERBASE_API_KEY, BROWSERBASE_PROJECT_ID, and an LLM provider key.
Tools the Browserbase MCP server exposes
| Tool | What it does |
|---|---|
| start | Create or reuse a Browserbase cloud browser session. |
| navigate | Navigate the browser to a given URL. |
| act | Perform an action on the page using a natural-language instruction. |
| observe | Observe and find actionable elements on the current page. |
| extract | Extract structured data from the current page. |
| end | Close the active Browserbase session. |
Connect the Browserbase MCP server
Claude Code (hosted)
- 1
Get your API key
Sign up at browserbase.com and copy your Browserbase API key from the dashboard.
- 2
Add the remote server
Run: claude mcp add --transport http browserbase "https://mcp.browserbase.com/mcp?browserbaseApiKey=YOUR_BROWSERBASE_API_KEY"
- 3
Verify
Run /mcp inside Claude Code to confirm the browserbase server is connected and its tools (start, navigate, act, observe, extract, end) are listed.
For self-hosting, use `npx @browserbasehq/mcp` with BROWSERBASE_API_KEY, BROWSERBASE_PROJECT_ID, and an LLM key (e.g. GEMINI_API_KEY) as env vars.
Cursor (hosted)
- 1
Get your API key
Copy your Browserbase API key from the dashboard at browserbase.com.
- 2
Edit MCP config
In Cursor Settings → MCP, add a server with url: https://mcp.browserbase.com/mcp?browserbaseApiKey=YOUR_BROWSERBASE_API_KEY
- 3
Reload
Save and reload Cursor; the browserbase tools become available to the agent in chat.
Browserbase also publishes a one-click Cursor deep link in its MCP docs.
Security & permissions
The hosted endpoint authenticates with your Browserbase API key, carried as a bearer credential by the connecting client (in the hosted URL it is passed as the browserbaseApiKey parameter; self-hosting uses BROWSERBASE_API_KEY + BROWSERBASE_PROJECT_ID env vars). That key scopes the agent to your Browserbase project — it can spin up browser sessions and navigate to and act on any public or authenticated web page you direct it to, so treat it like a privileged credential. Browser sessions can reach external sites and submit data, so review which workflows are allowed to drive the browser. Rotate the key from the Browserbase dashboard if exposed.
Using Browserbase MCP with Gamut
In Gamut, you connect Browserbase once and a Gamut agent can then use it as a tool inside an automated, event- or schedule-triggered workflow — for example, on a daily schedule the agent starts a session, navigates to a target page, extracts data, and ends the session, all without a human in the loop. Gamut manages the MCP connection and credentials, so the agent simply calls the navigate/act/observe/extract tools as steps in its task. Use it for recurring scraping, monitoring, or form-driven automations where a real cloud browser is required.
Frequently asked questions
What is the Browserbase MCP server?
It is a Model Context Protocol server, built on Browserbase and Stagehand, that gives AI agents a cloud-hosted browser. Agents can start sessions and use natural-language actions to navigate, act, observe, and extract data from live web pages.
Is the Browserbase MCP server free?
Browserbase has a free tier (free signup with limited concurrent browsers and usage), with paid plans starting at $20/mo (Developer) and $99/mo (Startup) up to custom Scale pricing. The hosted MCP endpoint also covers the Gemini LLM costs for the agent loop.
Is it officially hosted or self-hosted?
Both. Browserbase officially hosts the server at https://mcp.browserbase.com/mcp, and you can self-host it via `npx @browserbasehq/mcp` over STDIO using your own API key, project ID, and LLM provider key.
How do I connect Browserbase MCP to Claude Code or Cursor?
Get your Browserbase API key, then for Claude Code run `claude mcp add --transport http browserbase "https://mcp.browserbase.com/mcp?browserbaseApiKey=YOUR_KEY"`. For Cursor, add the same URL as an MCP server in Settings → MCP and reload.