chrome-devtools-mcp 0.24.0 → 0.26.0

package/README.md

@@ -161,7 +161,7 @@ To install Chrome DevTools MCP with skills, add the marketplace registry in Clau
 Then, install the plugin:
 
 ```sh
-/plugin install chrome-devtools-mcp
+/plugin install chrome-devtools-mcp@chrome-devtools-plugins
 ```
 
 Restart Claude Code to have the MCP server and skills load (check with `/skills`).
@@ -477,7 +477,7 @@ If you run into any issues, checkout our [troubleshooting guide](./docs/troubles
 
 <!-- BEGIN AUTO GENERATED TOOLS -->
 
-- **Input automation** (9 tools)
+- **Input automation** (10 tools)
   - [`click`](docs/tool-reference.md#click)
   - [`drag`](docs/tool-reference.md#drag)
   - [`fill`](docs/tool-reference.md#fill)
@@ -487,6 +487,7 @@ If you run into any issues, checkout our [troubleshooting guide](./docs/troubles
   - [`press_key`](docs/tool-reference.md#press_key)
   - [`type_text`](docs/tool-reference.md#type_text)
   - [`upload_file`](docs/tool-reference.md#upload_file)
+  - [`click_at`](docs/tool-reference.md#click_at)
 - **Navigation automation** (6 tools)
   - [`close_page`](docs/tool-reference.md#close_page)
   - [`list_pages`](docs/tool-reference.md#list_pages)
@@ -504,21 +505,32 @@ If you run into any issues, checkout our [troubleshooting guide](./docs/troubles
 - **Network** (2 tools)
   - [`get_network_request`](docs/tool-reference.md#get_network_request)
   - [`list_network_requests`](docs/tool-reference.md#list_network_requests)
-- **Debugging** (6 tools)
+- **Debugging** (8 tools)
   - [`evaluate_script`](docs/tool-reference.md#evaluate_script)
   - [`get_console_message`](docs/tool-reference.md#get_console_message)
   - [`lighthouse_audit`](docs/tool-reference.md#lighthouse_audit)
   - [`list_console_messages`](docs/tool-reference.md#list_console_messages)
   - [`take_screenshot`](docs/tool-reference.md#take_screenshot)
   - [`take_snapshot`](docs/tool-reference.md#take_snapshot)
+  - [`screencast_start`](docs/tool-reference.md#screencast_start)
+  - [`screencast_stop`](docs/tool-reference.md#screencast_stop)
+- **Memory** (4 tools)
+  - [`take_memory_snapshot`](docs/tool-reference.md#take_memory_snapshot)
+  - [`get_memory_snapshot_details`](docs/tool-reference.md#get_memory_snapshot_details)
+  - [`get_nodes_by_class`](docs/tool-reference.md#get_nodes_by_class)
+  - [`load_memory_snapshot`](docs/tool-reference.md#load_memory_snapshot)
 - **Extensions** (5 tools)
   - [`install_extension`](docs/tool-reference.md#install_extension)
   - [`list_extensions`](docs/tool-reference.md#list_extensions)
   - [`reload_extension`](docs/tool-reference.md#reload_extension)
   - [`trigger_extension_action`](docs/tool-reference.md#trigger_extension_action)
   - [`uninstall_extension`](docs/tool-reference.md#uninstall_extension)
-- **Memory** (1 tools)
-  - [`take_memory_snapshot`](docs/tool-reference.md#take_memory_snapshot)
+- **Third-party** (2 tools)
+  - [`execute_3p_developer_tool`](docs/tool-reference.md#execute_3p_developer_tool)
+  - [`list_3p_developer_tools`](docs/tool-reference.md#list_3p_developer_tools)
+- **WebMCP** (2 tools)
+  - [`execute_webmcp_tool`](docs/tool-reference.md#execute_webmcp_tool)
+  - [`list_webmcp_tools`](docs/tool-reference.md#list_webmcp_tools)
 
 <!-- END AUTO GENERATED TOOLS -->
 
@@ -595,7 +607,7 @@ The Chrome DevTools MCP server supports the following configuration option:
   Path to ffmpeg executable for screencast recording.
   - **Type:** string
 
-- **`--experimentalWebmcp`/ `--experimental-webmcp`**
+- **`--categoryExperimentalWebmcp`/ `--category-experimental-webmcp`**
   Set to true to enable debugging WebMCP tools. Requires Chrome 149+ with the following flags: `--enable-features=WebMCPTesting,DevToolsWebMCPSupport`
   - **Type:** boolean
 
@@ -627,6 +639,11 @@ The Chrome DevTools MCP server supports the following configuration option:
   - **Type:** boolean
   - **Default:** `false`
 
+- **`--categoryExperimentalThirdParty`/ `--category-experimental-third-party`**
+  Set to true to enable third-party developer tools exposed by the inspected page itself
+  - **Type:** boolean
+  - **Default:** `false`
+
 - **`--performanceCrux`/ `--performance-crux`**
   Set to false to disable sending URLs from performance traces to CrUX API to get field performance data.
   - **Type:** boolean

package/build/src/McpPage.js

@@ -30,7 +30,7 @@ export class McpPage {
     // Dialog
     #dialog;
     #dialogHandler;
-    inPageTools;
+    thirdPartyDeveloperTools;
     constructor(page, id) {
         this.pptrPage = page;
         this.id = id;
@@ -53,8 +53,8 @@ export class McpPage {
             throw new Error(`A dialog is open (${this.#dialog.type()}: ${this.#dialog.message()}).`);
         }
     }
-    getInPageTools() {
-        return this.inPageTools;
+    getThirdPartyDeveloperTools() {
+        return this.thirdPartyDeveloperTools;
     }
     getWebMcpTools() {
         return this.pptrPage.webmcp.tools();
@@ -88,7 +88,7 @@ export class McpPage {
     dispose() {
         this.pptrPage.off('dialog', this.#dialogHandler);
     }
-    async executeInPageTool(toolName, params, response) {
+    async executeThirdPartyDeveloperTool(toolName, params, response) {
         // Creates array of ElementHandles from the UIDs in the params.
         // We do not replace the uids with the ElementsHandles yet, because
         // the `evaluate` function only turns them into DOM elements if they

package/build/src/McpResponse.js

@@ -125,7 +125,7 @@ export class McpResponse {
     #networkRequestsOptions;
     #consoleDataOptions;
     #listExtensions;
-    #listInPageTools;
+    #listThirdPartyDeveloperTools;
     #listWebMcpTools;
     #devToolsData;
     #tabId;
@@ -163,9 +163,9 @@ export class McpResponse {
     setListExtensions() {
         this.#listExtensions = true;
     }
-    setListInPageTools() {
-        if (this.#args.categoryExperimentalInPage) {
-            this.#listInPageTools = true;
+    setListThirdPartyDeveloperTools() {
+        if (this.#args.categoryExperimentalThirdParty) {
+            this.#listThirdPartyDeveloperTools = true;
         }
     }
     setListWebMcpTools() {
@@ -381,14 +381,14 @@ export class McpResponse {
         if (this.#listExtensions) {
             extensions = await context.listExtensions();
         }
-        let inPageTools;
-        if (this.#listInPageTools) {
+        let thirdPartyDeveloperTools;
+        if (this.#listThirdPartyDeveloperTools) {
             const page = this.#page ?? context.getSelectedMcpPage();
-            inPageTools = await getToolGroup(page);
-            page.inPageTools = inPageTools;
+            thirdPartyDeveloperTools = await getToolGroup(page);
+            page.thirdPartyDeveloperTools = thirdPartyDeveloperTools;
         }
         let webmcpTools;
-        if (this.#listWebMcpTools && this.#args.experimentalWebmcp) {
+        if (this.#listWebMcpTools && this.#args.categoryExperimentalWebmcp) {
             const page = this.#page ?? context.getSelectedMcpPage();
             webmcpTools = page.getWebMcpTools();
         }
@@ -469,7 +469,7 @@ export class McpResponse {
             traceSummary: this.#attachedTraceSummary,
             extensions,
             lighthouseResult: this.#attachedLighthouseResult,
-            inPageTools,
+            thirdPartyDeveloperTools,
             webmcpTools,
             errorMessage: this.#error?.message,
         });
@@ -700,14 +700,16 @@ Call ${handleDialog.name} to handle it before continuing.`);
                 response.push(extensionsMessage);
             }
         }
-        if (this.#listInPageTools) {
-            structuredContent.inPageTools = data.inPageTools ?? undefined;
-            response.push('## In-page tools');
-            if (!data.inPageTools || !data.inPageTools.tools) {
-                response.push('No in-page tools available.');
+        if (this.#listThirdPartyDeveloperTools) {
+            structuredContent.thirdPartyDeveloperTools =
+                data.thirdPartyDeveloperTools ?? undefined;
+            response.push('## Third-party developer tools');
+            if (!data.thirdPartyDeveloperTools ||
+                !data.thirdPartyDeveloperTools.tools) {
+                response.push('No third-party developer tools available.');
             }
             else {
-                const toolGroup = data.inPageTools;
+                const toolGroup = data.thirdPartyDeveloperTools;
                 response.push(`${toolGroup.name}: ${toolGroup.description}`);
                 response.push('Available tools:');
                 const toolDefinitionsMessage = toolGroup.tools

package/build/src/TextSnapshot.js

@@ -99,8 +99,8 @@ export class TextSnapshot {
         return snapshot;
     }
     // ExtraHandles represent DOM nodes which might not be part of the accessibility tree, e.g. DOM nodes
-    // returned by in-page tools. We insert them into the tree by finding the closest ancestor in the
-    // tree and inserting the node as a child. The ancestor's child nodes are re-parented if necessary.
+    // returned by third-party developer tools. We insert them into the tree by finding the closest ancestor
+    // in the tree and inserting the node as a child. The ancestor's child nodes are re-parented if necessary.
     static async insertExtraNodes(page, idToNode, seenUniqueIds, snapshotId, idCounter, rootNodeWithId, seenBackendNodeIds, extraHandles) {
         const { uniqueBackendNodeIdToMcpId } = page;
         const createExtraNode = async (handle) => {

package/build/src/ToolHandler.js

@@ -0,0 +1,188 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { logger } from './logger.js';
+import { McpResponse } from './McpResponse.js';
+import { SlimMcpResponse } from './SlimMcpResponse.js';
+import { ClearcutLogger } from './telemetry/ClearcutLogger.js';
+import { bucketizeLatency } from './telemetry/metricUtils.js';
+import { labels, OFF_BY_DEFAULT_CATEGORIES } from './tools/categories.js';
+import { pageIdSchema } from './tools/ToolDefinition.js';
+export function buildFlag(category) {
+    return `category${category.charAt(0).toUpperCase() + category.slice(1)}`;
+}
+function buildDisabledMessage(toolName, flag, categoryLabel) {
+    const reason = categoryLabel
+        ? `is in category ${categoryLabel} which`
+        : `requires experimental feature ${flag} and`;
+    return `Tool ${toolName} ${reason} is currently disabled. Enable it by running chrome-devtools start ${flag}=true. For more information check the README.`;
+}
+function getCategoryStatus(category, serverArgs) {
+    const categoryFlag = buildFlag(category);
+    const flagValue = serverArgs[categoryFlag];
+    const isDisabled = OFF_BY_DEFAULT_CATEGORIES.includes(category)
+        ? !flagValue
+        : flagValue === false;
+    if (isDisabled) {
+        return {
+            categoryFlag,
+            disabled: true,
+        };
+    }
+    return {
+        disabled: false,
+    };
+}
+function getConditionStatus(condition, serverArgs) {
+    if (condition && !serverArgs[condition]) {
+        return { conditionFlag: condition, disabled: true };
+    }
+    return { disabled: false };
+}
+function getToolStatusInfo(tool, serverArgs) {
+    const category = tool.annotations.category;
+    const categoryCheck = getCategoryStatus(category, serverArgs);
+    if (category && categoryCheck.disabled) {
+        if (!categoryCheck.categoryFlag) {
+            throw new Error('when the category is disabled there should always be a flag set');
+        }
+        return {
+            disabled: true,
+            reason: buildDisabledMessage(tool.name, `--${categoryCheck.categoryFlag}`, labels[category]),
+        };
+    }
+    for (const condition of tool.annotations.conditions || []) {
+        const conditionCheck = getConditionStatus(condition, serverArgs);
+        if (conditionCheck.disabled) {
+            if (!conditionCheck.conditionFlag) {
+                throw new Error('when the condition is disabled there should always be a flag set');
+            }
+            return {
+                disabled: true,
+                reason: buildDisabledMessage(tool.name, `--${conditionCheck.conditionFlag}`),
+            };
+        }
+    }
+    return { disabled: false };
+}
+function isPageScopedTool(tool) {
+    return 'pageScoped' in tool && tool.pageScoped === true;
+}
+export class ToolHandler {
+    tool;
+    serverArgs;
+    getContext;
+    toolMutex;
+    inputSchema;
+    shouldRegister;
+    disabledReason;
+    constructor(tool, serverArgs, getContext, toolMutex) {
+        this.tool = tool;
+        this.serverArgs = serverArgs;
+        this.getContext = getContext;
+        this.toolMutex = toolMutex;
+        const { disabled, reason } = getToolStatusInfo(tool, serverArgs);
+        this.disabledReason = reason;
+        this.shouldRegister = !(disabled && !serverArgs.viaCli);
+        this.inputSchema =
+            'pageScoped' in tool &&
+                tool.pageScoped &&
+                serverArgs.experimentalPageIdRouting &&
+                !serverArgs.slim
+                ? { ...tool.schema, ...pageIdSchema }
+                : tool.schema;
+    }
+    async handle(params) {
+        if (this.disabledReason) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: this.disabledReason,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const guard = await this.toolMutex.acquire();
+        const startTime = Date.now();
+        let success = false;
+        try {
+            logger(`${this.tool.name} request: ${JSON.stringify(params, null, '  ')}`);
+            const context = await this.getContext();
+            logger(`${this.tool.name} context: resolved`);
+            await context.detectOpenDevToolsWindows();
+            const response = this.serverArgs.slim
+                ? new SlimMcpResponse(this.serverArgs)
+                : new McpResponse(this.serverArgs);
+            response.setRedactNetworkHeaders(this.serverArgs.redactNetworkHeaders);
+            try {
+                if (isPageScopedTool(this.tool)) {
+                    const pageId = typeof params.pageId === 'number' ? params.pageId : undefined;
+                    const page = this.serverArgs.experimentalPageIdRouting &&
+                        pageId !== undefined &&
+                        !this.serverArgs.slim
+                        ? context.getPageById(pageId)
+                        : context.getSelectedMcpPage();
+                    response.setPage(page);
+                    if (this.tool.blockedByDialog) {
+                        page.throwIfDialogOpen();
+                    }
+                    await this.tool.handler({
+                        params,
+                        page,
+                    }, response, context);
+                }
+                else {
+                    await this.tool.handler({
+                        params,
+                    }, response, context);
+                }
+            }
+            catch (err) {
+                response.setError(err);
+            }
+            const { content, structuredContent } = await response.handle(this.tool.name, context);
+            const result = {
+                content,
+            };
+            if (response.error) {
+                result.isError = true;
+            }
+            success = true;
+            if (this.serverArgs.experimentalStructuredContent) {
+                result.structuredContent = structuredContent;
+            }
+            return result;
+        }
+        catch (err) {
+            logger(`${this.tool.name} error:`, err, err?.stack);
+            let errorText = err && 'message' in err ? err.message : String(err);
+            if ('cause' in err && err.cause) {
+                errorText += `\nCause: ${err.cause.message}`;
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: errorText,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        finally {
+            void ClearcutLogger.get()?.logToolInvocation({
+                toolName: this.tool.name,
+                params,
+                schema: this.inputSchema,
+                success,
+                latencyMs: bucketizeLatency(Date.now() - startTime),
+            });
+            guard.dispose();
+        }
+    }
+}
+//# sourceMappingURL=ToolHandler.js.map

package/build/src/bin/chrome-devtools-cli-options.js

@@ -162,9 +162,27 @@ export const commands = {
             },
         },
     },
+    execute_3p_developer_tool: {
+        description: 'Executes a tool exposed by the page. (requires flag: --categoryExperimentalThirdParty=true)',
+        category: 'Third-party',
+        args: {
+            toolName: {
+                name: 'toolName',
+                type: 'string',
+                description: 'The name of the tool to execute',
+                required: true,
+            },
+            params: {
+                name: 'params',
+                type: 'string',
+                description: 'The JSON-stringified parameters to pass to the tool',
+                required: false,
+            },
+        },
+    },
     execute_webmcp_tool: {
-        description: 'Executes a WebMCP tool exposed by the page. (requires flag: --experimentalWebmcp=true)',
-        category: 'Debugging',
+        description: 'Executes a WebMCP tool exposed by the page. (requires flag: --categoryExperimentalWebmcp=true)',
+        category: 'WebMCP',
         args: {
             toolName: {
                 name: 'toolName',
@@ -193,7 +211,7 @@ export const commands = {
             value: {
                 name: 'value',
                 type: 'string',
-                description: 'The value to fill in',
+                description: 'The value to fill in. "true" or "false" for checkboxes and toggles, "true" for radio buttons.',
                 required: true,
             },
             includeSnapshot: {
@@ -371,6 +389,11 @@ export const commands = {
             },
         },
     },
+    list_3p_developer_tools: {
+        description: "Lists all third-party developer tools the page exposes for providing runtime information.\n  Third-party developer tools can be called via the 'execute_3p_developer_tool()' MCP tool.\n  Alternatively, third-party developer tools can be executed by calling 'evaluate_script' and adding the\n  following command to the script:\n  'window.__dtmcp.executeTool(toolName, params)'\n  This might be helpful when the third-party developer tools return non-serializable values or when composing\n  third-party developer tools with additional functionality. (requires flag: --categoryExperimentalThirdParty=true)",
+        category: 'Third-party',
+        args: {},
+    },
     list_console_messages: {
         description: 'List all console messages for the currently selected page since the last navigation.',
         category: 'Debugging',
@@ -444,8 +467,8 @@ export const commands = {
         args: {},
     },
     list_webmcp_tools: {
-        description: 'Lists all WebMCP tools the page exposes. (requires flag: --experimentalWebmcp=true)',
-        category: 'Debugging',
+        description: 'Lists all WebMCP tools the page exposes. (requires flag: --categoryExperimentalWebmcp=true)',
+        category: 'WebMCP',
         args: {},
     },
     load_memory_snapshot: {

package/build/src/bin/chrome-devtools-mcp-cli-options.js

@@ -183,7 +183,7 @@ export const cliOptions = {
         describe: 'Path to ffmpeg executable for screencast recording.',
         implies: 'experimentalScreencast',
     },
-    experimentalWebmcp: {
+    categoryExperimentalWebmcp: {
         type: 'boolean',
         describe: 'Set to true to enable debugging WebMCP tools. Requires Chrome 149+ with the following flags: `--enable-features=WebMCPTesting,DevToolsWebMCPSupport`',
     },
@@ -216,11 +216,10 @@ export const cliOptions = {
         default: false,
         describe: 'Set to true to include tools related to extensions. Note: This feature is currently only supported with a pipe connection. autoConnect, browserUrl, and wsEndpoint are not supported with this feature until 149 will be released.',
     },
-    categoryExperimentalInPage: {
+    categoryExperimentalThirdParty: {
         type: 'boolean',
-        hidden: true,
         default: false,
-        describe: 'Set to true to enable tools exposed by the inspected page itself',
+        describe: 'Set to true to enable third-party developer tools exposed by the inspected page itself',
     },
     performanceCrux: {
         type: 'boolean',
@@ -262,7 +261,7 @@ export const cliOptions = {
         default: false,
     },
 };
-export function parseArguments(version, argv = process.argv) {
+export function parseArguments(version, argv = process.argv, env = process.env) {
     const yargsInstance = yargs(hideBin(argv))
         .scriptName('npx chrome-devtools-mcp@latest')
         .options(cliOptions)
@@ -275,6 +274,10 @@ export function parseArguments(version, argv = process.argv) {
             !args.executablePath) {
             args.channel = 'stable';
         }
+        if (env['CI'] || env['CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS']) {
+            console.error("turning off usage statistics. process.env['CI'] || process.env['CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS'] is set.");
+            args.usageStatistics = false;
+        }
         return true;
     })
         .example([

package/build/src/bin/chrome-devtools-mcp-main.js

@@ -7,6 +7,7 @@ import '../polyfill.js';
 import process from 'node:process';
 import { createMcpServer, logDisclaimers } from '../index.js';
 import { logger, saveLogsToFile } from '../logger.js';
+import { ClearcutLogger } from '../telemetry/ClearcutLogger.js';
 import { computeFlagUsage } from '../telemetry/flagUtils.js';
 import { StdioServerTransport } from '../third_party/index.js';
 import { checkForUpdates } from '../utils/check-for-updates.js';
@@ -15,24 +16,19 @@ import { cliOptions, parseArguments } from './chrome-devtools-mcp-cli-options.js
 await checkForUpdates('Run `npm install chrome-devtools-mcp@latest` to update.');
 export const args = parseArguments(VERSION);
 const logFile = args.logFile ? saveLogsToFile(args.logFile) : undefined;
-if (process.env['CI'] ||
-    process.env['CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS']) {
-    console.error("turning off usage statistics. process.env['CI'] || process.env['CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS'] is set.");
-    args.usageStatistics = false;
-}
 if (process.env['CHROME_DEVTOOLS_MCP_CRASH_ON_UNCAUGHT'] !== 'true') {
     process.on('unhandledRejection', (reason, promise) => {
         logger('Unhandled promise rejection', promise, reason);
     });
 }
 logger(`Starting Chrome DevTools MCP Server v${VERSION}`);
-const { server, clearcutLogger } = await createMcpServer(args, {
+const { server } = await createMcpServer(args, {
     logFile,
 });
 const transport = new StdioServerTransport();
 await server.connect(transport);
 logger('Chrome DevTools MCP Server connected');
 logDisclaimers(args);
-void clearcutLogger?.logDailyActiveIfNeeded();
-void clearcutLogger?.logServerStart(computeFlagUsage(args, cliOptions));
+void ClearcutLogger.get()?.logDailyActiveIfNeeded();
+void ClearcutLogger.get()?.logServerStart(computeFlagUsage(args, cliOptions));
 //# sourceMappingURL=chrome-devtools-mcp-main.js.map

package/build/src/bin/chrome-devtools.js

@@ -24,8 +24,6 @@ const defaultArgs = ['--viaCli', '--experimentalStructuredContent'];
 const startCliOptions = {
     ...cliOptions,
 };
-// Not supported in CLI on purpose.
-delete startCliOptions.autoConnect;
 // Missing CLI serialization.
 delete startCliOptions.viewport;
 // Change the defaults for the CLI.