Browser Automation MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MODEL_API_KEY | No | API key for the configured model provider (works with any provider) | |
| GEMINI_API_KEY | No | Alternative to MODEL_API_KEY for Gemini (the default model) | |
| OPENAI_API_KEY | No | Only needed for stagehand_demo_video (TTS via gpt-4o-mini-tts) | |
| NGROK_AUTHTOKEN | No | Only needed for cloud: true with localhost URLs | |
| BROWSERBASE_API_KEY | No | Only needed for cloud: true | |
| STAGEHAND_VARIABLES | No | Optional JSON map of variables auto-injected into stagehand_act, stagehand_agent, and stagehand_scenario | |
| BROWSERBASE_PROJECT_ID | No | Only needed for cloud: true | |
| VERCEL_AUTOMATION_BYPASS_SECRET | No | Optional, for Vercel preview deployments |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| resources | {
"subscribe": true,
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| stagehand_session_createA | Create a browser session and set it as active. Uses local Playwright by default; set cloud=true for Browserbase cloud. |
| stagehand_session_closeA | Close the current browser session and reset the active context. |
| stagehand_navigateA | Navigate to a URL in the browser. Only use this tool with URLs you're confident will work and be up to date. Otherwise, use https://google.com as the starting point. Supports localhost URLs when using cloud browser - automatically tunnels via ngrok. |
| stagehand_actB | Perform a single action on the page (e.g., click, type). |
| stagehand_extractA | Extract structured data or text from the current page using an instruction. |
| stagehand_observeB | Find interactive elements on the page from an instruction; optionally return an action. |
| stagehand_screenshotA | Capture a full-page screenshot and return it (and save as a resource). |
| stagehand_get_urlA | Return the current page URL (full URL with query/fragment). |
| stagehand_agentB | Execute a task autonomously using Stagehand agent in hybrid mode. The agent uses both DOM-based and coordinate-based actions for maximum reliability. |
| stagehand_scenarioA | Execute a multi-step test scenario (arrange/act/assert) using the Stagehand agent. Returns structured pass/fail/blocked results per assert step. |
| stagehand_run_scriptA | Run a Stagehand script (default export from defineScript) against the
current browser session. Accepts either a file |
| stagehand_demo_videoA | Record a narrated demo video of a known-good Stagehand script. Each action runs through stagehand.act with a CDP screencast attached; per-action narration is generated via OpenAI TTS; per-segment mp4s are concatenated into a single final.mp4. Uses the active Stagehand session — make sure the page is at the desired starting state before calling. Requires OPENAI_API_KEY. |
| agent_browser_helpA | Show help for agent-browser, a low-level browser automation CLI for precise, deterministic control. Call this to see available commands. |
| agent_browser_runA | Run a low-level browser command. Use over Stagehand when you need precise, deterministic control — element-by-ref interactions, DOM inspection, network debugging, JS evaluation. Shares the same browser session as Stagehand. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/PopoverAI/browser-automation'
If you have feedback or need assistance with the MCP directory API, please join our Discord server