Browserbase MCP Server
@browserbase
About Browserbase MCP Server
Allow LLMs to control a browser with Browserbase and Stagehand
Basic information
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"mcp-server-browserbase": {
"command": "docker",
"args": [
"build",
"-t",
"mcp-browserbase",
"."
]
}
}
}Tools
6Create or reuse a Browserbase session
Close the current Browserbase session
Navigate to a URL
Perform an action on the page
Observe actionable elements on the page
Extract data from the page
Overview
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
navigatetool - Perform an action on a page with the
acttool - Observe actionable elements based on an instruction using
observe - Extract structured data from a page with
extract - Start and end a browser session with
startandend
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.
More Browser Automation MCP servers
Browser Control MCP
eyalzhMCP server paired with a browser extension that enables AI agents to control the user's browser.
Webpage Screenshot MCP Server
ananddtyagiAn MCP that gives your agent the ability to snap a screenshot of webpages. Useful when you want your agent to check its progress during development.
Fetch MCP Server
zcaceresA flexible HTTP fetching Model Context Protocol server.
MCP server w/ Browser Use
JovaniPinkFastAPI server implementing MCP protocol Browser automation via browser-use library.
browser-mcp
djydeA browser extension and MCP server that allows you to interact with the browser you are using.
Comments