Browser Devtools MCP
Rank #442io.github.serkan-ozal/browser-devtools-mcp
Playwright browser & Node.js MCP. ARIA refs, screenshots, ref-based interactions.
What you can do with Browser Devtools MCP
Browser DevTools MCP is a Playwright-powered server that gives coding assistants browser automation and debugging (ARIA snapshots, ref-based interactions, screenshots, console and HTTP observability, request stubbing) plus a Node.js debugging platform. The package is marked deprecated and renamed to @ironbee-ai/devtools.
- Navigate and interact with pages via ARIA refs
- Capture screenshots, HTML, text, PDFs and recordings
- Read console messages, HTTP requests and web vitals
- Intercept and mock HTTP requests
- Attach to a running Chrome over CDP
- Debug a Node.js process with tracepoints and logpoints
What Browser Devtools MCP can and cannot do
Browser tools grouped by prefix: content_*, interaction_*, navigation_*, o11y_*, a11y_*, sync_*, stub_* and an execute tool for scripted multi-step runs; a separate node platform exposes debug_* tools. React, scenario and Figma comparison tools are also described.
- navigation_go-to
- navigation_go-back-or-forward
- navigation_reload
- interaction_click
- interaction_fill
- interaction_hover
- interaction_press-key
- interaction_select
- interaction_drag
- interaction_scroll
- interaction_resize-viewport
- interaction_resize-window
- content_take-screenshot
- content_get-as-html
- content_get-as-text
- content_save-as-pdf
- content_start-recording
- content_stop-recording
- o11y_get-console-messages
- o11y_get-http-requests
- o11y_get-web-vitals
- a11y_take-aria-snapshot
- a11y_take-ax-tree-snapshot
- sync_wait-for-network-idle
- stub_intercept-http-request
- execute
- debug_connect
- debug_resolve-source-location
- The npm package is deprecated and no longer maintained; future releases ship as @ironbee-ai/devtools
- execute scripts cannot use require, import, process, fs, Buffer or fetch; at most 50 callTool invocations
- Element refs are valid only until the next ARIA snapshot or navigation
- Window resizing works best on Chromium and fails on Firefox/WebKit; CDP attach is Chromium-only and does not start Chrome
- React tools need BROWSER_PERSISTENT_ENABLE=true and a manually installed React DevTools extension
What you need before using Browser Devtools MCP
The registry listing declares no required environment variables or authentication. This is declared metadata, not a verified install — the repository README is the authority.
MCP Toplist probed the public endpoint on Oct 12, 2026 and could not complete the MCP handshake (dns failure). Requirements remain unverified.
Declared by Glama, last synced Oct 16, 2026. Not independently verified by MCP Toplist.
- Runtime
- Node.js 18+ with npx (npx -y browser-devtools-mcp)
- Also needed
- Playwright browsers are not downloaded at install; run npx playwright install chromium (or set BROWSER_DEVTOOLS_INSTALL_CHROMIUM=true)
- PLATFORM · optional
- PORT · optional
- SESSION_IDLE_SECONDS · optional
- SESSION_IDLE_CHECK_SECONDS · optional
- SESSION_CLOSE_ON_SOCKET_CLOSE · optional
- CONSOLE_MESSAGES_BUFFER_SIZE · optional
- HTTP_REQUESTS_BUFFER_SIZE · optional
- BROWSER_SERVER_INSTRUCTIONS_ENABLE · optional
- BROWSER_POLICY_UI_DEBUGGING_ENABLE · optional
- BROWSER_HEADLESS_ENABLE · optional
- BROWSER_PERSISTENT_ENABLE · optional
- BROWSER_CDP_ENDPOINT_URL · optional
- BROWSER_CDP_ENABLE · optional
- BROWSER_CDP_OPEN_INSPECT · optional
- BROWSER_PERSISTENT_USER_DATA_DIR · optional
- BROWSER_USE_INSTALLED_ON_SYSTEM · optional
- BROWSER_EXECUTABLE_PATH · optional
- BROWSER_CHROMIUM_SANDBOX · optional
- BROWSER_LAUNCH_ARGS · optional
- BROWSER_ALLOWED_DOMAINS · optional
- BROWSER_LOCALE · optional
- OTEL_ENABLE · optional
- OTEL_SERVICE_NAME · optional
- OTEL_SERVICE_VERSION · optional
- OTEL_ASSETS_DIR · optional
- OTEL_INSTRUMENTATION_USER_INTERACTION_EVENTS · optional
- OTEL_EXPORTER_TYPE · optional
- OTEL_EXPORTER_HTTP_URL · optional
- OTEL_EXPORTER_HTTP_HEADERS · optional
- AWS_REGION · optional
- AWS_PROFILE · optional
- AMAZON_BEDROCK_ENABLE · optional
- AMAZON_BEDROCK_IMAGE_EMBED_MODEL_ID · optional
- AMAZON_BEDROCK_TEXT_EMBED_MODEL_ID · optional
- AMAZON_BEDROCK_VISION_MODEL_ID · optional
- FIGMA_ACCESS_TOKEN · optional
- FIGMA_API_BASE_URL · optional
- DAEMON_PORT · optional
- DAEMON_SESSION_IDLE_SECONDS · optional
- DAEMON_SESSION_IDLE_CHECK_SECONDS · optional
- NODE_SERVER_INSTRUCTIONS_ENABLE · optional
- NODE_POLICY_DEBUGGING_ENABLE · optional
- NODE_INSPECTOR_HOST · optional
- TOOL_OUTPUT_SCHEMA_DISABLE · optional
- AVAILABLE_TOOL_DOMAINS · optional
- WORKING_DIR · optional
- SEARCH_STRATEGY · optional
- SCENARIO_SEARCH_STRATEGY · optional
Hosted endpoint declared as public.
Connect Browser Devtools MCP and confirm it works
- Add command npx with args ["-y", "browser-devtools-mcp"] under mcpServers (the deprecation notice points to @ironbee-ai/devtools instead)
- Install a browser with npx playwright install chromium (--with-deps on Linux)
- Set BROWSER_HEADLESS_ENABLE=false to see the window, or BROWSER_CDP_ENABLE=true to attach to a Chrome running with remote debugging
claude mcp add --transport http browser-devtools-mcp https://{your_mcp_server_host}/mcpclaude mcp add browser-devtools-mcp -e "PLATFORM=<your PLATFORM>" -e "PORT=<your PORT>" -e "SESSION_IDLE_SECONDS=<your SESSION_IDLE_SECONDS>" -e "SESSION_IDLE_CHECK_SECONDS=<your SESSION_IDLE_CHECK_SECONDS>" -e "SESSION_CLOSE_ON_SOCKET_CLOSE=<your SESSION_CLOSE_ON_SOCKET_CLOSE>" -e "CONSOLE_MESSAGES_BUFFER_SIZE=<your CONSOLE_MESSAGES_BUFFER_SIZE>" -e "HTTP_REQUESTS_BUFFER_SIZE=<your HTTP_REQUESTS_BUFFER_SIZE>" -e "BROWSER_SERVER_INSTRUCTIONS_ENABLE=<your BROWSER_SERVER_INSTRUCTIONS_ENABLE>" -e "BROWSER_POLICY_UI_DEBUGGING_ENABLE=<your BROWSER_POLICY_UI_DEBUGGING_ENABLE>" -e "BROWSER_HEADLESS_ENABLE=<your BROWSER_HEADLESS_ENABLE>" -e "BROWSER_PERSISTENT_ENABLE=<your BROWSER_PERSISTENT_ENABLE>" -e "BROWSER_CDP_ENDPOINT_URL=<your BROWSER_CDP_ENDPOINT_URL>" -e "BROWSER_CDP_ENABLE=<your BROWSER_CDP_ENABLE>" -e "BROWSER_CDP_OPEN_INSPECT=<your BROWSER_CDP_OPEN_INSPECT>" -e "BROWSER_PERSISTENT_USER_DATA_DIR=<your BROWSER_PERSISTENT_USER_DATA_DIR>" -e "BROWSER_USE_INSTALLED_ON_SYSTEM=<your BROWSER_USE_INSTALLED_ON_SYSTEM>" -e "BROWSER_EXECUTABLE_PATH=<your BROWSER_EXECUTABLE_PATH>" -e "BROWSER_CHROMIUM_SANDBOX=<your BROWSER_CHROMIUM_SANDBOX>" -e "BROWSER_LAUNCH_ARGS=<your BROWSER_LAUNCH_ARGS>" -e "BROWSER_ALLOWED_DOMAINS=<your BROWSER_ALLOWED_DOMAINS>" -e "BROWSER_LOCALE=<your BROWSER_LOCALE>" -e "OTEL_ENABLE=<your OTEL_ENABLE>" -e "OTEL_SERVICE_NAME=<your OTEL_SERVICE_NAME>" -e "OTEL_SERVICE_VERSION=<your OTEL_SERVICE_VERSION>" -e "OTEL_ASSETS_DIR=<your OTEL_ASSETS_DIR>" -e "OTEL_INSTRUMENTATION_USER_INTERACTION_EVENTS=<your OTEL_INSTRUMENTATION_USER_INTERACTION_EVENTS>" -e "OTEL_EXPORTER_TYPE=<your OTEL_EXPORTER_TYPE>" -e "OTEL_EXPORTER_HTTP_URL=<your OTEL_EXPORTER_HTTP_URL>" -e "OTEL_EXPORTER_HTTP_HEADERS=<your OTEL_EXPORTER_HTTP_HEADERS>" -e "AWS_REGION=<your AWS_REGION>" -e "AWS_PROFILE=<your AWS_PROFILE>" -e "AMAZON_BEDROCK_ENABLE=<your AMAZON_BEDROCK_ENABLE>" -e "AMAZON_BEDROCK_IMAGE_EMBED_MODEL_ID=<your AMAZON_BEDROCK_IMAGE_EMBED_MODEL_ID>" -e "AMAZON_BEDROCK_TEXT_EMBED_MODEL_ID=<your AMAZON_BEDROCK_TEXT_EMBED_MODEL_ID>" -e "AMAZON_BEDROCK_VISION_MODEL_ID=<your AMAZON_BEDROCK_VISION_MODEL_ID>" -e "FIGMA_ACCESS_TOKEN=<your FIGMA_ACCESS_TOKEN>" -e "FIGMA_API_BASE_URL=<your FIGMA_API_BASE_URL>" -e "DAEMON_PORT=<your DAEMON_PORT>" -e "DAEMON_SESSION_IDLE_SECONDS=<your DAEMON_SESSION_IDLE_SECONDS>" -e "DAEMON_SESSION_IDLE_CHECK_SECONDS=<your DAEMON_SESSION_IDLE_CHECK_SECONDS>" -e "NODE_SERVER_INSTRUCTIONS_ENABLE=<your NODE_SERVER_INSTRUCTIONS_ENABLE>" -e "NODE_POLICY_DEBUGGING_ENABLE=<your NODE_POLICY_DEBUGGING_ENABLE>" -e "NODE_INSPECTOR_HOST=<your NODE_INSPECTOR_HOST>" -e "TOOL_OUTPUT_SCHEMA_DISABLE=<your TOOL_OUTPUT_SCHEMA_DISABLE>" -e "AVAILABLE_TOOL_DOMAINS=<your AVAILABLE_TOOL_DOMAINS>" -e "WORKING_DIR=<your WORKING_DIR>" -e "SEARCH_STRATEGY=<your SEARCH_STRATEGY>" -e "SCENARIO_SEARCH_STRATEGY=<your SCENARIO_SEARCH_STRATEGY>" -- npx -y browser-devtools-mcpReplace each placeholder with your own value before saving.
[mcp_servers.browser-devtools-mcp]
url = "https://{your_mcp_server_host}/mcp"Add to ~/.codex/config.toml.
[mcp_servers.browser-devtools-mcp]
command = "npx"
args = ["-y", "browser-devtools-mcp"]
[mcp_servers.browser-devtools-mcp.env]
PLATFORM = "<your PLATFORM>"
PORT = "<your PORT>"
SESSION_IDLE_SECONDS = "<your SESSION_IDLE_SECONDS>"
SESSION_IDLE_CHECK_SECONDS = "<your SESSION_IDLE_CHECK_SECONDS>"
SESSION_CLOSE_ON_SOCKET_CLOSE = "<your SESSION_CLOSE_ON_SOCKET_CLOSE>"
CONSOLE_MESSAGES_BUFFER_SIZE = "<your CONSOLE_MESSAGES_BUFFER_SIZE>"
HTTP_REQUESTS_BUFFER_SIZE = "<your HTTP_REQUESTS_BUFFER_SIZE>"
BROWSER_SERVER_INSTRUCTIONS_ENABLE = "<your BROWSER_SERVER_INSTRUCTIONS_ENABLE>"
BROWSER_POLICY_UI_DEBUGGING_ENABLE = "<your BROWSER_POLICY_UI_DEBUGGING_ENABLE>"
BROWSER_HEADLESS_ENABLE = "<your BROWSER_HEADLESS_ENABLE>"
BROWSER_PERSISTENT_ENABLE = "<your BROWSER_PERSISTENT_ENABLE>"
BROWSER_CDP_ENDPOINT_URL = "<your BROWSER_CDP_ENDPOINT_URL>"
BROWSER_CDP_ENABLE = "<your BROWSER_CDP_ENABLE>"
BROWSER_CDP_OPEN_INSPECT = "<your BROWSER_CDP_OPEN_INSPECT>"
BROWSER_PERSISTENT_USER_DATA_DIR = "<your BROWSER_PERSISTENT_USER_DATA_DIR>"
BROWSER_USE_INSTALLED_ON_SYSTEM = "<your BROWSER_USE_INSTALLED_ON_SYSTEM>"
BROWSER_EXECUTABLE_PATH = "<your BROWSER_EXECUTABLE_PATH>"
BROWSER_CHROMIUM_SANDBOX = "<your BROWSER_CHROMIUM_SANDBOX>"
BROWSER_LAUNCH_ARGS = "<your BROWSER_LAUNCH_ARGS>"
BROWSER_ALLOWED_DOMAINS = "<your BROWSER_ALLOWED_DOMAINS>"
BROWSER_LOCALE = "<your BROWSER_LOCALE>"
OTEL_ENABLE = "<your OTEL_ENABLE>"
OTEL_SERVICE_NAME = "<your OTEL_SERVICE_NAME>"
OTEL_SERVICE_VERSION = "<your OTEL_SERVICE_VERSION>"
OTEL_ASSETS_DIR = "<your OTEL_ASSETS_DIR>"
OTEL_INSTRUMENTATION_USER_INTERACTION_EVENTS = "<your OTEL_INSTRUMENTATION_USER_INTERACTION_EVENTS>"
OTEL_EXPORTER_TYPE = "<your OTEL_EXPORTER_TYPE>"
OTEL_EXPORTER_HTTP_URL = "<your OTEL_EXPORTER_HTTP_URL>"
OTEL_EXPORTER_HTTP_HEADERS = "<your OTEL_EXPORTER_HTTP_HEADERS>"
AWS_REGION = "<your AWS_REGION>"
AWS_PROFILE = "<your AWS_PROFILE>"
AMAZON_BEDROCK_ENABLE = "<your AMAZON_BEDROCK_ENABLE>"
AMAZON_BEDROCK_IMAGE_EMBED_MODEL_ID = "<your AMAZON_BEDROCK_IMAGE_EMBED_MODEL_ID>"
AMAZON_BEDROCK_TEXT_EMBED_MODEL_ID = "<your AMAZON_BEDROCK_TEXT_EMBED_MODEL_ID>"
AMAZON_BEDROCK_VISION_MODEL_ID = "<your AMAZON_BEDROCK_VISION_MODEL_ID>"
FIGMA_ACCESS_TOKEN = "<your FIGMA_ACCESS_TOKEN>"
FIGMA_API_BASE_URL = "<your FIGMA_API_BASE_URL>"
DAEMON_PORT = "<your DAEMON_PORT>"
DAEMON_SESSION_IDLE_SECONDS = "<your DAEMON_SESSION_IDLE_SECONDS>"
DAEMON_SESSION_IDLE_CHECK_SECONDS = "<your DAEMON_SESSION_IDLE_CHECK_SECONDS>"
NODE_SERVER_INSTRUCTIONS_ENABLE = "<your NODE_SERVER_INSTRUCTIONS_ENABLE>"
NODE_POLICY_DEBUGGING_ENABLE = "<your NODE_POLICY_DEBUGGING_ENABLE>"
NODE_INSPECTOR_HOST = "<your NODE_INSPECTOR_HOST>"
TOOL_OUTPUT_SCHEMA_DISABLE = "<your TOOL_OUTPUT_SCHEMA_DISABLE>"
AVAILABLE_TOOL_DOMAINS = "<your AVAILABLE_TOOL_DOMAINS>"
WORKING_DIR = "<your WORKING_DIR>"
SEARCH_STRATEGY = "<your SEARCH_STRATEGY>"
SCENARIO_SEARCH_STRATEGY = "<your SCENARIO_SEARCH_STRATEGY>"Add to ~/.codex/config.toml. Replace each placeholder with your own value before saving.
https://{your_mcp_server_host}/mcpSettings → Connectors → “Add custom connector”, then paste this URL.
{
"mcpServers": {
"browser-devtools-mcp": {
"command": "npx",
"args": [
"-y",
"browser-devtools-mcp"
],
"env": {
"PLATFORM": "<your PLATFORM>",
"PORT": "<your PORT>",
"SESSION_IDLE_SECONDS": "<your SESSION_IDLE_SECONDS>",
"SESSION_IDLE_CHECK_SECONDS": "<your SESSION_IDLE_CHECK_SECONDS>",
"SESSION_CLOSE_ON_SOCKET_CLOSE": "<your SESSION_CLOSE_ON_SOCKET_CLOSE>",
"CONSOLE_MESSAGES_BUFFER_SIZE": "<your CONSOLE_MESSAGES_BUFFER_SIZE>",
"HTTP_REQUESTS_BUFFER_SIZE": "<your HTTP_REQUESTS_BUFFER_SIZE>",
"BROWSER_SERVER_INSTRUCTIONS_ENABLE": "<your BROWSER_SERVER_INSTRUCTIONS_ENABLE>",
"BROWSER_POLICY_UI_DEBUGGING_ENABLE": "<your BROWSER_POLICY_UI_DEBUGGING_ENABLE>",
"BROWSER_HEADLESS_ENABLE": "<your BROWSER_HEADLESS_ENABLE>",
"BROWSER_PERSISTENT_ENABLE": "<your BROWSER_PERSISTENT_ENABLE>",
"BROWSER_CDP_ENDPOINT_URL": "<your BROWSER_CDP_ENDPOINT_URL>",
"BROWSER_CDP_ENABLE": "<your BROWSER_CDP_ENABLE>",
"BROWSER_CDP_OPEN_INSPECT": "<your BROWSER_CDP_OPEN_INSPECT>",
"BROWSER_PERSISTENT_USER_DATA_DIR": "<your BROWSER_PERSISTENT_USER_DATA_DIR>",
"BROWSER_USE_INSTALLED_ON_SYSTEM": "<your BROWSER_USE_INSTALLED_ON_SYSTEM>",
"BROWSER_EXECUTABLE_PATH": "<your BROWSER_EXECUTABLE_PATH>",
"BROWSER_CHROMIUM_SANDBOX": "<your BROWSER_CHROMIUM_SANDBOX>",
"BROWSER_LAUNCH_ARGS": "<your BROWSER_LAUNCH_ARGS>",
"BROWSER_ALLOWED_DOMAINS": "<your BROWSER_ALLOWED_DOMAINS>",
"BROWSER_LOCALE": "<your BROWSER_LOCALE>",
"OTEL_ENABLE": "<your OTEL_ENABLE>",
"OTEL_SERVICE_NAME": "<your OTEL_SERVICE_NAME>",
"OTEL_SERVICE_VERSION": "<your OTEL_SERVICE_VERSION>",
"OTEL_ASSETS_DIR": "<your OTEL_ASSETS_DIR>",
"OTEL_INSTRUMENTATION_USER_INTERACTION_EVENTS": "<your OTEL_INSTRUMENTATION_USER_INTERACTION_EVENTS>",
"OTEL_EXPORTER_TYPE": "<your OTEL_EXPORTER_TYPE>",
"OTEL_EXPORTER_HTTP_URL": "<your OTEL_EXPORTER_HTTP_URL>",
"OTEL_EXPORTER_HTTP_HEADERS": "<your OTEL_EXPORTER_HTTP_HEADERS>",
"AWS_REGION": "<your AWS_REGION>",
"AWS_PROFILE": "<your AWS_PROFILE>",
"AMAZON_BEDROCK_ENABLE": "<your AMAZON_BEDROCK_ENABLE>",
"AMAZON_BEDROCK_IMAGE_EMBED_MODEL_ID": "<your AMAZON_BEDROCK_IMAGE_EMBED_MODEL_ID>",
"AMAZON_BEDROCK_TEXT_EMBED_MODEL_ID": "<your AMAZON_BEDROCK_TEXT_EMBED_MODEL_ID>",
"AMAZON_BEDROCK_VISION_MODEL_ID": "<your AMAZON_BEDROCK_VISION_MODEL_ID>",
"FIGMA_ACCESS_TOKEN": "<your FIGMA_ACCESS_TOKEN>",
"FIGMA_API_BASE_URL": "<your FIGMA_API_BASE_URL>",
"DAEMON_PORT": "<your DAEMON_PORT>",
"DAEMON_SESSION_IDLE_SECONDS": "<your DAEMON_SESSION_IDLE_SECONDS>",
"DAEMON_SESSION_IDLE_CHECK_SECONDS": "<your DAEMON_SESSION_IDLE_CHECK_SECONDS>",
"NODE_SERVER_INSTRUCTIONS_ENABLE": "<your NODE_SERVER_INSTRUCTIONS_ENABLE>",
"NODE_POLICY_DEBUGGING_ENABLE": "<your NODE_POLICY_DEBUGGING_ENABLE>",
"NODE_INSPECTOR_HOST": "<your NODE_INSPECTOR_HOST>",
"TOOL_OUTPUT_SCHEMA_DISABLE": "<your TOOL_OUTPUT_SCHEMA_DISABLE>",
"AVAILABLE_TOOL_DOMAINS": "<your AVAILABLE_TOOL_DOMAINS>",
"WORKING_DIR": "<your WORKING_DIR>",
"SEARCH_STRATEGY": "<your SEARCH_STRATEGY>",
"SCENARIO_SEARCH_STRATEGY": "<your SCENARIO_SEARCH_STRATEGY>"
}
}
}
}Add to claude_desktop_config.json (Settings → Developer → Edit Config). Replace each placeholder with your own value before saving.
{
"mcpServers": {
"browser-devtools-mcp": {
"url": "https://{your_mcp_server_host}/mcp"
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project).
{
"mcpServers": {
"browser-devtools-mcp": {
"command": "npx",
"args": [
"-y",
"browser-devtools-mcp"
],
"env": {
"PLATFORM": "<your PLATFORM>",
"PORT": "<your PORT>",
"SESSION_IDLE_SECONDS": "<your SESSION_IDLE_SECONDS>",
"SESSION_IDLE_CHECK_SECONDS": "<your SESSION_IDLE_CHECK_SECONDS>",
"SESSION_CLOSE_ON_SOCKET_CLOSE": "<your SESSION_CLOSE_ON_SOCKET_CLOSE>",
"CONSOLE_MESSAGES_BUFFER_SIZE": "<your CONSOLE_MESSAGES_BUFFER_SIZE>",
"HTTP_REQUESTS_BUFFER_SIZE": "<your HTTP_REQUESTS_BUFFER_SIZE>",
"BROWSER_SERVER_INSTRUCTIONS_ENABLE": "<your BROWSER_SERVER_INSTRUCTIONS_ENABLE>",
"BROWSER_POLICY_UI_DEBUGGING_ENABLE": "<your BROWSER_POLICY_UI_DEBUGGING_ENABLE>",
"BROWSER_HEADLESS_ENABLE": "<your BROWSER_HEADLESS_ENABLE>",
"BROWSER_PERSISTENT_ENABLE": "<your BROWSER_PERSISTENT_ENABLE>",
"BROWSER_CDP_ENDPOINT_URL": "<your BROWSER_CDP_ENDPOINT_URL>",
"BROWSER_CDP_ENABLE": "<your BROWSER_CDP_ENABLE>",
"BROWSER_CDP_OPEN_INSPECT": "<your BROWSER_CDP_OPEN_INSPECT>",
"BROWSER_PERSISTENT_USER_DATA_DIR": "<your BROWSER_PERSISTENT_USER_DATA_DIR>",
"BROWSER_USE_INSTALLED_ON_SYSTEM": "<your BROWSER_USE_INSTALLED_ON_SYSTEM>",
"BROWSER_EXECUTABLE_PATH": "<your BROWSER_EXECUTABLE_PATH>",
"BROWSER_CHROMIUM_SANDBOX": "<your BROWSER_CHROMIUM_SANDBOX>",
"BROWSER_LAUNCH_ARGS": "<your BROWSER_LAUNCH_ARGS>",
"BROWSER_ALLOWED_DOMAINS": "<your BROWSER_ALLOWED_DOMAINS>",
"BROWSER_LOCALE": "<your BROWSER_LOCALE>",
"OTEL_ENABLE": "<your OTEL_ENABLE>",
"OTEL_SERVICE_NAME": "<your OTEL_SERVICE_NAME>",
"OTEL_SERVICE_VERSION": "<your OTEL_SERVICE_VERSION>",
"OTEL_ASSETS_DIR": "<your OTEL_ASSETS_DIR>",
"OTEL_INSTRUMENTATION_USER_INTERACTION_EVENTS": "<your OTEL_INSTRUMENTATION_USER_INTERACTION_EVENTS>",
"OTEL_EXPORTER_TYPE": "<your OTEL_EXPORTER_TYPE>",
"OTEL_EXPORTER_HTTP_URL": "<your OTEL_EXPORTER_HTTP_URL>",
"OTEL_EXPORTER_HTTP_HEADERS": "<your OTEL_EXPORTER_HTTP_HEADERS>",
"AWS_REGION": "<your AWS_REGION>",
"AWS_PROFILE": "<your AWS_PROFILE>",
"AMAZON_BEDROCK_ENABLE": "<your AMAZON_BEDROCK_ENABLE>",
"AMAZON_BEDROCK_IMAGE_EMBED_MODEL_ID": "<your AMAZON_BEDROCK_IMAGE_EMBED_MODEL_ID>",
"AMAZON_BEDROCK_TEXT_EMBED_MODEL_ID": "<your AMAZON_BEDROCK_TEXT_EMBED_MODEL_ID>",
"AMAZON_BEDROCK_VISION_MODEL_ID": "<your AMAZON_BEDROCK_VISION_MODEL_ID>",
"FIGMA_ACCESS_TOKEN": "<your FIGMA_ACCESS_TOKEN>",
"FIGMA_API_BASE_URL": "<your FIGMA_API_BASE_URL>",
"DAEMON_PORT": "<your DAEMON_PORT>",
"DAEMON_SESSION_IDLE_SECONDS": "<your DAEMON_SESSION_IDLE_SECONDS>",
"DAEMON_SESSION_IDLE_CHECK_SECONDS": "<your DAEMON_SESSION_IDLE_CHECK_SECONDS>",
"NODE_SERVER_INSTRUCTIONS_ENABLE": "<your NODE_SERVER_INSTRUCTIONS_ENABLE>",
"NODE_POLICY_DEBUGGING_ENABLE": "<your NODE_POLICY_DEBUGGING_ENABLE>",
"NODE_INSPECTOR_HOST": "<your NODE_INSPECTOR_HOST>",
"TOOL_OUTPUT_SCHEMA_DISABLE": "<your TOOL_OUTPUT_SCHEMA_DISABLE>",
"AVAILABLE_TOOL_DOMAINS": "<your AVAILABLE_TOOL_DOMAINS>",
"WORKING_DIR": "<your WORKING_DIR>",
"SEARCH_STRATEGY": "<your SEARCH_STRATEGY>",
"SCENARIO_SEARCH_STRATEGY": "<your SCENARIO_SEARCH_STRATEGY>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project). Replace each placeholder with your own value before saving.
{
"servers": {
"browser-devtools-mcp": {
"type": "http",
"url": "https://{your_mcp_server_host}/mcp"
}
}
}Save as .vscode/mcp.json in your workspace.
{
"servers": {
"browser-devtools-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"browser-devtools-mcp"
],
"env": {
"PLATFORM": "<your PLATFORM>",
"PORT": "<your PORT>",
"SESSION_IDLE_SECONDS": "<your SESSION_IDLE_SECONDS>",
"SESSION_IDLE_CHECK_SECONDS": "<your SESSION_IDLE_CHECK_SECONDS>",
"SESSION_CLOSE_ON_SOCKET_CLOSE": "<your SESSION_CLOSE_ON_SOCKET_CLOSE>",
"CONSOLE_MESSAGES_BUFFER_SIZE": "<your CONSOLE_MESSAGES_BUFFER_SIZE>",
"HTTP_REQUESTS_BUFFER_SIZE": "<your HTTP_REQUESTS_BUFFER_SIZE>",
"BROWSER_SERVER_INSTRUCTIONS_ENABLE": "<your BROWSER_SERVER_INSTRUCTIONS_ENABLE>",
"BROWSER_POLICY_UI_DEBUGGING_ENABLE": "<your BROWSER_POLICY_UI_DEBUGGING_ENABLE>",
"BROWSER_HEADLESS_ENABLE": "<your BROWSER_HEADLESS_ENABLE>",
"BROWSER_PERSISTENT_ENABLE": "<your BROWSER_PERSISTENT_ENABLE>",
"BROWSER_CDP_ENDPOINT_URL": "<your BROWSER_CDP_ENDPOINT_URL>",
"BROWSER_CDP_ENABLE": "<your BROWSER_CDP_ENABLE>",
"BROWSER_CDP_OPEN_INSPECT": "<your BROWSER_CDP_OPEN_INSPECT>",
"BROWSER_PERSISTENT_USER_DATA_DIR": "<your BROWSER_PERSISTENT_USER_DATA_DIR>",
"BROWSER_USE_INSTALLED_ON_SYSTEM": "<your BROWSER_USE_INSTALLED_ON_SYSTEM>",
"BROWSER_EXECUTABLE_PATH": "<your BROWSER_EXECUTABLE_PATH>",
"BROWSER_CHROMIUM_SANDBOX": "<your BROWSER_CHROMIUM_SANDBOX>",
"BROWSER_LAUNCH_ARGS": "<your BROWSER_LAUNCH_ARGS>",
"BROWSER_ALLOWED_DOMAINS": "<your BROWSER_ALLOWED_DOMAINS>",
"BROWSER_LOCALE": "<your BROWSER_LOCALE>",
"OTEL_ENABLE": "<your OTEL_ENABLE>",
"OTEL_SERVICE_NAME": "<your OTEL_SERVICE_NAME>",
"OTEL_SERVICE_VERSION": "<your OTEL_SERVICE_VERSION>",
"OTEL_ASSETS_DIR": "<your OTEL_ASSETS_DIR>",
"OTEL_INSTRUMENTATION_USER_INTERACTION_EVENTS": "<your OTEL_INSTRUMENTATION_USER_INTERACTION_EVENTS>",
"OTEL_EXPORTER_TYPE": "<your OTEL_EXPORTER_TYPE>",
"OTEL_EXPORTER_HTTP_URL": "<your OTEL_EXPORTER_HTTP_URL>",
"OTEL_EXPORTER_HTTP_HEADERS": "<your OTEL_EXPORTER_HTTP_HEADERS>",
"AWS_REGION": "<your AWS_REGION>",
"AWS_PROFILE": "<your AWS_PROFILE>",
"AMAZON_BEDROCK_ENABLE": "<your AMAZON_BEDROCK_ENABLE>",
"AMAZON_BEDROCK_IMAGE_EMBED_MODEL_ID": "<your AMAZON_BEDROCK_IMAGE_EMBED_MODEL_ID>",
"AMAZON_BEDROCK_TEXT_EMBED_MODEL_ID": "<your AMAZON_BEDROCK_TEXT_EMBED_MODEL_ID>",
"AMAZON_BEDROCK_VISION_MODEL_ID": "<your AMAZON_BEDROCK_VISION_MODEL_ID>",
"FIGMA_ACCESS_TOKEN": "<your FIGMA_ACCESS_TOKEN>",
"FIGMA_API_BASE_URL": "<your FIGMA_API_BASE_URL>",
"DAEMON_PORT": "<your DAEMON_PORT>",
"DAEMON_SESSION_IDLE_SECONDS": "<your DAEMON_SESSION_IDLE_SECONDS>",
"DAEMON_SESSION_IDLE_CHECK_SECONDS": "<your DAEMON_SESSION_IDLE_CHECK_SECONDS>",
"NODE_SERVER_INSTRUCTIONS_ENABLE": "<your NODE_SERVER_INSTRUCTIONS_ENABLE>",
"NODE_POLICY_DEBUGGING_ENABLE": "<your NODE_POLICY_DEBUGGING_ENABLE>",
"NODE_INSPECTOR_HOST": "<your NODE_INSPECTOR_HOST>",
"TOOL_OUTPUT_SCHEMA_DISABLE": "<your TOOL_OUTPUT_SCHEMA_DISABLE>",
"AVAILABLE_TOOL_DOMAINS": "<your AVAILABLE_TOOL_DOMAINS>",
"WORKING_DIR": "<your WORKING_DIR>",
"SEARCH_STRATEGY": "<your SEARCH_STRATEGY>",
"SCENARIO_SEARCH_STRATEGY": "<your SCENARIO_SEARCH_STRATEGY>"
}
}
}
}Save as .vscode/mcp.json in your workspace. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"browser-devtools-mcp": {
"serverUrl": "https://{your_mcp_server_host}/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
{
"mcpServers": {
"browser-devtools-mcp": {
"command": "npx",
"args": [
"-y",
"browser-devtools-mcp"
],
"env": {
"PLATFORM": "<your PLATFORM>",
"PORT": "<your PORT>",
"SESSION_IDLE_SECONDS": "<your SESSION_IDLE_SECONDS>",
"SESSION_IDLE_CHECK_SECONDS": "<your SESSION_IDLE_CHECK_SECONDS>",
"SESSION_CLOSE_ON_SOCKET_CLOSE": "<your SESSION_CLOSE_ON_SOCKET_CLOSE>",
"CONSOLE_MESSAGES_BUFFER_SIZE": "<your CONSOLE_MESSAGES_BUFFER_SIZE>",
"HTTP_REQUESTS_BUFFER_SIZE": "<your HTTP_REQUESTS_BUFFER_SIZE>",
"BROWSER_SERVER_INSTRUCTIONS_ENABLE": "<your BROWSER_SERVER_INSTRUCTIONS_ENABLE>",
"BROWSER_POLICY_UI_DEBUGGING_ENABLE": "<your BROWSER_POLICY_UI_DEBUGGING_ENABLE>",
"BROWSER_HEADLESS_ENABLE": "<your BROWSER_HEADLESS_ENABLE>",
"BROWSER_PERSISTENT_ENABLE": "<your BROWSER_PERSISTENT_ENABLE>",
"BROWSER_CDP_ENDPOINT_URL": "<your BROWSER_CDP_ENDPOINT_URL>",
"BROWSER_CDP_ENABLE": "<your BROWSER_CDP_ENABLE>",
"BROWSER_CDP_OPEN_INSPECT": "<your BROWSER_CDP_OPEN_INSPECT>",
"BROWSER_PERSISTENT_USER_DATA_DIR": "<your BROWSER_PERSISTENT_USER_DATA_DIR>",
"BROWSER_USE_INSTALLED_ON_SYSTEM": "<your BROWSER_USE_INSTALLED_ON_SYSTEM>",
"BROWSER_EXECUTABLE_PATH": "<your BROWSER_EXECUTABLE_PATH>",
"BROWSER_CHROMIUM_SANDBOX": "<your BROWSER_CHROMIUM_SANDBOX>",
"BROWSER_LAUNCH_ARGS": "<your BROWSER_LAUNCH_ARGS>",
"BROWSER_ALLOWED_DOMAINS": "<your BROWSER_ALLOWED_DOMAINS>",
"BROWSER_LOCALE": "<your BROWSER_LOCALE>",
"OTEL_ENABLE": "<your OTEL_ENABLE>",
"OTEL_SERVICE_NAME": "<your OTEL_SERVICE_NAME>",
"OTEL_SERVICE_VERSION": "<your OTEL_SERVICE_VERSION>",
"OTEL_ASSETS_DIR": "<your OTEL_ASSETS_DIR>",
"OTEL_INSTRUMENTATION_USER_INTERACTION_EVENTS": "<your OTEL_INSTRUMENTATION_USER_INTERACTION_EVENTS>",
"OTEL_EXPORTER_TYPE": "<your OTEL_EXPORTER_TYPE>",
"OTEL_EXPORTER_HTTP_URL": "<your OTEL_EXPORTER_HTTP_URL>",
"OTEL_EXPORTER_HTTP_HEADERS": "<your OTEL_EXPORTER_HTTP_HEADERS>",
"AWS_REGION": "<your AWS_REGION>",
"AWS_PROFILE": "<your AWS_PROFILE>",
"AMAZON_BEDROCK_ENABLE": "<your AMAZON_BEDROCK_ENABLE>",
"AMAZON_BEDROCK_IMAGE_EMBED_MODEL_ID": "<your AMAZON_BEDROCK_IMAGE_EMBED_MODEL_ID>",
"AMAZON_BEDROCK_TEXT_EMBED_MODEL_ID": "<your AMAZON_BEDROCK_TEXT_EMBED_MODEL_ID>",
"AMAZON_BEDROCK_VISION_MODEL_ID": "<your AMAZON_BEDROCK_VISION_MODEL_ID>",
"FIGMA_ACCESS_TOKEN": "<your FIGMA_ACCESS_TOKEN>",
"FIGMA_API_BASE_URL": "<your FIGMA_API_BASE_URL>",
"DAEMON_PORT": "<your DAEMON_PORT>",
"DAEMON_SESSION_IDLE_SECONDS": "<your DAEMON_SESSION_IDLE_SECONDS>",
"DAEMON_SESSION_IDLE_CHECK_SECONDS": "<your DAEMON_SESSION_IDLE_CHECK_SECONDS>",
"NODE_SERVER_INSTRUCTIONS_ENABLE": "<your NODE_SERVER_INSTRUCTIONS_ENABLE>",
"NODE_POLICY_DEBUGGING_ENABLE": "<your NODE_POLICY_DEBUGGING_ENABLE>",
"NODE_INSPECTOR_HOST": "<your NODE_INSPECTOR_HOST>",
"TOOL_OUTPUT_SCHEMA_DISABLE": "<your TOOL_OUTPUT_SCHEMA_DISABLE>",
"AVAILABLE_TOOL_DOMAINS": "<your AVAILABLE_TOOL_DOMAINS>",
"WORKING_DIR": "<your WORKING_DIR>",
"SEARCH_STRATEGY": "<your SEARCH_STRATEGY>",
"SCENARIO_SEARCH_STRATEGY": "<your SCENARIO_SEARCH_STRATEGY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"browser-devtools-mcp": {
"url": "https://{your_mcp_server_host}/mcp"
}
}
}{
"mcpServers": {
"browser-devtools-mcp": {
"command": "npx",
"args": [
"-y",
"browser-devtools-mcp"
],
"env": {
"PLATFORM": "<your PLATFORM>",
"PORT": "<your PORT>",
"SESSION_IDLE_SECONDS": "<your SESSION_IDLE_SECONDS>",
"SESSION_IDLE_CHECK_SECONDS": "<your SESSION_IDLE_CHECK_SECONDS>",
"SESSION_CLOSE_ON_SOCKET_CLOSE": "<your SESSION_CLOSE_ON_SOCKET_CLOSE>",
"CONSOLE_MESSAGES_BUFFER_SIZE": "<your CONSOLE_MESSAGES_BUFFER_SIZE>",
"HTTP_REQUESTS_BUFFER_SIZE": "<your HTTP_REQUESTS_BUFFER_SIZE>",
"BROWSER_SERVER_INSTRUCTIONS_ENABLE": "<your BROWSER_SERVER_INSTRUCTIONS_ENABLE>",
"BROWSER_POLICY_UI_DEBUGGING_ENABLE": "<your BROWSER_POLICY_UI_DEBUGGING_ENABLE>",
"BROWSER_HEADLESS_ENABLE": "<your BROWSER_HEADLESS_ENABLE>",
"BROWSER_PERSISTENT_ENABLE": "<your BROWSER_PERSISTENT_ENABLE>",
"BROWSER_CDP_ENDPOINT_URL": "<your BROWSER_CDP_ENDPOINT_URL>",
"BROWSER_CDP_ENABLE": "<your BROWSER_CDP_ENABLE>",
"BROWSER_CDP_OPEN_INSPECT": "<your BROWSER_CDP_OPEN_INSPECT>",
"BROWSER_PERSISTENT_USER_DATA_DIR": "<your BROWSER_PERSISTENT_USER_DATA_DIR>",
"BROWSER_USE_INSTALLED_ON_SYSTEM": "<your BROWSER_USE_INSTALLED_ON_SYSTEM>",
"BROWSER_EXECUTABLE_PATH": "<your BROWSER_EXECUTABLE_PATH>",
"BROWSER_CHROMIUM_SANDBOX": "<your BROWSER_CHROMIUM_SANDBOX>",
"BROWSER_LAUNCH_ARGS": "<your BROWSER_LAUNCH_ARGS>",
"BROWSER_ALLOWED_DOMAINS": "<your BROWSER_ALLOWED_DOMAINS>",
"BROWSER_LOCALE": "<your BROWSER_LOCALE>",
"OTEL_ENABLE": "<your OTEL_ENABLE>",
"OTEL_SERVICE_NAME": "<your OTEL_SERVICE_NAME>",
"OTEL_SERVICE_VERSION": "<your OTEL_SERVICE_VERSION>",
"OTEL_ASSETS_DIR": "<your OTEL_ASSETS_DIR>",
"OTEL_INSTRUMENTATION_USER_INTERACTION_EVENTS": "<your OTEL_INSTRUMENTATION_USER_INTERACTION_EVENTS>",
"OTEL_EXPORTER_TYPE": "<your OTEL_EXPORTER_TYPE>",
"OTEL_EXPORTER_HTTP_URL": "<your OTEL_EXPORTER_HTTP_URL>",
"OTEL_EXPORTER_HTTP_HEADERS": "<your OTEL_EXPORTER_HTTP_HEADERS>",
"AWS_REGION": "<your AWS_REGION>",
"AWS_PROFILE": "<your AWS_PROFILE>",
"AMAZON_BEDROCK_ENABLE": "<your AMAZON_BEDROCK_ENABLE>",
"AMAZON_BEDROCK_IMAGE_EMBED_MODEL_ID": "<your AMAZON_BEDROCK_IMAGE_EMBED_MODEL_ID>",
"AMAZON_BEDROCK_TEXT_EMBED_MODEL_ID": "<your AMAZON_BEDROCK_TEXT_EMBED_MODEL_ID>",
"AMAZON_BEDROCK_VISION_MODEL_ID": "<your AMAZON_BEDROCK_VISION_MODEL_ID>",
"FIGMA_ACCESS_TOKEN": "<your FIGMA_ACCESS_TOKEN>",
"FIGMA_API_BASE_URL": "<your FIGMA_API_BASE_URL>",
"DAEMON_PORT": "<your DAEMON_PORT>",
"DAEMON_SESSION_IDLE_SECONDS": "<your DAEMON_SESSION_IDLE_SECONDS>",
"DAEMON_SESSION_IDLE_CHECK_SECONDS": "<your DAEMON_SESSION_IDLE_CHECK_SECONDS>",
"NODE_SERVER_INSTRUCTIONS_ENABLE": "<your NODE_SERVER_INSTRUCTIONS_ENABLE>",
"NODE_POLICY_DEBUGGING_ENABLE": "<your NODE_POLICY_DEBUGGING_ENABLE>",
"NODE_INSPECTOR_HOST": "<your NODE_INSPECTOR_HOST>",
"TOOL_OUTPUT_SCHEMA_DISABLE": "<your TOOL_OUTPUT_SCHEMA_DISABLE>",
"AVAILABLE_TOOL_DOMAINS": "<your AVAILABLE_TOOL_DOMAINS>",
"WORKING_DIR": "<your WORKING_DIR>",
"SEARCH_STRATEGY": "<your SEARCH_STRATEGY>",
"SCENARIO_SEARCH_STRATEGY": "<your SCENARIO_SEARCH_STRATEGY>"
}
}
}
}Replace each placeholder with your own value before saving.
Ask the agent to open a page, take an ARIA snapshot and fill a form field by ref.
Expected: navigation_go-to loads the page, a11y_take-aria-snapshot returns elements with refs, and interaction_fill types into the chosen field.
When to choose another server
- Playwright MCP Server#10
You want an actively maintained Playwright server with the same snapshot-and-ref approach.
- Chrome DevTools MCP#1
You need Chrome's performance, memory and Lighthouse tooling.
- mcp-playwright#1,019
You want Playwright codegen rather than observability tools.
Compared side by side in Browser automation MCP servers.
What changed, and when this was checked
- First listed
- Jan 14, 2026
- Latest version published
- May 12, 2026
- Version history
- 24 versions tracked (below)
- Requirements evidence
- MCP Toplist probed the public endpoint on Oct 12, 2026 and could not complete the MCP handshake (dns failure). Requirements remain unverified.
- Profile checked
- Oct 9, 2026 against Package README (npm), npm registry
- Ranking data as of
- Oct 16, 2026
- Official MCP ↗listed since Apr 25, 2026 · still listed
- Glama ↗listed since Jun 4, 2026 · still listed
- mcp.so ↗listed since Aug 25, 2026 · still listed
Do you maintain Browser Devtools MCP? to correct or enrich this profile.
Available versions (24)
| Version | Published |
|---|---|
| 0.9.1 | May 12, 2026 |
| 0.5.3 | Mar 21, 2026 |
| 0.5.2 | Mar 20, 2026 |
| 0.5.1 | Mar 19, 2026 |
| 0.5.0 | Mar 19, 2026 |
| 0.4.5 | Mar 19, 2026 |
| 0.4.3 | Mar 14, 2026 |
| 0.4.2 | Mar 14, 2026 |
| 0.4.0 | Mar 9, 2026 |
| 0.3.3 | Mar 4, 2026 |
| 0.3.0 | Feb 26, 2026 |
| 0.2.27 | Feb 25, 2026 |
| 0.2.26 | Feb 23, 2026 |
| 0.2.24 | Feb 21, 2026 |
| 0.2.23 | Feb 20, 2026 |
| 0.2.22 | Feb 20, 2026 |
| 0.2.3 | Feb 15, 2026 |
| 0.2.2 | Feb 3, 2026 |
| 0.2.1 | Feb 3, 2026 |
| 0.2.0 | Feb 3, 2026 |
| 0.1.7 | Jan 27, 2026 |
| 0.1.4 | Jan 18, 2026 |
| 0.1.1 | Jan 15, 2026 |
| 0.1.0 | Nov 25, 2024 |
Ranks ahead of 143,954 of 144,396 servers on MCP Toplist.
Show your rank
Maintain this server? Add the live rank badge to your README — it updates automatically as the leaderboard changes.
[](https://mcptoplist.com/server/io.github.serkan-ozal%2Fbrowser-devtools-mcp)<a href="https://mcptoplist.com/server/io.github.serkan-ozal%2Fbrowser-devtools-mcp"><img src="https://mcptoplist.com/badge/io.github.serkan-ozal%2Fbrowser-devtools-mcp.svg" alt="MCP Toplist: Top 1% of 144,396" /></a>Variants: append ?metric=score or ?metric=stars to the image URL.
Frequently asked questions
- Who maintains Browser Devtools MCP?
- Browser Devtools MCP is maintained by serkan-ozal, which publishes 9 MCP servers (53 total versions) tracked on MCP Toplist.
- Is Browser Devtools MCP listed on the Official MCP Registry?
- Yes — Browser Devtools MCP is listed on the Official MCP Registry, alongside Glama and mcp.so.
- How many versions does Browser Devtools MCP have?
- MCP Toplist tracks 24 versions of Browser Devtools MCP, most recently published on May 12, 2026.
- Where can I find the source code for Browser Devtools MCP?
- The source code for Browser Devtools MCP is hosted at github.com/serkan-ozal/browser-devtools-mcp.
Do you run this server?
Community projects list the MCP servers behind real agents and apps. Publish yours and this page will link to it.