browser-devtools-mcp

Playwright browser & Node.js MCP. ARIA refs, screenshots, ref-based interactions.

Hosted

communityapplication

Deployment

Hosted

streamable-httphttps://{your_mcp_server_host}/mcp

Package Details

browser-devtools-mcp

0.2.26•https://www.npmjs.com/package/browser-devtools-mcp

Transportstdio

Environment Variables

PLATFORM(str)

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

PORT(num)

Port for HTTP transport.

SESSION_IDLE_SECONDS(num)

Idle session timeout (seconds).

SESSION_IDLE_CHECK_SECONDS(num)

Interval for checking idle sessions (seconds).

SESSION_CLOSE_ON_SOCKET_CLOSE(bool)

Close session when socket closes.

CONSOLE_MESSAGES_BUFFER_SIZE(num)

Maximum console messages to buffer.

HTTP_REQUESTS_BUFFER_SIZE(num)

Maximum HTTP requests to buffer.

BROWSER_HEADLESS_ENABLE(bool)

Run browser in headless mode.

BROWSER_PERSISTENT_ENABLE(bool)

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

BROWSER_PERSISTENT_USER_DATA_DIR(str)

Directory for persistent browser context user data.

BROWSER_USE_INSTALLED_ON_SYSTEM(bool)

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

BROWSER_EXECUTABLE_PATH(str)

Custom browser executable path.

BROWSER_LOCALE(str)

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

OTEL_ENABLE(bool)

Enable OpenTelemetry integration.

OTEL_SERVICE_NAME(str)

OpenTelemetry service name.

OTEL_SERVICE_VERSION(str)

OpenTelemetry service version.

OTEL_ASSETS_DIR(str)

Directory containing OpenTelemetry bundle files.

OTEL_INSTRUMENTATION_USER_INTERACTION_EVENTS(str)

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

OTEL_EXPORTER_TYPE(str)

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

OTEL_EXPORTER_HTTP_URL(str)

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

OTEL_EXPORTER_HTTP_HEADERS(str)

Secret

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

AWS_REGION(str)

AWS region for Bedrock usage.

AWS_PROFILE(str)

AWS profile name for Bedrock usage.

AMAZON_BEDROCK_ENABLE(bool)

Enable Amazon Bedrock usage.

AMAZON_BEDROCK_IMAGE_EMBED_MODEL_ID(str)

Amazon Bedrock image embedding model ID.

AMAZON_BEDROCK_TEXT_EMBED_MODEL_ID(str)

Amazon Bedrock text embedding model ID.

AMAZON_BEDROCK_VISION_MODEL_ID(str)

Amazon Bedrock vision model ID.

FIGMA_ACCESS_TOKEN(str)

Secret

Figma API access token for design comparison.

FIGMA_API_BASE_URL(str)

Figma API base URL.

DAEMON_PORT(num)

Daemon mode port (CLI).

DAEMON_SESSION_IDLE_SECONDS(num)

Daemon mode idle session timeout (seconds).

DAEMON_SESSION_IDLE_CHECK_SECONDS(num)

Daemon mode idle session check interval (seconds).

NODE_INSPECTOR_HOST(str)

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

TOOL_OUTPUT_SCHEMA_DISABLE(bool)

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

AVAILABLE_TOOL_DOMAINS(str)

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.