Reliable browser-control MCP server for AI agents: click by ref, self-healing sessions.
Connect Runs on your machine
claude mcp add browser-ref-mcp -e BROWSER_MCP_CDP_URL=<BROWSER_MCP_CDP_URL> -e BROWSER_MCP_HEADLESS=<BROWSER_MCP_HEADLESS> -e BROWSER_MCP_PROFILE=<BROWSER_MCP_PROFILE> -e BROWSER_MCP_CHANNELS=<BROWSER_MCP_CHANNELS> -- npx -y [email protected]
{
"mcpServers": {
"browser-ref-mcp": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"BROWSER_MCP_CDP_URL": "<BROWSER_MCP_CDP_URL>",
"BROWSER_MCP_HEADLESS": "<BROWSER_MCP_HEADLESS>",
"BROWSER_MCP_PROFILE": "<BROWSER_MCP_PROFILE>",
"BROWSER_MCP_CHANNELS": "<BROWSER_MCP_CHANNELS>"
}
}
}
}
{
"mcpServers": {
"browser-ref-mcp": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"BROWSER_MCP_CDP_URL": "<BROWSER_MCP_CDP_URL>",
"BROWSER_MCP_HEADLESS": "<BROWSER_MCP_HEADLESS>",
"BROWSER_MCP_PROFILE": "<BROWSER_MCP_PROFILE>",
"BROWSER_MCP_CHANNELS": "<BROWSER_MCP_CHANNELS>"
}
}
}
}
{
"servers": {
"browser-ref-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"BROWSER_MCP_CDP_URL": "<BROWSER_MCP_CDP_URL>",
"BROWSER_MCP_HEADLESS": "<BROWSER_MCP_HEADLESS>",
"BROWSER_MCP_PROFILE": "<BROWSER_MCP_PROFILE>",
"BROWSER_MCP_CHANNELS": "<BROWSER_MCP_CHANNELS>"
}
}
}
}
Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
BROWSER_MCP_CDP_URLOptional | 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_HEADLESSOptional | Run without a visible browser window (default: headed, so the user can watch and take over). |
BROWSER_MCP_PROFILEOptional | Browser profile directory, keeps logins across sessions (default: ~/.browser-mcp/profile). |
BROWSER_MCP_CHANNELSOptional | Comma-separated browser channel fallback chain (default: chrome,msedge). |
Details
| Package | [email protected] (NPM, stdio) |
| First published | 16 Nov 2026 |
| Last updated | 16 Nov 2026 |
| Registry name | io.github.zy2755/browser-ref-mcp |
More browser automation servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.
