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.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →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
