Home › Browser Automation & Scraping › browser-ref-mcp

browser-ref-mcp

Reliable browser-control MCP server for AI agents: click by ref, self-healing sessions.

TypeScript Local macOSWindowsLinux
★ 1 stars Last pushed 2026-11-17 License: Apache-2.0

Topics: Browser Automation

Connect

Review any command before running it. Package names and URLs come from the server's own registry entry.

Package (npm 0.2.0)

npx -y [email protected]

Or add to your MCP client config:

{
  "mcpServers": {
    "browser-ref-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ]
    }
  }
}
  • BROWSER_MCP_CDP_URL — 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 — Run without a visible browser window (default: headed, so the user can watch and take over).
  • BROWSER_MCP_PROFILE — Browser profile directory, keeps logins across sessions (default: ~/.browser-mcp/profile).
  • BROWSER_MCP_CHANNELS — Comma-separated browser channel fallback chain (default: chrome,msedge).

Related servers

Listed in punkpeye/awesome-mcp-servers (MIT)

Data from the Official MCP Registry