MCP Server
Browserbase MCP Server Tools
This guide covers the specialized tools available in the Browserbase MCP server for browser automation and interaction.
Overview
The Browserbase MCP server provides comprehensive tools for browser automation and session management. These tools allow you to perform actions like navigating pages, capturing screenshots, manipulating cookies, and managing multiple browser sessions simultaneously.Core Browser Automation Tools
These are the primary tools for modern web automation using natural language commands.browserbase_stagehand_navigate
browserbase_stagehand_navigate
browserbase_stagehand_act
browserbase_stagehand_act
Perform an action on the web page using natural language
The action to perform (e.g., “click the login button”, “fill form field”)
browserbase_stagehand_extract
browserbase_stagehand_extract
Extract all text content from the current page (filters out CSS and JavaScript)
No input parameters required
Extracted text content from the current page
browserbase_stagehand_observe
browserbase_stagehand_observe
Observe and find actionable elements on the web page
Specific instruction for observation (e.g., “find the login button”, “locate search form”)
browserbase_screenshot
browserbase_screenshot
Capture a PNG screenshot of the current page
No input parameters required
Base-64 encoded PNG data
Single Session Management
Traditional approach with one active browser session. Simpler for basic automation tasks and automatically manages the active session.browserbase_session_create
browserbase_session_create
Create or reuse a cloud browser session using Browserbase with fully initialized Stagehand
Optional session ID to use/reuse. If not provided, creates new session
browserbase_session_close
browserbase_session_close
Close the current Browserbase session, disconnect the browser, and cleanup Stagehand instance
No input parameters required
Multi-Session Management
Advanced approach with multiple parallel browser sessions for complex automation workflows. Each session maintains independent state, cookies, and browser context.Session Lifecycle Management
multi_browserbase_stagehand_session_create
multi_browserbase_stagehand_session_create
Create a new independent Stagehand browser session with full web automation capabilities
Human-readable name for tracking (e.g., ‘login-flow’, ‘data-scraping’)
multi_browserbase_stagehand_session_list
multi_browserbase_stagehand_session_list
List all currently active Stagehand browser sessions with detailed metadata
No input parameters required
multi_browserbase_stagehand_session_close
multi_browserbase_stagehand_session_close
Close and clean up a specific Stagehand browser session
Exact session ID to close (cannot be undone)
Session-Specific Automation Tools
All core browser automation tools are available with session-specific variants:multi_browserbase_stagehand_navigate_session
multi_browserbase_stagehand_navigate_session
multi_browserbase_stagehand_act_session
multi_browserbase_stagehand_act_session
multi_browserbase_stagehand_extract_session
multi_browserbase_stagehand_extract_session
multi_browserbase_stagehand_observe_session
multi_browserbase_stagehand_observe_session
Multi-Session Use Cases
Parallel Data Collection
Run multiple scraping sessions simultaneously across different websites
A/B Testing
Compare user flows across different browser sessions with varying configurations
Cross-Site Operations
Perform coordinated actions across multiple websites or applications
Backup Sessions
Keep fallback sessions ready in case primary sessions encounter issues
Resources
Screenshot Resources
The server provides access to screenshot resources with URI-based access.example: