chrome-devtools-mcp 0.23.0 → 0.24.0

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

@@ -28,6 +28,36 @@ export const commands = {
             },
         },
     },
+    click_at: {
+        description: 'Clicks at the provided coordinates (requires flag: --experimentalVision=true)',
+        category: 'Input automation',
+        args: {
+            x: {
+                name: 'x',
+                type: 'number',
+                description: 'The x coordinate',
+                required: true,
+            },
+            y: {
+                name: 'y',
+                type: 'number',
+                description: 'The y coordinate',
+                required: true,
+            },
+            dblClick: {
+                name: 'dblClick',
+                type: 'boolean',
+                description: 'Set to true for double clicks. Default is false.',
+                required: false,
+            },
+            includeSnapshot: {
+                name: 'includeSnapshot',
+                type: 'boolean',
+                description: 'Whether to include a snapshot in the response. Default is false.',
+                required: false,
+            },
+        },
+    },
     close_page: {
         description: 'Closes the page by its index. The last open page cannot be closed.',
         category: 'Navigation automation',
@@ -84,7 +114,7 @@ export const commands = {
             geolocation: {
                 name: 'geolocation',
                 type: 'string',
-                description: 'Geolocation (`<latitude>x<longitude>`) to emulate. Latitude between -90 and 90. Longitude between -180 and 180. Omit clear the geolocation override.',
+                description: 'Geolocation (`<latitude>x<longitude>`) to emulate. Latitude between -90 and 90. Longitude between -180 and 180. Omit to clear the geolocation override.',
                 required: false,
             },
             userAgent: {
@@ -124,10 +154,34 @@ export const commands = {
                 description: 'An optional list of arguments to pass to the function.',
                 required: false,
             },
+            dialogAction: {
+                name: 'dialogAction',
+                type: 'string',
+                description: 'Handle dialogs while execution. "accept", "dismiss", or string for response of window.prompt. Defaults to accept.',
+                required: false,
+            },
+        },
+    },
+    execute_webmcp_tool: {
+        description: 'Executes a WebMCP tool exposed by the page. (requires flag: --experimentalWebmcp=true)',
+        category: 'Debugging',
+        args: {
+            toolName: {
+                name: 'toolName',
+                type: 'string',
+                description: 'The name of the WebMCP tool to execute',
+                required: true,
+            },
+            input: {
+                name: 'input',
+                type: 'string',
+                description: 'The JSON-stringified parameters to pass to the WebMCP tool',
+                required: false,
+            },
         },
     },
     fill: {
-        description: 'Type text into a input, text area or select an option from a <select> element.',
+        description: 'Type text into an input, text area or select an option from a <select> element.',
         category: 'Input automation',
         args: {
             uid: {
@@ -150,24 +204,6 @@ export const commands = {
             },
         },
     },
-    fill_form: {
-        description: 'Fill out multiple form elements at once',
-        category: 'Input automation',
-        args: {
-            elements: {
-                name: 'elements',
-                type: 'array',
-                description: 'Elements from snapshot to fill out.',
-                required: true,
-            },
-            includeSnapshot: {
-                name: 'includeSnapshot',
-                type: 'boolean',
-                description: 'Whether to include a snapshot in the response. Default is false.',
-                required: false,
-            },
-        },
-    },
     get_console_message: {
         description: 'Gets a console message by its ID. You can get all messages by calling list_console_messages.',
         category: 'Debugging',
@@ -180,6 +216,30 @@ export const commands = {
             },
         },
     },
+    get_memory_snapshot_details: {
+        description: 'Loads a memory heapsnapshot and returns all available information including statistics, static data, and aggregated node information. Supports pagination for aggregates. (requires flag: --experimentalMemory=true)',
+        category: 'Memory',
+        args: {
+            filePath: {
+                name: 'filePath',
+                type: 'string',
+                description: 'A path to a .heapsnapshot file to read.',
+                required: true,
+            },
+            pageIdx: {
+                name: 'pageIdx',
+                type: 'number',
+                description: 'The page index for pagination of aggregates.',
+                required: false,
+            },
+            pageSize: {
+                name: 'pageSize',
+                type: 'number',
+                description: 'The page size for pagination of aggregates.',
+                required: false,
+            },
+        },
+    },
     get_network_request: {
         description: 'Gets a network request by an optional reqid, if omitted returns the currently selected request in the DevTools Network panel.',
         category: 'Network',
@@ -193,13 +253,43 @@ export const commands = {
             requestFilePath: {
                 name: 'requestFilePath',
                 type: 'string',
-                description: 'The absolute or relative path to save the request body to. If omitted, the body is returned inline.',
+                description: 'The absolute or relative path to a .network-request file to save the request body to. If omitted, the body is returned inline.',
                 required: false,
             },
             responseFilePath: {
                 name: 'responseFilePath',
                 type: 'string',
-                description: 'The absolute or relative path to save the response body to. If omitted, the body is returned inline.',
+                description: 'The absolute or relative path to a .network-response file to save the response body to. If omitted, the body is returned inline.',
+                required: false,
+            },
+        },
+    },
+    get_nodes_by_class: {
+        description: 'Loads a memory heapsnapshot and returns instances of a specific class with their stable IDs. (requires flag: --experimentalMemory=true)',
+        category: 'Memory',
+        args: {
+            filePath: {
+                name: 'filePath',
+                type: 'string',
+                description: 'A path to a .heapsnapshot file to read.',
+                required: true,
+            },
+            uid: {
+                name: 'uid',
+                type: 'number',
+                description: 'The unique UID for the class, obtained from aggregates listing.',
+                required: true,
+            },
+            pageIdx: {
+                name: 'pageIdx',
+                type: 'number',
+                description: 'The page index for pagination.',
+                required: false,
+            },
+            pageSize: {
+                name: 'pageSize',
+                type: 'number',
+                description: 'The page size for pagination.',
                 required: false,
             },
         },
@@ -241,8 +331,20 @@ export const commands = {
             },
         },
     },
+    install_extension: {
+        description: 'Installs a Chrome extension from the given path. (requires flag: --categoryExtensions=true)',
+        category: 'Extensions',
+        args: {
+            path: {
+                name: 'path',
+                type: 'string',
+                description: 'Absolute path to the unpacked extension folder.',
+                required: true,
+            },
+        },
+    },
     lighthouse_audit: {
-        description: 'Get Lighthouse score and reports for accessibility, SEO and best practices. This excludes performance. For performance audits, run performance_start_trace',
+        description: 'Get Lighthouse score and reports for accessibility, SEO, best practices, and agentic browsing. This excludes performance. For performance audits, run performance_start_trace',
         category: 'Debugging',
         args: {
             mode: {
@@ -276,7 +378,7 @@ export const commands = {
             pageSize: {
                 name: 'pageSize',
                 type: 'integer',
-                description: 'Maximum number of messages to return. When omitted, returns all requests.',
+                description: 'Maximum number of messages to return. When omitted, returns all messages.',
                 required: false,
             },
             pageIdx: {
@@ -300,6 +402,11 @@ export const commands = {
             },
         },
     },
+    list_extensions: {
+        description: 'Lists all the Chrome extensions installed in the browser. This includes their name, ID, version, and enabled status. (requires flag: --categoryExtensions=true)',
+        category: 'Extensions',
+        args: {},
+    },
     list_network_requests: {
         description: 'List all requests for the currently selected page since the last navigation.',
         category: 'Network',
@@ -332,10 +439,27 @@ export const commands = {
         },
     },
     list_pages: {
-        description: 'Get a list of pages  open in the browser.',
+        description: 'Get a list of pages open in the browser.',
         category: 'Navigation automation',
         args: {},
     },
+    list_webmcp_tools: {
+        description: 'Lists all WebMCP tools the page exposes. (requires flag: --experimentalWebmcp=true)',
+        category: 'Debugging',
+        args: {},
+    },
+    load_memory_snapshot: {
+        description: 'Loads a memory heapsnapshot and returns snapshot summary stats. (requires flag: --experimentalMemory=true)',
+        category: 'Memory',
+        args: {
+            filePath: {
+                name: 'filePath',
+                type: 'string',
+                description: 'A path to a .heapsnapshot file to read.',
+                required: true,
+            },
+        },
+    },
     navigate_page: {
         description: 'Go to a URL, or back, forward, or reload. Use project URL if not specified otherwise.',
         category: 'Navigation automation',
@@ -484,6 +608,18 @@ export const commands = {
             },
         },
     },
+    reload_extension: {
+        description: 'Reloads an unpacked Chrome extension by its ID. (requires flag: --categoryExtensions=true)',
+        category: 'Extensions',
+        args: {
+            id: {
+                name: 'id',
+                type: 'string',
+                description: 'ID of the extension to reload.',
+                required: true,
+            },
+        },
+    },
     resize_page: {
         description: "Resizes the selected page's window so that the page has specified dimension",
         category: 'Emulation',
@@ -502,6 +638,23 @@ export const commands = {
             },
         },
     },
+    screencast_start: {
+        description: 'Starts recording a screencast (video) of the selected page in specified format. (requires flag: --experimentalScreencast=true)',
+        category: 'Debugging',
+        args: {
+            filePath: {
+                name: 'filePath',
+                type: 'string',
+                description: 'Output file path (.webm,.mp4 are supported). Uses mkdtemp to generate a unique path if not provided.',
+                required: false,
+            },
+        },
+    },
+    screencast_stop: {
+        description: 'Stops the active screencast recording on the selected page. (requires flag: --experimentalScreencast=true)',
+        category: 'Debugging',
+        args: {},
+    },
     select_page: {
         description: 'Select a page as a context for future tool calls.',
         category: 'Navigation automation',
@@ -521,8 +674,8 @@ export const commands = {
         },
     },
     take_memory_snapshot: {
-        description: 'Capture a memory heapsnapshot of the currently selected page to memory leak debugging',
-        category: 'Performance',
+        description: 'Capture a heap snapshot of the currently selected page. Use to analyze the memory distribution of JavaScript objects and debug memory leaks.',
+        category: 'Memory',
         args: {
             filePath: {
                 name: 'filePath',
@@ -553,7 +706,7 @@ export const commands = {
             uid: {
                 name: 'uid',
                 type: 'string',
-                description: 'The uid of an element on the page from the page content snapshot. If omitted takes a pages screenshot.',
+                description: 'The uid of an element on the page from the page content snapshot. If omitted, takes a page screenshot.',
                 required: false,
             },
             fullPage: {
@@ -588,6 +741,18 @@ export const commands = {
             },
         },
     },
+    trigger_extension_action: {
+        description: 'Triggers the default action of an extension by its ID. (requires flag: --categoryExtensions=true)',
+        category: 'Extensions',
+        args: {
+            id: {
+                name: 'id',
+                type: 'string',
+                description: 'ID of the extension to trigger the action for.',
+                required: true,
+            },
+        },
+    },
     type_text: {
         description: 'Type text using keyboard into a previously focused input',
         category: 'Input automation',
@@ -606,6 +771,18 @@ export const commands = {
             },
         },
     },
+    uninstall_extension: {
+        description: 'Uninstalls a Chrome extension by its ID. (requires flag: --categoryExtensions=true)',
+        category: 'Extensions',
+        args: {
+            id: {
+                name: 'id',
+                type: 'string',
+                description: 'ID of the extension to uninstall.',
+                required: true,
+            },
+        },
+    },
     upload_file: {
         description: 'Upload a file through a provided element.',
         category: 'Input automation',
@@ -630,22 +807,5 @@ export const commands = {
             },
         },
     },
-    wait_for: {
-        description: 'Wait for the specified text to appear on the selected page.',
-        category: 'Navigation automation',
-        args: {
-            text: {
-                name: 'text',
-                type: 'array',
-                description: 'Non-empty list of texts. Resolves when any value appears on the page.',
-                required: true,
-            },
-            timeout: {
-                name: 'timeout',
-                type: 'integer',
-                description: 'Maximum wait time in milliseconds. If set to 0, the default timeout will be used.',
-                required: false,
-            },
-        },
-    },
 };
+//# sourceMappingURL=chrome-devtools-cli-options.js.map

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

@@ -216,9 +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.',
     },
-    categoryInPageTools: {
+    categoryExperimentalInPage: {
         type: 'boolean',
         hidden: true,
+        default: false,
         describe: 'Set to true to enable tools exposed by the inspected page itself',
     },
     performanceCrux: {
@@ -344,3 +345,4 @@ export function parseArguments(version, argv = process.argv) {
         .version(version)
         .parseSync();
 }
+//# sourceMappingURL=chrome-devtools-mcp-cli-options.js.map

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

@@ -35,3 +35,4 @@ logger('Chrome DevTools MCP Server connected');
 logDisclaimers(args);
 void clearcutLogger?.logDailyActiveIfNeeded();
 void clearcutLogger?.logServerStart(computeFlagUsage(args, cliOptions));
+//# sourceMappingURL=chrome-devtools-mcp-main.js.map

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

@@ -20,3 +20,4 @@ if (major < 20) {
     process.exit(1);
 }
 await import('./chrome-devtools-mcp-main.js');
+//# sourceMappingURL=chrome-devtools-mcp.js.map

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

@@ -28,20 +28,10 @@ const startCliOptions = {
 delete startCliOptions.autoConnect;
 // Missing CLI serialization.
 delete startCliOptions.viewport;
-// CLI is generated based on the default tool definitions. To enable conditional
-// tools, they need to be enabled during CLI generation.
-delete startCliOptions.experimentalPageIdRouting;
-delete startCliOptions.experimentalVision;
-delete startCliOptions.experimentalWebmcp;
-delete startCliOptions.experimentalInteropTools;
-delete startCliOptions.experimentalScreencast;
-delete startCliOptions.categoryEmulation;
-delete startCliOptions.categoryPerformance;
-delete startCliOptions.categoryNetwork;
-delete startCliOptions.categoryExtensions;
-// Always on in CLI.
+// Change the defaults for the CLI.
 delete startCliOptions.experimentalStructuredContent;
-// Change the defaults.
+delete startCliOptions.experimentalInteropTools;
+delete startCliOptions.experimentalPageIdRouting;
 if (!('default' in cliOptions.headless)) {
     throw new Error('headless cli option unexpectedly does not have a default');
 }
@@ -51,6 +41,7 @@ if ('default' in cliOptions.isolated) {
 startCliOptions.headless.default = true;
 startCliOptions.isolated.description =
     'If specified, creates a temporary user-data-dir that is automatically cleaned up after the browser is closed. Defaults to true unless userDataDir is provided.';
+startCliOptions.categoryExtensions.default = true;
 const y = yargs(hideBin(process.argv))
     .scriptName('chrome-devtools')
     .showHelpOnFail(true)
@@ -197,3 +188,4 @@ for (const [commandName, commandDef] of Object.entries(commands)) {
     });
 }
 await y.parse();
+//# sourceMappingURL=chrome-devtools.js.map

package/build/src/browser.js

@@ -201,3 +201,4 @@ export async function ensureBrowserLaunched(options) {
     browser = await launch(options);
     return browser;
 }
+//# sourceMappingURL=browser.js.map

package/build/src/daemon/client.js

@@ -8,7 +8,7 @@ import fs from 'node:fs';
 import net from 'node:net';
 import { logger } from '../logger.js';
 import { PipeTransport } from '../third_party/index.js';
-import { saveTemporaryFile } from '../utils/files.js';
+import { getTempFilePath } from '../utils/files.js';
 import { DAEMON_SCRIPT_PATH, getSocketPath, getPidFilePath, isDaemonRunning, } from './utils.js';
 const FILE_TIMEOUT = 10_000;
 /**
@@ -141,7 +141,8 @@ export async function handleResponse(response, format) {
             }
             const data = Buffer.from(imageData, 'base64');
             const name = crypto.randomUUID();
-            const { filepath } = await saveTemporaryFile(data, `${name}${extension}`);
+            const filepath = await getTempFilePath(`${name}${extension}`);
+            fs.writeFileSync(filepath, data);
             chunks.push(`Saved to ${filepath}.`);
         }
         else {
@@ -150,3 +151,4 @@ export async function handleResponse(response, format) {
     }
     return format === 'md' ? chunks.join(' ') : JSON.stringify(chunks);
 }
+//# sourceMappingURL=client.js.map

package/build/src/daemon/daemon.js

@@ -201,3 +201,4 @@ const started = startSocketServer().catch(error => {
     logger('Failed to start daemon server:', error);
     process.exit(1);
 });
+//# sourceMappingURL=daemon.js.map

package/build/src/daemon/types.js

@@ -4,3 +4,4 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 export {};
+//# sourceMappingURL=types.js.map

package/build/src/daemon/utils.js

@@ -112,3 +112,4 @@ export function serializeArgs(options, argv) {
     }
     return args;
 }
+//# sourceMappingURL=utils.js.map

package/build/src/formatters/ConsoleFormatter.js

@@ -131,6 +131,36 @@ export class ConsoleFormatter {
             id: this.#id,
         };
     }
+    /**
+     * Groups consecutive messages with the same type, text, and argument count.
+     * Similar to Chrome DevTools' console grouping behavior.
+     */
+    static groupConsecutive(messages) {
+        const grouped = [];
+        for (const msg of messages) {
+            const prev = grouped[grouped.length - 1];
+            if (prev &&
+                prev.message instanceof ConsoleFormatter &&
+                msg instanceof ConsoleFormatter &&
+                prev.message.#type === msg.#type &&
+                prev.message.#text === msg.#text &&
+                prev.message.#argCount === msg.#argCount) {
+                prev.count++;
+            }
+            else {
+                grouped.push({ message: msg, count: 1 });
+            }
+        }
+        return grouped.map(({ message, count }) => count > 1 && message instanceof ConsoleFormatter
+            ? new GroupedConsoleFormatter({
+                id: message.#id,
+                type: message.#type,
+                text: message.#text,
+                argCount: message.#argCount,
+                isIgnored: message.isIgnored,
+            }, count)
+            : message);
+    }
     toJSONDetailed() {
         return {
             id: this.#id,
@@ -144,8 +174,24 @@ export class ConsoleFormatter {
         };
     }
 }
+export class GroupedConsoleFormatter extends ConsoleFormatter {
+    #count;
+    constructor(params, count) {
+        super(params);
+        this.#count = count;
+    }
+    toString() {
+        return convertConsoleMessageConciseToString(this.toJSON());
+    }
+    toJSON() {
+        const json = super.toJSON();
+        json.count = this.#count;
+        return json;
+    }
+}
 function convertConsoleMessageConciseToString(msg) {
-    return `msgid=${msg.id} [${msg.type}] ${msg.text} (${msg.argsCount} args)`;
+    const countSuffix = msg.count && msg.count > 1 ? ` [${msg.count} times]` : '';
+    return `msgid=${msg.id} [${msg.type}] ${msg.text} (${msg.argsCount} args)${countSuffix}`;
 }
 function convertConsoleMessageConciseDetailedToString(msg) {
     const result = [
@@ -239,3 +285,4 @@ function formatCause(cause, formatter) {
         ...formatStackTraceInner(cause.stackTrace, cause.cause, formatter),
     ];
 }
+//# sourceMappingURL=ConsoleFormatter.js.map

package/build/src/formatters/HeapSnapshotFormatter.js

@@ -4,13 +4,28 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { stableIdSymbol } from '../utils/id.js';
+export function isNodeLike(item) {
+    return (typeof item === 'object' && item !== null && 'id' in item && 'name' in item);
+}
 export class HeapSnapshotFormatter {
     #aggregates;
     constructor(aggregates) {
         this.#aggregates = aggregates;
     }
+    static formatNodes(items) {
+        const lines = [];
+        if (items.length > 0 && isNodeLike(items[0])) {
+            lines.push('id,name,type,distance,selfSize,retainedSize');
+        }
+        for (const item of items) {
+            if (isNodeLike(item)) {
+                lines.push(`${item.id},"${item.name}",${item.type},${item.distance},${item.selfSize},${item.retainedSize}`);
+            }
+        }
+        return lines.join('\n');
+    }
     #getSortedAggregates() {
-        return Object.values(this.#aggregates).sort((a, b) => b.self - a.self);
+        return Object.values(this.#aggregates).sort((a, b) => b.maxRet - a.maxRet);
     }
     toString() {
         const sorted = this.#getSortedAggregates();
@@ -33,6 +48,7 @@ export class HeapSnapshotFormatter {
         }));
     }
     static sort(aggregates) {
-        return Object.entries(aggregates).sort((a, b) => b[1].self - a[1].self);
+        return Object.entries(aggregates).sort((a, b) => b[1].maxRet - a[1].maxRet);
     }
 }
+//# sourceMappingURL=HeapSnapshotFormatter.js.map

package/build/src/formatters/IssueFormatter.js

@@ -190,3 +190,4 @@ function convertIssueDetailedToString(issue) {
     result.push(`Message: issue> ${bodyParts.join('\n')}`);
     return result.join('\n');
 }
+//# sourceMappingURL=IssueFormatter.js.map

package/build/src/formatters/NetworkFormatter.js

@@ -233,3 +233,4 @@ function converNetworkRequestDetailedToStringDetailed(data) {
     }
     return response.join('\n');
 }
+//# sourceMappingURL=NetworkFormatter.js.map

package/build/src/formatters/SnapshotFormatter.js

@@ -12,7 +12,7 @@ export class SnapshotFormatter {
         const chunks = [];
         const root = this.#snapshot.root;
         // Top-level content of the snapshot.
-        if (this.#snapshot.verbose &&
+        if (!this.#snapshot.verbose &&
             this.#snapshot.hasSelectedElement &&
             !this.#snapshot.selectedElementUid) {
             chunks.push(`Note: there is a selected element in the DevTools Elements panel but it is not included into the current a11y tree snapshot.
@@ -132,3 +132,4 @@ const excludedAttributes = new Set([
     'backendNodeId',
     'loaderId',
 ]);
+//# sourceMappingURL=SnapshotFormatter.js.map