Documentation Index Fetch the complete documentation index at: https://stagehand-shrey-check-v3-metrics-docs.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
Quick Installation
Install with Cursor One-click installation directly in Cursor with pre-configured settings
We support multiple transport methods for our MCP server: STDIO and SHTTP. We recommend using SHTTP with our remote hosted URL to take advantage of the server at full capacity.
Prerequisites
Get your Browserbase credentials
Get your Browserbase API key and project ID from the Browserbase Dashboard . Then copy your API Key and Project ID directly from the input. Installation Methods Remote URL (SHTTP)
NPM Package (STDIO)
Local Development
Go to smithery.ai and enter your API keys and configuration to get a remote hosted URL. { "mcpServers" : { "browserbase" : { "url" : "your-smithery-url.com" } } }
When using our remote hosted server, we provide the LLM costs for Gemini, the best performing model in Stagehand . The easiest way to get started locally is using our NPM package. If you would like to use a different model, you have to pass the model name and keys in the args. More info here .
Add to MCP Config
Go into your MCP Config JSON and add the Browserbase Server: { "mcpServers" : { "browserbase" : { "command" : "npx" , "args" : [ "@browserbasehq/mcp-server-browserbase" ], "env" : { "BROWSERBASE_API_KEY" : "your_api_key" , "BROWSERBASE_PROJECT_ID" : "your_project_id" , "GEMINI_API_KEY" : "your_gemini_api_key" } } } }
Restart your MCP client
That’s it! Reload your MCP client and Claude will be able to use Browserbase.
For local development or customization, you can run the server locally.
Clone and build
# Clone the Repo git clone https://github.com/browserbase/mcp-server-browserbase.git cd mcp-server-browserbase # Install the dependencies and build the project npm install && npm run build
Choose your transport method
You can run locally using either STDIO or Streamable HTTP (SHTTP). STDIO
SHTTP (Self-hosted)
Add the following to your MCP Config JSON file: { "mcpServers" : { "browserbase" : { "command" : "node" , "args" : [ "/path/to/mcp-server-browserbase/cli.js" ], "env" : { "BROWSERBASE_API_KEY" : "your_api_key" , "BROWSERBASE_PROJECT_ID" : "your_project_id" , "GEMINI_API_KEY" : "your_gemini_api_key" } } } }
First, run the server: Then add this to your MCP Config JSON file: { "mcpServers" : { "browserbase" : { "url" : "http://localhost:8931/mcp" , "env" : { "BROWSERBASE_API_KEY" : "your_api_key" , "BROWSERBASE_PROJECT_ID" : "your_project_id" , "GEMINI_API_KEY" : "your_gemini_api_key" } } } }
Restart your client
Reload your MCP client and you should be good to go!
Verify Installation
Restart your Claude Client
Restart/refresh your Claude Client app and you should see the tools available by clicking the 🔨 icon.
Test the integration
Get started using our MCP Server by asking Claude to navigate to any page and see your Browserbase Browser in action on the dashboard . Try asking Claude: “Navigate to google.com and take a screenshot”
Further Reading
Model Context Protocol (MCP) Docs Learn more about the MCP protocol
Browserbase Documentation Explore Browserbase features and capabilities
Support Get help from our support team
