Skip to main content

​
Overview

The Browserbase MCP Server can be integrated with Google ADK agents to provide browser automation capabilities. We support both local STDIO and hosted SHTTP transport methods.
We recommend using SHTTP with our remote hosted URL to take advantage of the server at full capacity and avoid managing local processes.

​
Prerequisites

1

Get your Browserbase credentials

Get your Browserbase API key and project ID from the Browserbase Dashboard.
Browserbase API Key and Project ID settings
Then copy your API Key and Project ID directly from the input.
2

(Optional) Get your Gemini API Key

Get your Gemini API key from Google AI Studio for AI-powered browser automation with Stagehand. Only required if you’re using the local MCP server.

​
Setup Methods

  • Remote Hosted (SHTTP)
  • Local STDIO
Recommended: When using our remote hosted server, we provide the LLM costs for Gemini, the best performing model in Stagehand.
Go to smithery.ai and enter your API keys and configuration to get a remote hosted URL.SmitheryThen configure your Google ADK agent:
from google.adk.agents import Agent
from google.adk.tools.mcp_tool.mcp_session_manager import SseConnectionParams
from google.adk.tools.mcp_tool.mcp_toolset import MCPToolset

root_agent = Agent(
    model="gemini-2.5-pro",
    name="browserbase_agent",
    instruction="Help users get information from web pages using Browserbase",
    tools=[
        MCPToolset(
            connection_params=SseConnectionParams(
                url="your-smithery-url.com",
                timeout=300,
            ),
        )
    ],
)
No need to manage API keys when using the hosted version - they’re configured through Smithery!

​
Advanced Configuration

  • Enable Proxies
  • Advanced Stealth
  • Custom Viewport
Enable Browserbase proxies for IP rotation and geo-location testing.
root_agent = Agent(
    model="gemini-2.5-pro",
    name="browserbase_agent",
    instruction="Help users get information from web pages using Browserbase",
    tools=[
        MCPToolset(
            connection_params=StdioConnectionParams(
                server_params=StdioServerParameters(
                    command="npx",
                    args=[
                        "-y",
                        "@browserbasehq/mcp-server-browserbase",
                        "--proxies",  # Enable proxies
                    ],
                    env={
                        "BROWSERBASE_API_KEY": BROWSERBASE_API_KEY,
                        "BROWSERBASE_PROJECT_ID": BROWSERBASE_PROJECT_ID,
                        "GEMINI_API_KEY": GEMINI_API_KEY,
                    }
                ),
                timeout=300,
            ),
        )
    ],
)

​
Verify Installation

Test your integration by running your agent: 
# Run your agent
result = root_agent.run("Navigate to google.com and take a screenshot")
print(result)
Monitor your browser sessions in real-time on the Browserbase Dashboard.

​
Available Tools

Once configured, your Google ADK agent will have access to these Browserbase tools:
  • browserbase_stagehand_navigate: Navigate to any URL in the browser
  • browserbase_stagehand_act: Perform actions using natural language
  • browserbase_stagehand_extract: Extract text content from pages
  • browserbase_stagehand_observe: Find actionable elements on pages
  • browserbase_screenshot: Capture page screenshots
  • browserbase_stagehand_get_url: Get the current page URL
  • browserbase_session_create: Create a new browser session
  • browserbase_session_close: Close the current session
See the full Tools Reference for detailed documentation.

​
Configuration Reference

The Browserbase MCP server accepts these command-line flags when using STDIO:
FlagDescription
--proxiesEnable Browserbase proxies for the session
--advancedStealthEnable Browserbase Advanced Stealth (Only for Scale Plan Users)
--keepAliveEnable Browserbase Keep Alive Session
--contextId <contextId>Specify a Browserbase Context ID to use
--persistWhether to persist the Browserbase context (default: true)
--port <port>Port to listen on for HTTP/SHTTP transport
--host <host>Host to bind server to (default: localhost, use 0.0.0.0 for all interfaces)
--cookies [json]JSON array of cookies to inject into the browser
--browserWidth <width>Browser viewport width (default: 1024)
--browserHeight <height>Browser viewport height (default: 768)
--modelName <model>The model to use for Stagehand (default: gemini-2.0-flash)
--modelApiKey <key>API key for the custom model provider (required when using custom models)
--experimentalEnable experimental features (default: false)
For detailed configuration options, see the Configuration Guide.

​
Additional Resources