browser-devtools-mcp

{
  "name": "io.github.serkan-ozal/browser-devtools-mcp",
  "_meta": {
    "io.modelcontextprotocol.registry/publisher-provided": {
      "contacts": [
        {
          "url": "https://github.com/serkan-ozal",
          "name": "Serkan Ozal",
          "email": "[email protected]"
        }
      ],
      "keywords": [
        "ai",
        "automation",
        "browser",
        "debugging",
        "mcp",
        "nodejs",
        "observability",
        "opentelemetry",
        "playwright",
        "source-map",
        "testing",
        "web"
      ],
      "documentationUrl": "https://github.com/serkan-ozal/browser-devtools-mcp#readme"
    }
  },
  "icons": [
    {
      "src": "https://browser-devtools.com/assets/icons/icon.png",
      "mimeType": "image/png"
    },
    {
      "src": "https://browser-devtools.com/assets/icons/icon.svg",
      "sizes": [
        "any"
      ],
      "mimeType": "image/svg+xml"
    }
  ],
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://{your_mcp_server_host}/mcp",
      "type": "streamable-http",
      "variables": {
        "your_mcp_server_host": {
          "isRequired": true,
          "description": "Your self-hosted MCP server host (host:port, without scheme)."
        }
      }
    }
  ],
  "version": "0.9.1",
  "packages": [
    {
      "version": "0.9.1",
      "transport": {
        "type": "stdio"
      },
      "identifier": "browser-devtools-mcp",
      "registryType": "npm",
      "registryBaseUrl": "https://registry.npmjs.org",
      "environmentVariables": [
        {
          "name": "PLATFORM",
          "format": "string",
          "description": "Platform: browser (default) or node for Node.js backend debugging."
        },
        {
          "name": "PORT",
          "format": "number",
          "description": "Port for HTTP transport."
        },
        {
          "name": "SESSION_IDLE_SECONDS",
          "format": "number",
          "description": "Idle session timeout (seconds)."
        },
        {
          "name": "SESSION_IDLE_CHECK_SECONDS",
          "format": "number",
          "description": "Interval for checking idle sessions (seconds)."
        },
        {
          "name": "SESSION_CLOSE_ON_SOCKET_CLOSE",
          "format": "boolean",
          "description": "Close session when socket closes."
        },
        {
          "name": "CONSOLE_MESSAGES_BUFFER_SIZE",
          "format": "number",
          "description": "Maximum console messages to buffer."
        },
        {
          "name": "HTTP_REQUESTS_BUFFER_SIZE",
          "format": "number",
          "description": "Maximum HTTP requests to buffer."
        },
        {
          "name": "BROWSER_SERVER_INSTRUCTIONS_ENABLE",
          "format": "boolean",
          "description": "When true, include server instructions in MCP server info (browser platform). Default: true."
        },
        {
          "name": "BROWSER_POLICY_UI_DEBUGGING_ENABLE",
          "format": "boolean",
          "description": "When true, include UI_DEBUGGING_POLICY in server policies (browser platform). Default: false."
        },
        {
          "name": "BROWSER_HEADLESS_ENABLE",
          "format": "boolean",
          "description": "Run browser in headless mode."
        },
        {
          "name": "BROWSER_PERSISTENT_ENABLE",
          "format": "boolean",
          "description": "Use persistent browser context (preserves cookies, localStorage, extensions)."
        },
        {
          "name": "BROWSER_CDP_ENDPOINT_URL",
          "format": "string",
          "description": "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."
        },
        {
          "name": "BROWSER_CDP_ENABLE",
          "format": "boolean",
          "description": "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."
        },
        {
          "name": "BROWSER_CDP_OPEN_INSPECT",
          "format": "boolean",
          "description": "On loopback CDP failure, if Chrome is running, open chrome://inspect/#remote-debugging. Default true. Set false to disable."
        },
        {
          "name": "BROWSER_PERSISTENT_USER_DATA_DIR",
          "format": "string",
          "description": "Directory for persistent browser context user data."
        },
        {
          "name": "BROWSER_USE_INSTALLED_ON_SYSTEM",
          "format": "boolean",
          "description": "Use system-installed Chrome browser instead of Playwright's bundled browser."
        },
        {
          "name": "BROWSER_EXECUTABLE_PATH",
          "format": "string",
          "description": "Custom browser executable path."
        },
        {
          "name": "BROWSER_CHROMIUM_SANDBOX",
          "format": "boolean",
          "description": "When false, launches Chromium with --no-sandbox. Required for Docker/Lambda/CI."
        },
        {
          "name": "BROWSER_LAUNCH_ARGS",
          "format": "string",
          "description": "Extra Chromium launch args (comma-separated)."
        },
        {
          "name": "BROWSER_ALLOWED_DOMAINS",
          "format": "string",
          "description": "Comma-separated list of allowed hostnames. When set, all requests to non-matching hosts are aborted. Subdomains match automatically."
        },
        {
          "name": "BROWSER_LOCALE",
          "format": "string",
          "description": "Browser locale (e.g., \"en-US\", \"tr-TR\")."
        },
        {
          "name": "OTEL_ENABLE",
          "format": "boolean",
          "description": "Enable OpenTelemetry integration."
        },
        {
          "name": "OTEL_SERVICE_NAME",
          "format": "string",
          "description": "OpenTelemetry service name."
        },
        {
          "name": "OTEL_SERVICE_VERSION",
          "format": "string",
          "description": "OpenTelemetry service version."
        },
        {
          "name": "OTEL_ASSETS_DIR",
          "format": "string",
          "description": "Directory containing OpenTelemetry bundle files."
        },
        {
          "name": "OTEL_INSTRUMENTATION_USER_INTERACTION_EVENTS",
          "format": "string",
          "description": "User interaction events to instrument (comma-separated, e.g., \"click,submit\")."
        },
        {
          "name": "OTEL_EXPORTER_TYPE",
          "format": "string",
          "description": "OpenTelemetry exporter type: \"otlp/http\", \"console\", or \"none\"."
        },
        {
          "name": "OTEL_EXPORTER_HTTP_URL",
          "format": "string",
          "description": "OpenTelemetry collector base URL (e.g., \"http://localhost:4318\")."
        },
        {
          "name": "OTEL_EXPORTER_HTTP_HEADERS",
          "format": "string",
          "isSecret": true,
          "description": "OpenTelemetry exporter HTTP headers (comma-separated key=value pairs)."
        },
        {
          "name": "AWS_REGION",
          "format": "string",
          "description": "AWS region for Bedrock usage."
        },
        {
          "name": "AWS_PROFILE",
          "format": "string",
          "description": "AWS profile name for Bedrock usage."
        },
        {
          "name": "AMAZON_BEDROCK_ENABLE",
          "format": "boolean",
          "description": "Enable Amazon Bedrock usage."
        },
        {
          "name": "AMAZON_BEDROCK_IMAGE_EMBED_MODEL_ID",
          "format": "string",
          "description": "Amazon Bedrock image embedding model ID."
        },
        {
          "name": "AMAZON_BEDROCK_TEXT_EMBED_MODEL_ID",
          "format": "string",
          "description": "Amazon Bedrock text embedding model ID."
        },
        {
          "name": "AMAZON_BEDROCK_VISION_MODEL_ID",
          "format": "string",
          "description": "Amazon Bedrock vision model ID."
        },
        {
          "name": "FIGMA_ACCESS_TOKEN",
          "format": "string",
          "isSecret": true,
          "description": "Figma API access token for design comparison."
        },
        {
          "name": "FIGMA_API_BASE_URL",
          "format": "string",
          "description": "Figma API base URL."
        },
        {
          "name": "DAEMON_PORT",
          "format": "number",
          "description": "Daemon mode port (CLI)."
        },
        {
          "name": "DAEMON_SESSION_IDLE_SECONDS",
          "format": "number",
          "description": "Daemon mode idle session timeout (seconds)."
        },
        {
          "name": "DAEMON_SESSION_IDLE_CHECK_SECONDS",
          "format": "number",
          "description": "Daemon mode idle session check interval (seconds)."
        },
        {
          "name": "NODE_SERVER_INSTRUCTIONS_ENABLE",
          "format": "boolean",
          "description": "When true, include server instructions in MCP server info (node platform). Default: true."
        },
        {
          "name": "NODE_POLICY_DEBUGGING_ENABLE",
          "format": "boolean",
          "description": "When true, include NODE_DEBUGGING_POLICY in server policies (node platform). Default: false."
        },
        {
          "name": "NODE_INSPECTOR_HOST",
          "format": "string",
          "description": "Inspector host for debug_connect when MCP runs in Docker (e.g. host.docker.internal). Default: 127.0.0.1."
        },
        {
          "name": "TOOL_OUTPUT_SCHEMA_DISABLE",
          "format": "boolean",
          "description": "When true, omit tool output schema from MCP tool registration (can reduce token usage for some clients)."
        },
        {
          "name": "AVAILABLE_TOOL_DOMAINS",
          "format": "string",
          "description": "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."
        },
        {
          "name": "WORKING_DIR",
          "format": "string",
          "description": "Working directory for project-level config (.browser-devtools-mcp/). Default: process.cwd()."
        },
        {
          "name": "SEARCH_STRATEGY",
          "format": "string",
          "description": "Search strategy: SIMPLE (default, minisearch + stemmer) or FTS5 (better-sqlite3, optional dep)."
        },
        {
          "name": "SCENARIO_SEARCH_STRATEGY",
          "format": "string",
          "description": "Override SEARCH_STRATEGY for scenario search only."
        }
      ]
    }
  ],
  "repository": {
    "url": "https://github.com/serkan-ozal/browser-devtools-mcp",
    "source": "github"
  },
  "websiteUrl": "https://github.com/serkan-ozal/browser-devtools-mcp",
  "description": "Playwright browser & Node.js MCP. ARIA refs, screenshots, ref-based interactions."
}