Summary
Gives Claude programmatic control over a Playwright browser instance with a reference-based interaction model. You can capture screenshots, navigate pages, and interact with elements using ARIA references instead of raw selectors. The ref-based approach means you grab an accessible element reference and pass it to click, fill, or other interaction commands. Useful when you want Claude to debug web UIs, run visual regression checks, or automate browser workflows without maintaining brittle CSS selectors. Runs over stdio or streamable HTTP, so you can host it remotely or run it locally alongside your Node.js environment.
Keeps your Mac awake while Claude Code, Codex or Cursor works. Lets it sleep when they are done.
Try free for 7 days →
Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →
Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →Featured
Keeps your Mac awake while Claude Code, Codex or Cursor works. Lets it sleep when they are done.
Try free for 7 days →Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →Configuration
PLATFORMPlatform: browser (default) or node for Node.js backend debugging.
PORTPort for HTTP transport.
SESSION_IDLE_SECONDSIdle session timeout (seconds).
SESSION_IDLE_CHECK_SECONDSInterval for checking idle sessions (seconds).
SESSION_CLOSE_ON_SOCKET_CLOSEClose session when socket closes.
CONSOLE_MESSAGES_BUFFER_SIZEMaximum console messages to buffer.
HTTP_REQUESTS_BUFFER_SIZEMaximum HTTP requests to buffer.
BROWSER_SERVER_INSTRUCTIONS_ENABLEWhen true, include server instructions in MCP server info (browser platform). Default: true.
BROWSER_POLICY_UI_DEBUGGING_ENABLEWhen true, include UI_DEBUGGING_POLICY in server policies (browser platform). Default: false.
BROWSER_HEADLESS_ENABLERun browser in headless mode.
BROWSER_PERSISTENT_ENABLEUse persistent browser context (preserves cookies, localStorage, extensions).
BROWSER_CDP_ENDPOINT_URLCDP attach: http(s) root or ws(s) URL. Resolves via /json/version, /json/list, or ws /devtools/browser (Chrome 136+). Mutually exclusive with BROWSER_PERSISTENT_ENABLE.
BROWSER_CDP_ENABLEWhen true and no BROWSER_CDP_ENDPOINT_URL: probe 127.0.0.1:9222 then :9229 for CDP. Else use BROWSER_CDP_ENDPOINT_URL or default http://127.0.0.1:9222.
BROWSER_CDP_OPEN_INSPECTOn loopback CDP failure, if Chrome is running, open chrome://inspect/#remote-debugging. Default true. Set false to disable.
BROWSER_PERSISTENT_USER_DATA_DIRDirectory for persistent browser context user data.
BROWSER_USE_INSTALLED_ON_SYSTEMUse system-installed Chrome browser instead of Playwright's bundled browser.
BROWSER_EXECUTABLE_PATHCustom browser executable path.
BROWSER_CHROMIUM_SANDBOXWhen false, launches Chromium with --no-sandbox. Required for Docker/Lambda/CI.
BROWSER_LAUNCH_ARGSExtra Chromium launch args (comma-separated).
BROWSER_ALLOWED_DOMAINSComma-separated list of allowed hostnames. When set, all requests to non-matching hosts are aborted. Subdomains match automatically.
BROWSER_LOCALEBrowser locale (e.g., "en-US", "tr-TR").
OTEL_ENABLEEnable OpenTelemetry integration.
OTEL_SERVICE_NAMEOpenTelemetry service name.
OTEL_SERVICE_VERSIONOpenTelemetry service version.
Categories
Registryactive
Packagebrowser-devtools-mcp
TransportSTDIO, HTTP
AuthRequired
UpdatedMay 12, 2026
