io.github.serkan-ozal/browser-devtools-mcp

io.github.serkan-ozal/browser-devtools-mcp·v0.9.1·Browser Automation

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

Trust verdict · v1 advisory · method

REVIEWstatus: PARTIALfresh until 2026-07-01 10:00 UTC

screened 2026-06-01tier: scannedgranularity: description-levelsource: registry

Semantic screen found no manipulation pattern in the description. Conformance probe not yet run.

mcpindex.integrity.descriptionpassINFO

evidence“No malicious intent”via static_description

Limits of this verdict

- Semantic screen only - the deterministic conformance probe has not run on this server
- Confidence is reported but not yet calibrated (v1)
- Screen reads the tool description, not the live behavior
- advisory
- registry description only no input schema

Semantic screen: an LLM judge reads the tool description for hidden instructions (status PARTIAL). A pass means the description is not lying, not that the tool is safe: a high-capability tool with an honest description still warrants caution. The deterministic conformance probe has not been run on this server yet, so the screen here is semantic-only. Posture: advisory. Confidences are reported but not yet calibrated (calibrated=false at v1). History is paid-tier and not shown here.

Own this server? Screen its description →

Embed this badge

A live verdict badge for your README or listing. It reflects the current screen, links back here, and updates when the verdict does.

Markdown

[![mcpindex](https://mcpindex.ai/api/v1/badge/io-github-serkan-ozal-browser-devtools-mcp)](https://mcpindex.ai/server/io-github-serkan-ozal-browser-devtools-mcp)

HTML

<a href="https://mcpindex.ai/server/io-github-serkan-ozal-browser-devtools-mcp"><img src="https://mcpindex.ai/api/v1/badge/io-github-serkan-ozal-browser-devtools-mcp" alt="mcpindex verdict" height="20" /></a>

Environment variables

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_CHROMIUM_SANDBOX

When false, launches Chromium with --no-sandbox. Required for Docker/Lambda/CI.

BROWSER_LAUNCH_ARGS

Extra Chromium launch args (comma-separated).

BROWSER_ALLOWED_DOMAINS

Comma-separated list of allowed hostnames. When set, all requests to non-matching hosts are aborted. Subdomains match automatically.

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_HEADERS

secret

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_TOKEN

secret

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,scenario). Unset = all tools. Browser: a11y, content, debug, figma, interaction, navigation, o11y, react, scenario, run, stub, sync. Node: debug, run.

WORKING_DIR

Working directory for project-level config (.browser-devtools-mcp/). Default: process.cwd().

SEARCH_STRATEGY

Search strategy: SIMPLE (default, minisearch + stemmer) or FTS5 (better-sqlite3, optional dep).

SCENARIO_SEARCH_STRATEGY

Override SEARCH_STRATEGY for scenario search only.

MCP quality score · maturity, not trust · methodology

freshness

completeness

installability

documentation

stability

Alternatives in Browser Automation

ai.smithery/ImRonAI-mcp-server-browserbase

Automate cloud browsers to navigate websites, interact with elements, and extract structured data.…

ai.smithery/browserbasehq-mcp-browserbase

Provides cloud browser automation capabilities using Stagehand and Browserbase, enabling LLMs to i…

DocWand

app.docwand/pdf

Sign, fill, merge and split PDFs entirely in your browser - files never leave your device.

Install

Remote endpoint

Streamable HTTP / SSE endpoint. Add to any MCP client that supports remote servers.

https://{your_mcp_server_host}/mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "browser-devtools-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "browser-devtools-mcp"
      ],
      "env": {
        "PLATFORM": "<platform>",
        "PORT": "<port>",
        "SESSION_IDLE_SECONDS": "<session_idle_seconds>",
        "SESSION_IDLE_CHECK_SECONDS": "<session_idle_check_seconds>",
        "SESSION_CLOSE_ON_SOCKET_CLOSE": "<session_close_on_socket_close>",
        "CONSOLE_MESSAGES_BUFFER_SIZE": "<console_messages_buffer_size>",
        "HTTP_REQUESTS_BUFFER_SIZE": "<http_requests_buffer_size>",
        "BROWSER_SERVER_INSTRUCTIONS_ENABLE": "<browser_server_instructions_enable>",
        "BROWSER_POLICY_UI_DEBUGGING_ENABLE": "<browser_policy_ui_debugging_enable>",
        "BROWSER_HEADLESS_ENABLE": "<browser_headless_enable>",
        "BROWSER_PERSISTENT_ENABLE": "<browser_persistent_enable>",
        "BROWSER_CDP_ENDPOINT_URL": "<browser_cdp_endpoint_url>",
        "BROWSER_CDP_ENABLE": "<browser_cdp_enable>",
        "BROWSER_CDP_OPEN_INSPECT": "<browser_cdp_open_inspect>",
        "BROWSER_PERSISTENT_USER_DATA_DIR": "<browser_persistent_user_data_dir>",
        "BROWSER_USE_INSTALLED_ON_SYSTEM": "<browser_use_installed_on_system>",
        "BROWSER_EXECUTABLE_PATH": "<browser_executable_path>",
        "BROWSER_CHROMIUM_SANDBOX": "<browser_chromium_sandbox>",
        "BROWSER_LAUNCH_ARGS": "<browser_launch_args>",
        "BROWSER_ALLOWED_DOMAINS": "<browser_allowed_domains>",
        "BROWSER_LOCALE": "<browser_locale>",
        "OTEL_ENABLE": "<otel_enable>",
        "OTEL_SERVICE_NAME": "<otel_service_name>",
        "OTEL_SERVICE_VERSION": "<otel_service_version>",
        "OTEL_ASSETS_DIR": "<otel_assets_dir>",
        "OTEL_INSTRUMENTATION_USER_INTERACTION_EVENTS": "<otel_instrumentation_user_interaction_events>",
        "OTEL_EXPORTER_TYPE": "<otel_exporter_type>",
        "OTEL_EXPORTER_HTTP_URL": "<otel_exporter_http_url>",
        "OTEL_EXPORTER_HTTP_HEADERS": "<your-otel_exporter_http_headers>",
        "AWS_REGION": "<aws_region>",
        "AWS_PROFILE": "<aws_profile>",
        "AMAZON_BEDROCK_ENABLE": "<amazon_bedrock_enable>",
        "AMAZON_BEDROCK_IMAGE_EMBED_MODEL_ID": "<amazon_bedrock_image_embed_model_id>",
        "AMAZON_BEDROCK_TEXT_EMBED_MODEL_ID": "<amazon_bedrock_text_embed_model_id>",
        "AMAZON_BEDROCK_VISION_MODEL_ID": "<amazon_bedrock_vision_model_id>",
        "FIGMA_ACCESS_TOKEN": "<your-figma_access_token>",
        "FIGMA_API_BASE_URL": "<figma_api_base_url>",
        "DAEMON_PORT": "<daemon_port>",
        "DAEMON_SESSION_IDLE_SECONDS": "<daemon_session_idle_seconds>",
        "DAEMON_SESSION_IDLE_CHECK_SECONDS": "<daemon_session_idle_check_seconds>",
        "NODE_SERVER_INSTRUCTIONS_ENABLE": "<node_server_instructions_enable>",
        "NODE_POLICY_DEBUGGING_ENABLE": "<node_policy_debugging_enable>",
        "NODE_INSPECTOR_HOST": "<node_inspector_host>",
        "TOOL_OUTPUT_SCHEMA_DISABLE": "<tool_output_schema_disable>",
        "AVAILABLE_TOOL_DOMAINS": "<available_tool_domains>",
        "WORKING_DIR": "<working_dir>",
        "SEARCH_STRATEGY": "<search_strategy>",
        "SCENARIO_SEARCH_STRATEGY": "<scenario_search_strategy>"
      }
    }
  }
}

Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "browser-devtools-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "browser-devtools-mcp"
      ],
      "env": {
        "PLATFORM": "<platform>",
        "PORT": "<port>",
        "SESSION_IDLE_SECONDS": "<session_idle_seconds>",
        "SESSION_IDLE_CHECK_SECONDS": "<session_idle_check_seconds>",
        "SESSION_CLOSE_ON_SOCKET_CLOSE": "<session_close_on_socket_close>",
        "CONSOLE_MESSAGES_BUFFER_SIZE": "<console_messages_buffer_size>",
        "HTTP_REQUESTS_BUFFER_SIZE": "<http_requests_buffer_size>",
        "BROWSER_SERVER_INSTRUCTIONS_ENABLE": "<browser_server_instructions_enable>",
        "BROWSER_POLICY_UI_DEBUGGING_ENABLE": "<browser_policy_ui_debugging_enable>",
        "BROWSER_HEADLESS_ENABLE": "<browser_headless_enable>",
        "BROWSER_PERSISTENT_ENABLE": "<browser_persistent_enable>",
        "BROWSER_CDP_ENDPOINT_URL": "<browser_cdp_endpoint_url>",
        "BROWSER_CDP_ENABLE": "<browser_cdp_enable>",
        "BROWSER_CDP_OPEN_INSPECT": "<browser_cdp_open_inspect>",
        "BROWSER_PERSISTENT_USER_DATA_DIR": "<browser_persistent_user_data_dir>",
        "BROWSER_USE_INSTALLED_ON_SYSTEM": "<browser_use_installed_on_system>",
        "BROWSER_EXECUTABLE_PATH": "<browser_executable_path>",
        "BROWSER_CHROMIUM_SANDBOX": "<browser_chromium_sandbox>",
        "BROWSER_LAUNCH_ARGS": "<browser_launch_args>",
        "BROWSER_ALLOWED_DOMAINS": "<browser_allowed_domains>",
        "BROWSER_LOCALE": "<browser_locale>",
        "OTEL_ENABLE": "<otel_enable>",
        "OTEL_SERVICE_NAME": "<otel_service_name>",
        "OTEL_SERVICE_VERSION": "<otel_service_version>",
        "OTEL_ASSETS_DIR": "<otel_assets_dir>",
        "OTEL_INSTRUMENTATION_USER_INTERACTION_EVENTS": "<otel_instrumentation_user_interaction_events>",
        "OTEL_EXPORTER_TYPE": "<otel_exporter_type>",
        "OTEL_EXPORTER_HTTP_URL": "<otel_exporter_http_url>",
        "OTEL_EXPORTER_HTTP_HEADERS": "<your-otel_exporter_http_headers>",
        "AWS_REGION": "<aws_region>",
        "AWS_PROFILE": "<aws_profile>",
        "AMAZON_BEDROCK_ENABLE": "<amazon_bedrock_enable>",
        "AMAZON_BEDROCK_IMAGE_EMBED_MODEL_ID": "<amazon_bedrock_image_embed_model_id>",
        "AMAZON_BEDROCK_TEXT_EMBED_MODEL_ID": "<amazon_bedrock_text_embed_model_id>",
        "AMAZON_BEDROCK_VISION_MODEL_ID": "<amazon_bedrock_vision_model_id>",
        "FIGMA_ACCESS_TOKEN": "<your-figma_access_token>",
        "FIGMA_API_BASE_URL": "<figma_api_base_url>",
        "DAEMON_PORT": "<daemon_port>",
        "DAEMON_SESSION_IDLE_SECONDS": "<daemon_session_idle_seconds>",
        "DAEMON_SESSION_IDLE_CHECK_SECONDS": "<daemon_session_idle_check_seconds>",
        "NODE_SERVER_INSTRUCTIONS_ENABLE": "<node_server_instructions_enable>",
        "NODE_POLICY_DEBUGGING_ENABLE": "<node_policy_debugging_enable>",
        "NODE_INSPECTOR_HOST": "<node_inspector_host>",
        "TOOL_OUTPUT_SCHEMA_DISABLE": "<tool_output_schema_disable>",
        "AVAILABLE_TOOL_DOMAINS": "<available_tool_domains>",
        "WORKING_DIR": "<working_dir>",
        "SEARCH_STRATEGY": "<search_strategy>",
        "SCENARIO_SEARCH_STRATEGY": "<scenario_search_strategy>"
      }
    }
  }
}

Cline (cline_mcp_settings.json)

npx -y browser-devtools-mcp

Verdict API

curl -s mcpindex.ai/api/v1/trust/server/io-github-serkan-ozal-browser-devtools-mcp

Free-tier verdict as JSON: decision + dimensions + severity. Call it from your agent before it invokes a tool it just discovered.

Details

version: v0.9.1
category: Browser Automation
verdict expires: 2026-07-01
quality: 90 / 100
operator: serkan-ozal

Provenance

Verdict history is anchored to Bitcoin via OpenTimestamps. The free tier returns the current verdict only; the anchored record is served on the authenticated tier.

Links

Repository →Website →Remote endpoint →