Reliable browser-control MCP server for AI agents: click by ref, self-healing sessions.
Maintain this server? Claim it
This server only runs locally, from a package. Install it with the instructions on this page to try it.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add browser-ref-mcp \ -- npx -y [email protected]
Environment
BROWSER_MCP_CDP_URL (optional, not in the config above): Connect to a browser already running with a debug port, e.g. http://127.0.0.1:9222. Leave unset to launch your own Chrome/Edge.BROWSER_MCP_HEADLESS (optional, not in the config above): Run without a visible browser window (default: headed, so the user can watch and take over).BROWSER_MCP_PROFILE (optional, not in the config above): Browser profile directory, keeps logins across sessions (default: ~/.browser-mcp/profile).BROWSER_MCP_CHANNELS (optional, not in the config above): Comma-separated browser channel fallback chain (default: chrome,msedge).We don't run packages, so we can't list this server's tools.