What it does
browserstage is a snapshot-driven browser automation tool, provided as both a CLI and a stdio MCP server in one binary. It navigates to a page, captures an accessibility snapshot, and then acts on elements using the references in that snapshot. Supported actions include clicking, hovering, dragging, dropping, typing, filling whole forms, selecting options, pressing keys, uploading files and handling dialogs. It also reads console messages and network requests, and it can list, create, close and select tabs. The MCP server exposes 24 core tools, including navigate, snapshot, click, type, fill_form, take_screenshot, evaluate, wait_for and resize.
It suits workflows where a script or an MCP client needs to interact with web pages step by step, such as completing forms, selecting options from menus, or checking console output and network requests during a session.
The package bundles no browser and downloads none. A deployment must inject a Playwright-compatible executor through the StageBrowser interface in src/types.ts to drive a real browser. The CLI exits with 0 on success, 1 on a browser error and 2 on a usage error. The README also covers Docker and development setup, and the project is released under the MIT license.
Limitations and requirements
Browser commands need a Playwright-compatible executor injected by the deployment; without one they fail with a 'Browser unavailable' error. The browser_run_code_unsafe tool runs arbitrary code against the page, so it should be enabled only where arbitrary code would be run anyway.
Safety
Our team has not reviewed this resource. Only automated rules checked it; resources with high-risk signals are not published. These are signals, not a guarantee that installing it is safe. Try it in a sandbox project first.
- Runs code or changes an assistant's behaviour
Sources
- Official MCP Registry first seen 13 Nov 2026 · last seen 13 Nov 2026 · its page on the source
io.github.CloudCorpRecords/browserstage
Automate a browser with accessibility snapshots: navigate, click, type, fill and wait.
v0.1.0As shown on registry.modelcontextprotocol.io when we last read it