Skip to main content
Glama
PopoverAI

Browser Automation MCP

by PopoverAI

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
MODEL_API_KEYNoAPI key for the configured model provider (works with any provider)
GEMINI_API_KEYNoAlternative to MODEL_API_KEY for Gemini (the default model)
OPENAI_API_KEYNoOnly needed for stagehand_demo_video (TTS via gpt-4o-mini-tts)
NGROK_AUTHTOKENNoOnly needed for cloud: true with localhost URLs
BROWSERBASE_API_KEYNoOnly needed for cloud: true
STAGEHAND_VARIABLESNoOptional JSON map of variables auto-injected into stagehand_act, stagehand_agent, and stagehand_scenario
BROWSERBASE_PROJECT_IDNoOnly needed for cloud: true
VERCEL_AUTOMATION_BYPASS_SECRETNoOptional, for Vercel preview deployments

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": true
}
resources
{
  "subscribe": true,
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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 path or inline source — exactly one. Returns {status: "passed"|"failed", durationMs}. On failure also returns error and stack. Use after authoring a script to validate it; the MCP's live session is reused, so no separate setup is required. Inline source mode resolves bare imports against the MCP's own node_modules (no install needed); path mode resolves from the script's project.

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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

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