Browserbase MCP server
MCP server for AI web browser automation using Browserbase and Stagehand
3.4k stars
Reviews
Write oneNobody has reviewed Browserbase yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Browserbase tools (12, 2 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
browserbase_screenshotTakes a screenshot of the current page. Use this tool to learn where you are on the page when controlling the browser with Stagehand. Only use this tool when the other tools are not sufficient to get the information you need.
browserbase_session_closeCloses the current Browserbase session by properly shutting down the Stagehand instance, which handles browser cleanup and terminates the session recording.
browserbase_session_createwrite actionCreate or reuse a single cloud browser session using Browserbase with fully initialized Stagehand. WARNING: This tool is for SINGLE browser workflows only. If you need multiple browser sessions running simultaneously (parallel scraping, A/B testing, multiple accounts), use 'multi_browserbase_stagehand_session_create' instead. This creates one browser session with all configuration flags (proxies,
browserbase_stagehand_actPerforms an action on a web page element. Act actions should be as atomic and
browserbase_stagehand_extractExtracts structured information and text content from the current web page based on specific instructions
browserbase_stagehand_get_all_urlsGets the current URLs of all active browser sessions. Returns a mapping of session IDs to their current URLs.
browserbase_stagehand_get_urlGets the current URL of the browser page. Returns the complete URL including protocol, domain, path, and any query parameters or fragments.
browserbase_stagehand_navigateNavigate to a URL in the browser. Only use this tool with URLs you're confident will work and stay up to date. Otherwise, use https://google.com as the starting point
browserbase_stagehand_observeObserves and identifies specific interactive elements on the current web page that can be used for subsequent actions.
multi_browserbase_stagehand_session_closeCleanup parallel session for multi-session workflows. Properly terminates a browser session, ends the Browserbase session, and frees cloud resources. Always use this when finished with a session to avoid resource waste and billing charges. Critical for responsible multi-session automation - each unclosed session continues consuming resources!
multi_browserbase_stagehand_session_createwrite actionCreate parallel browser session for multi-session workflows. Use this when you need multiple browser instances running simultaneously: parallel data scraping, concurrent automation, A/B testing, multiple user accounts, cross-site operations, batch processing, or any task requiring more than one browser. Creates an isolated browser session with independent cookies, authentication, and state. Always
multi_browserbase_stagehand_session_listONLY WORKS WITH MULTI-SESSION TOOLS! Track all parallel sessions: Critical tool for multi-session management! Shows all active browser sessions with their IDs, names, ages, and Browserbase session IDs. Use this frequently to monitor your parallel automation workflows, verify sessions are running, and get session IDs for session-specific tools. Essential for debugging and resource management in com
Public scan report
scanner v0.1.10 · 2026-10-01 · same rubric, same numbers if you re-run it
- Code scan28 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancerepository archived0/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year9/10
Findings (1)
- highRepository is archived
maint.archived
Install Browserbase in Claude Code, Cursor or VS Code
Runs npx -y @browserbasehq/mcp-server-browserbase on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add mcp-server-browserbase -- npx -y @browserbasehq/mcp-server-browserbase
What the publisher says
From the Browserbase repository's README, as published. We do not edit it. Read it on GitHub
Browserbase MCP Server
Archived
This repository is archived and no longer maintained.
It was originally published as a reference implementation and is retained for historical purposes. It should not be interpreted as representative of Browserbase's current production services or implementation.
The Model Context Protocol (MCP) is an open protocol that enables seamless integration between LLM applications and external data sources and tools. Whether you're building an AI-powered IDE, enhancing a chat interface, or creating custom AI workflows, MCP provides a standardized way to connect LLMs with the context they need.
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.
This is a self-hostable version of the Browserbase hosted MCP server with the same tools and functionality. We recommend using the hosted version for the easiest setup.
Tools
This server exposes 6 tools that match the hosted Browserbase MCP server:
How to Setup
We currently support 2 transports for our MCP server, STDIO and SHTTP. We recommend you use SHTTP with our hosted MCP server to take advantage of the server at full capacity.
SHTTP (Hosted MCP):
Use the Browserbase hosted MCP server at https://mcp.browserbase.com/mcp. This is the easiest way to get started -- we host the server and provide the LLM costs for Gemini, the best performing model in Stagehand.
For full setup instructions, see the Browserbase MCP documentation.
If your client supports SHTTP:
{
"mcpServers": {
"browserbase": {
"type": "http",
"url": "https://mcp.browserbase.com/mcp"
}
}
}If your client doesn't support SHTTP:
{
"mcpServers": {
"browserbase": {
"command": "npx",
"args": ["mcp-remote", "https://mcp.browserbase.com/mcp"]
}
}
}STDIO (Self-Hosted):
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 buildOption 2: Docker
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Browserbase: common questions
- Is Browserbase MCP server safe?
- With care: it is graded C, so read the findings first (62/100). Read the Browserbase safety report
- How do I install Browserbase?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Browserbase need an API key?
- Yes. The registry entry asks for
BROWSERBASE_API_KEY,GEMINI_API_KEY. - Is Browserbase maintained?
- The last commit was 85 days ago (2026-07-20). The latest release is v2.1.1.
- What can I use instead of Browserbase?
- Servers from other publishers that do the same job: SeleniumBase MCP server, AIHawk MCP server and Scrapeless MCP server. Compare all Browserbase alternatives.
Alternatives to Browserbase
Same job from other publishers: the closest match first, then the best rated.
- SeleniumBase MCPStealthy browser automation, testing, and web-scraping via CDP Mode.not reviewedWidely usedA
- AIHawkAI browser agent: browses, clicks, types, and reads real web pages from plain-English instructions.not reviewedWidely usedA
- ScrapelessWeb search, browser automation, scraping, crawling and CAPTCHA solving for AI agents.not reviewedEstablishedA
- Web Browser (kogiQA)This web browser has been designed to help your agent debug and develop complex web applications.not reviewedEstablishedC
FouraReliable web access for AI agents: smart HTTP, rotating proxies, and full-browser rendering.not reviewedGrowingB