chrome-devtools-mcp 0.25.0 → 1.0.1

package/build/src/tools/ToolDefinition.js

@@ -64,7 +64,7 @@ export function geolocationTransform(arg) {
     if (!arg) {
         return undefined;
     }
-    const [latitude, longitude] = arg.split('x').map(Number);
+    const [latitude, longitude] = arg.split(',').map(Number);
     return {
         latitude,
         longitude,

package/build/src/tools/emulation.js

@@ -33,7 +33,7 @@ export const emulate = definePageTool({
             .string()
             .optional()
             .transform(geolocationTransform)
-            .describe('Geolocation (`<latitude>x<longitude>`) to emulate. Latitude between -90 and 90. Longitude between -180 and 180. Omit to clear the geolocation override.'),
+            .describe('Geolocation (`<latitude>,<longitude>`) to emulate. Latitude between -90 and 90. Longitude between -180 and 180. Omit to clear the geolocation override.'),
         userAgent: zod
             .string()
             .optional()
@@ -49,9 +49,10 @@ export const emulate = definePageTool({
             .describe(`Emulate device viewports '<width>x<height>x<devicePixelRatio>[,mobile][,touch][,landscape]'. 'touch' and 'mobile' to emulate mobile devices. 'landscape' to emulate landscape mode.`),
     },
     blockedByDialog: true,
-    handler: async (request, _response, context) => {
+    handler: async (request, response, context) => {
         const page = request.page;
         await context.emulate(request.params, page.pptrPage);
+        response.appendResponseLine('Emulation configured successfully');
     },
 });
 //# sourceMappingURL=emulation.js.map

package/build/src/tools/input.js

@@ -85,7 +85,7 @@ export const click = definePageTool({
         const aXNode = request.page.getAXNodeByUid(uid);
         const shouldSelectNativeOption = !request.params.dblClick && aXNode?.role === 'option';
         try {
-            await request.page.waitForEventsAfterAction(async () => {
+            const result = await request.page.waitForEventsAfterAction(async () => {
                 if (shouldSelectNativeOption &&
                     (await selectNativeSelectOption(handle))) {
                     return;
@@ -97,6 +97,7 @@ export const click = definePageTool({
             response.appendResponseLine(request.params.dblClick
                 ? `Successfully double clicked on the element`
                 : `Successfully clicked on the element`);
+            response.attachWaitForResult(result);
             if (request.params.includeSnapshot) {
                 response.includeSnapshot();
             }
@@ -126,14 +127,15 @@ export const clickAt = definePageTool({
     blockedByDialog: true,
     handler: async (request, response) => {
         const page = request.page;
-        await page.waitForEventsAfterAction(async () => {
+        const result = await page.waitForEventsAfterAction(async () => {
             await page.pptrPage.mouse.click(request.params.x, request.params.y, {
-                clickCount: request.params.dblClick ? 2 : 1,
+                count: request.params.dblClick ? 2 : 1,
             });
         });
         response.appendResponseLine(request.params.dblClick
             ? `Successfully double clicked at the coordinates`
             : `Successfully clicked at the coordinates`);
+        response.attachWaitForResult(result);
         if (request.params.includeSnapshot) {
             response.includeSnapshot();
         }
@@ -157,10 +159,11 @@ export const hover = definePageTool({
         const uid = request.params.uid;
         const handle = await request.page.getElementByUid(uid);
         try {
-            await request.page.waitForEventsAfterAction(async () => {
+            const result = await request.page.waitForEventsAfterAction(async () => {
                 await handle.asLocator().hover();
             });
             response.appendResponseLine(`Successfully hovered over the element`);
+            response.attachWaitForResult(result);
             if (request.params.includeSnapshot) {
                 response.includeSnapshot();
             }
@@ -220,10 +223,27 @@ async function fillFormElement(uid, value, context, page) {
             await selectOption(handle, aXNode, value);
         }
         else {
-            // Increase timeout for longer input values.
-            const timeoutPerChar = 10; // ms
-            const fillTimeout = page.pptrPage.getDefaultTimeout() + value.length * timeoutPerChar;
-            await handle.asLocator().setTimeout(fillTimeout).fill(value);
+            const isToggle = await handle.evaluate(el => {
+                if (el instanceof HTMLInputElement) {
+                    return el.type === 'checkbox' || el.type === 'radio';
+                }
+                const role = el.getAttribute('role');
+                return role === 'checkbox' || role === 'radio' || role === 'switch';
+            });
+            if (isToggle) {
+                if (['true', 'false'].includes(value)) {
+                    await handle.asLocator().fill(value === 'true');
+                }
+                else {
+                    throw new Error(`Checkboxes, radio boxes and toggles require "true" or "false" value, but ${value} was used`);
+                }
+            }
+            else {
+                // Increase timeout for longer input values.
+                const timeoutPerChar = 10; // ms
+                const fillTimeout = page.pptrPage.getDefaultTimeout() + value.length * timeoutPerChar;
+                await handle.asLocator().setTimeout(fillTimeout).fill(value);
+            }
         }
     }
     catch (error) {
@@ -244,16 +264,19 @@ export const fill = definePageTool({
         uid: zod
             .string()
             .describe('The uid of an element on the page from the page content snapshot'),
-        value: zod.string().describe('The value to fill in'),
+        value: zod
+            .string()
+            .describe('The value to fill in. "true" or "false" for checkboxes and toggles, "true" for radio buttons.'),
         includeSnapshot: includeSnapshotSchema,
     },
     blockedByDialog: true,
     handler: async (request, response, context) => {
         const page = request.page;
-        await page.waitForEventsAfterAction(async () => {
+        const result = await page.waitForEventsAfterAction(async () => {
             await fillFormElement(request.params.uid, request.params.value, context, page);
         });
         response.appendResponseLine(`Successfully filled out the element`);
+        response.attachWaitForResult(result);
         if (request.params.includeSnapshot) {
             response.includeSnapshot();
         }
@@ -273,13 +296,14 @@ export const typeText = definePageTool({
     blockedByDialog: true,
     handler: async (request, response) => {
         const page = request.page;
-        await page.waitForEventsAfterAction(async () => {
+        const result = await page.waitForEventsAfterAction(async () => {
             await page.pptrPage.keyboard.type(request.params.text);
             if (request.params.submitKey) {
                 await page.pptrPage.keyboard.press(request.params.submitKey);
             }
         });
         response.appendResponseLine(`Typed text "${request.params.text}${request.params.submitKey ? ` + ${request.params.submitKey}` : ''}"`);
+        response.attachWaitForResult(result);
     },
 });
 export const drag = definePageTool({
@@ -299,12 +323,13 @@ export const drag = definePageTool({
         const fromHandle = await request.page.getElementByUid(request.params.from_uid);
         const toHandle = await request.page.getElementByUid(request.params.to_uid);
         try {
-            await request.page.waitForEventsAfterAction(async () => {
+            const result = await request.page.waitForEventsAfterAction(async () => {
                 await fromHandle.drag(toHandle);
                 await new Promise(resolve => setTimeout(resolve, 50));
                 await toHandle.drop(fromHandle);
             });
             response.appendResponseLine(`Successfully dragged an element`);
+            response.attachWaitForResult(result);
             if (request.params.includeSnapshot) {
                 response.includeSnapshot();
             }
@@ -317,7 +342,7 @@ export const drag = definePageTool({
 });
 export const fillForm = definePageTool({
     name: 'fill_form',
-    description: `Fill out multiple form elements at once`,
+    description: `Fill out multiple form elements (inputs, selects, checkboxes, radios) at once. ALWAYS prefer this tool over multiple individual 'fill' or 'click' calls when interacting with forms. It is significantly faster, more reliable, and reduces turn count. Example: Fill username, password, and check "Remember Me" in one call.`,
     annotations: {
         category: ToolCategory.INPUT,
         readOnlyHint: false,
@@ -328,7 +353,9 @@ export const fillForm = definePageTool({
         // eslint-disable-next-line @local/enforce-zod-schema
         zod.object({
             uid: zod.string().describe('The uid of the element to fill out'),
-            value: zod.string().describe('Value for the element'),
+            value: zod
+                .string()
+                .describe('Value for the element. "true" or "false" for checkboxes and toggles, "true" for radio buttons.'),
         }))
             .describe('Elements from snapshot to fill out.'),
         includeSnapshot: includeSnapshotSchema,
@@ -336,12 +363,14 @@ export const fillForm = definePageTool({
     blockedByDialog: true,
     handler: async (request, response, context) => {
         const page = request.page;
+        let lastResult = {};
         for (const element of request.params.elements) {
-            await page.waitForEventsAfterAction(async () => {
+            lastResult = await page.waitForEventsAfterAction(async () => {
                 await fillFormElement(element.uid, element.value, context, page);
             });
         }
         response.appendResponseLine(`Successfully filled out the form`);
+        response.attachWaitForResult(lastResult);
         if (request.params.includeSnapshot) {
             response.includeSnapshot();
         }
@@ -413,7 +442,7 @@ export const pressKey = definePageTool({
         const page = request.page;
         const tokens = parseKey(request.params.key);
         const [key, ...modifiers] = tokens;
-        await page.waitForEventsAfterAction(async () => {
+        const result = await page.waitForEventsAfterAction(async () => {
             for (const modifier of modifiers) {
                 await page.pptrPage.keyboard.down(modifier);
             }
@@ -423,6 +452,7 @@ export const pressKey = definePageTool({
             }
         });
         response.appendResponseLine(`Successfully pressed key: ${request.params.key}`);
+        response.attachWaitForResult(result);
         if (request.params.includeSnapshot) {
             response.includeSnapshot();
         }

package/build/src/tools/lighthouse.js

@@ -4,7 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import path from 'node:path';
-import { snapshot, navigation, generateReport, zod, agenticBrowsingConfig, } from '../third_party/index.js';
+import { snapshot, navigation, generateReport, zod, } from '../third_party/index.js';
 import { ToolCategory } from './categories.js';
 import { startTrace } from './performance.js';
 import { definePageTool } from './ToolDefinition.js';
@@ -67,17 +67,17 @@ export const lighthouseAudit = definePageTool({
                 disabled: false,
             };
         }
-        const options = {
-            flags,
-            config: agenticBrowsingConfig,
-        };
         let result;
         try {
             if (mode === 'navigation') {
-                result = await navigation(page.pptrPage, page.pptrPage.url(), options);
+                result = await navigation(page.pptrPage, page.pptrPage.url(), {
+                    flags,
+                });
             }
             else {
-                result = await snapshot(page.pptrPage, options);
+                result = await snapshot(page.pptrPage, {
+                    flags,
+                });
             }
             if (!result) {
                 throw new Error('Lighthouse audit failed.');

package/build/src/tools/memory.js

@@ -103,4 +103,28 @@ export const getNodesByClass = defineTool({
         });
     },
 });
+export const getNodeRetainers = defineTool({
+    name: 'get_node_retainers',
+    description: 'Loads a memory heapsnapshot and returns retainers for a specific node ID.',
+    annotations: {
+        category: ToolCategory.MEMORY,
+        readOnlyHint: true,
+        conditions: ['experimentalMemory'],
+    },
+    blockedByDialog: false,
+    schema: {
+        filePath: zod.string().describe('A path to a .heapsnapshot file to read.'),
+        nodeId: zod.number().describe('The stable node ID to get retainers for.'),
+        pageIdx: zod.number().optional().describe('The page index for pagination.'),
+        pageSize: zod.number().optional().describe('The page size for pagination.'),
+    },
+    handler: async (request, response, context) => {
+        context.validatePath(request.params.filePath);
+        const retainers = await context.getHeapSnapshotRetainers(request.params.filePath, request.params.nodeId);
+        response.setHeapSnapshotNodes(retainers, {
+            pageIdx: request.params.pageIdx,
+            pageSize: request.params.pageSize,
+        });
+    },
+});
 //# sourceMappingURL=memory.js.map

package/build/src/tools/script.js

@@ -32,6 +32,10 @@ Example with arguments: \`(el) => {
                 .describe('The uid of an element on the page from the page content snapshot'))
                 .optional()
                 .describe(`An optional list of arguments to pass to the function.`),
+            filePath: zod
+                .string()
+                .optional()
+                .describe('The absolute or relative path to a file to save the script output to. If omitted, the output is returned inline.'),
             dialogAction: zod
                 .string()
                 .optional()
@@ -48,7 +52,8 @@ Example with arguments: \`(el) => {
         },
         blockedByDialog: true,
         handler: async (request, response, context) => {
-            const { serviceWorkerId, args: uidArgs, function: fnString, pageId, dialogAction, } = request.params;
+            const { serviceWorkerId, args: uidArgs, function: fnString, pageId, dialogAction, filePath, } = request.params;
+            context.validatePath(filePath);
             if (cliArgs?.categoryExtensions && serviceWorkerId) {
                 if (uidArgs && uidArgs.length > 0) {
                     throw new Error('args (element uids) cannot be used when evaluating in a service worker.');
@@ -57,9 +62,15 @@ Example with arguments: \`(el) => {
                     throw new Error('specify either a pageId or a serviceWorkerId.');
                 }
                 const worker = await getWebWorker(context, serviceWorkerId);
-                await context.getSelectedMcpPage().waitForEventsAfterAction(async () => {
-                    await performEvaluation(worker, fnString, [], response);
+                const result = await context
+                    .getSelectedMcpPage()
+                    .waitForEventsAfterAction(async () => {
+                    await performEvaluation(worker, fnString, [], response, {
+                        filePath,
+                        context,
+                    });
                 }, { handleDialog: dialogAction ?? 'accept' });
+                response.attachWaitForResult(result);
                 return;
             }
             const mcpPage = cliArgs?.experimentalPageIdRouting
@@ -75,9 +86,13 @@ Example with arguments: \`(el) => {
                     args.push(handle);
                 }
                 const evaluatable = await getPageOrFrame(page, frames);
-                await mcpPage.waitForEventsAfterAction(async () => {
-                    await performEvaluation(evaluatable, fnString, args, response);
+                const result = await mcpPage.waitForEventsAfterAction(async () => {
+                    await performEvaluation(evaluatable, fnString, args, response, {
+                        filePath,
+                        context,
+                    });
                 }, { handleDialog: dialogAction ?? 'accept' });
+                response.attachWaitForResult(result);
             }
             finally {
                 void Promise.allSettled(args.map(arg => arg.dispose()));
@@ -85,17 +100,24 @@ Example with arguments: \`(el) => {
         },
     };
 });
-const performEvaluation = async (evaluatable, fnString, args, response) => {
+const performEvaluation = async (evaluatable, fnString, args, response, options) => {
     const fn = await evaluatable.evaluateHandle(`(${fnString})`);
     try {
         const result = await evaluatable.evaluate(async (fn, ...args) => {
             // @ts-expect-error no types for function fn
             return JSON.stringify(await fn(...args));
         }, fn, ...args);
-        response.appendResponseLine('Script ran on page and returned:');
-        response.appendResponseLine('```json');
-        response.appendResponseLine(`${result}`);
-        response.appendResponseLine('```');
+        if (options?.filePath) {
+            const data = new TextEncoder().encode(result ?? 'undefined');
+            const { filename } = await options.context.saveFile(data, options.filePath, '.json');
+            response.appendResponseLine(`Script ran on page. Output saved to ${filename}.`);
+        }
+        else {
+            response.appendResponseLine('Script ran on page and returned:');
+            response.appendResponseLine('```json');
+            response.appendResponseLine(`${result}`);
+            response.appendResponseLine('```');
+        }
     }
     finally {
         void fn.dispose();

package/build/src/version.js

@@ -5,6 +5,6 @@
  */
 // If moved update release-please config
 // x-release-please-start-version
-export const VERSION = '0.25.0';
+export const VERSION = '1.0.1';
 // x-release-please-end
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chrome-devtools-mcp",
-  "version": "0.25.0",
+  "version": "1.0.1",
   "description": "MCP server for Chrome DevTools",
   "type": "module",
   "bin": {
@@ -48,7 +48,7 @@
   "mcpName": "io.github.ChromeDevTools/chrome-devtools-mcp",
   "devDependencies": {
     "@eslint/js": "^9.35.0",
-    "@google/genai": "^1.37.0",
+    "@google/genai": "^2.0.1",
     "@modelcontextprotocol/sdk": "1.29.0",
     "@rollup/plugin-commonjs": "^29.0.0",
     "@rollup/plugin-json": "^6.1.0",
@@ -62,21 +62,21 @@
     "@types/yargs": "^17.0.33",
     "@typescript-eslint/eslint-plugin": "^8.43.0",
     "@typescript-eslint/parser": "^8.43.0",
-    "chrome-devtools-frontend": "1.0.1625079",
+    "chrome-devtools-frontend": "1.0.1631386",
     "core-js": "3.49.0",
     "debug": "4.4.3",
     "eslint": "^9.35.0",
     "eslint-import-resolver-typescript": "^4.4.4",
     "eslint-plugin-import": "^2.32.0",
     "globals": "^17.0.0",
-    "lighthouse": "13.2.0",
+    "lighthouse": "13.3.0",
     "prettier": "^3.6.2",
-    "puppeteer": "24.43.0",
-    "rollup": "4.60.2",
+    "puppeteer": "25.0.4",
+    "rollup": "4.60.4",
     "rollup-plugin-cleanup": "^3.2.1",
     "rollup-plugin-license": "^3.6.0",
     "semver": "^7.7.4",
-    "sinon": "^21.0.0",
+    "sinon": "^22.0.0",
     "typescript": "^6.0.2",
     "typescript-eslint": "^8.43.0",
     "urlpattern-polyfill": "^10.1.0",
@@ -84,5 +84,8 @@
   },
   "engines": {
     "node": "^20.19.0 || ^22.12.0 || >=23"
+  },
+  "overrides": {
+    "puppeteer-core": "$puppeteer"
   }
 }

package/build/src/telemetry/metricUtils.js

@@ -1,15 +0,0 @@
-/**
- * @license
- * Copyright 2026 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-const LATENCY_BUCKETS = [50, 100, 250, 500, 1000, 2500, 5000, 10000];
-export function bucketizeLatency(latencyMs) {
-    for (const bucket of LATENCY_BUCKETS) {
-        if (latencyMs <= bucket) {
-            return bucket;
-        }
-    }
-    return LATENCY_BUCKETS[LATENCY_BUCKETS.length - 1];
-}
-//# sourceMappingURL=metricUtils.js.map