browser-devtools-mcp MCP Server

Connect to browser-devtools-mcp

Hosted endpoint — paste into any MCP client.

Environment variables

Configuration this server reads at startup.

• PLATFORM

  Platform: browser (default) or node for Node.js backend debugging.

• PORT

  Port for HTTP transport.

• SESSION_IDLE_SECONDS

  Idle session timeout (seconds).

• SESSION_IDLE_CHECK_SECONDS

  Interval for checking idle sessions (seconds).

• SESSION_CLOSE_ON_SOCKET_CLOSE

  Close session when socket closes.

• CONSOLE_MESSAGES_BUFFER_SIZE

  Maximum console messages to buffer.

• HTTP_REQUESTS_BUFFER_SIZE

  Maximum HTTP requests to buffer.

• BROWSER_SERVER_INSTRUCTIONS_ENABLE

  When true, include server instructions in MCP server info (browser platform). Default: true.

• BROWSER_POLICY_UI_DEBUGGING_ENABLE

  When true, include UI_DEBUGGING_POLICY in server policies (browser platform). Default: false.

• BROWSER_HEADLESS_ENABLE

  Run browser in headless mode.

• BROWSER_PERSISTENT_ENABLE

  Use persistent browser context (preserves cookies, localStorage, extensions).

• BROWSER_CDP_ENDPOINT_URL

  CDP 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_ENABLE

  When 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_INSPECT

  On loopback CDP failure, if Chrome is running, open chrome://inspect/#remote-debugging. Default true. Set false to disable.

• BROWSER_PERSISTENT_USER_DATA_DIR

  Directory for persistent browser context user data.

• BROWSER_USE_INSTALLED_ON_SYSTEM

  Use system-installed Chrome browser instead of Playwright's bundled browser.

• BROWSER_EXECUTABLE_PATH

  Custom browser executable path.

• BROWSER_LOCALE

  Browser locale (e.g., "en-US", "tr-TR").

• OTEL_ENABLE

  Enable OpenTelemetry integration.

• OTEL_SERVICE_NAME

  OpenTelemetry service name.

• OTEL_SERVICE_VERSION

  OpenTelemetry service version.

• OTEL_ASSETS_DIR

  Directory containing OpenTelemetry bundle files.

• OTEL_INSTRUMENTATION_USER_INTERACTION_EVENTS

  User interaction events to instrument (comma-separated, e.g., "click,submit").

• OTEL_EXPORTER_TYPE

  OpenTelemetry exporter type: "otlp/http", "console", or "none".

• OTEL_EXPORTER_HTTP_URL

  OpenTelemetry collector base URL (e.g., "http://localhost:4318").

• OTEL_EXPORTER_HTTP_HEADERSSecret

  OpenTelemetry exporter HTTP headers (comma-separated key=value pairs).

• AWS_REGION

  AWS region for Bedrock usage.

• AWS_PROFILE

  AWS profile name for Bedrock usage.

• AMAZON_BEDROCK_ENABLE

  Enable Amazon Bedrock usage.

• AMAZON_BEDROCK_IMAGE_EMBED_MODEL_ID

  Amazon Bedrock image embedding model ID.

• AMAZON_BEDROCK_TEXT_EMBED_MODEL_ID

  Amazon Bedrock text embedding model ID.

• AMAZON_BEDROCK_VISION_MODEL_ID

  Amazon Bedrock vision model ID.

• FIGMA_ACCESS_TOKENSecret

  Figma API access token for design comparison.

• FIGMA_API_BASE_URL

  Figma API base URL.

• DAEMON_PORT

  Daemon mode port (CLI).

• DAEMON_SESSION_IDLE_SECONDS

  Daemon mode idle session timeout (seconds).

• DAEMON_SESSION_IDLE_CHECK_SECONDS

  Daemon mode idle session check interval (seconds).

• NODE_SERVER_INSTRUCTIONS_ENABLE

  When true, include server instructions in MCP server info (node platform). Default: true.

• NODE_POLICY_DEBUGGING_ENABLE

  When true, include NODE_DEBUGGING_POLICY in server policies (node platform). Default: false.

• NODE_INSPECTOR_HOST

  Inspector host for debug_connect when MCP runs in Docker (e.g. host.docker.internal). Default: 127.0.0.1.

• TOOL_OUTPUT_SCHEMA_DISABLE

  When true, omit tool output schema from MCP tool registration (can reduce token usage for some clients).

• AVAILABLE_TOOL_DOMAINS

  Comma-separated tool domains to enable (e.g. navigation,interaction,a11y). Unset = all tools. Browser: a11y, content, debug, figma, interaction, navigation, o11y, react, run, stub, sync. Node: debug, run.

Resources

Where to find authoritative docs and source for browser-devtools-mcp.

• Source repository