chrome-devtools-mcp 0.20.2 → 0.21.0

package/build/src/tools/categories.js

@@ -12,6 +12,7 @@ export var ToolCategory;
     ToolCategory["NETWORK"] = "network";
     ToolCategory["DEBUGGING"] = "debugging";
     ToolCategory["EXTENSIONS"] = "extensions";
+    ToolCategory["IN_PAGE"] = "in-page";
 })(ToolCategory || (ToolCategory = {}));
 export const labels = {
     [ToolCategory.INPUT]: 'Input automation',
@@ -21,4 +22,5 @@ export const labels = {
     [ToolCategory.NETWORK]: 'Network',
     [ToolCategory.DEBUGGING]: 'Debugging',
     [ToolCategory.EXTENSIONS]: 'Extensions',
+    [ToolCategory.IN_PAGE]: 'In-page tools',
 };

package/build/src/tools/inPage.js

@@ -0,0 +1,84 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { zod, ajv } from '../third_party/index.js';
+import { ToolCategory } from './categories.js';
+import { definePageTool } from './ToolDefinition.js';
+export const listInPageTools = definePageTool({
+    name: 'list_in_page_tools',
+    description: `Lists all in-page tools the page exposes for providing runtime information.
+  In-page tools can be called via the 'execute_in_page_tool()' MCP tool.
+  Alternatively, in-page tools can be executed by calling 'evaluate_script' and adding the
+  following command to the script:
+  'window.__dtmcp.executeTool(toolName, params)'
+  This might be helpful when the in-page-tools return non-serializable values or when composing
+  the in-page-tools with additional functionality.`,
+    annotations: {
+        category: ToolCategory.IN_PAGE,
+        readOnlyHint: true,
+        conditions: ['inPageTools'],
+    },
+    schema: {},
+    handler: async (_request, response, _context) => {
+        response.setListInPageTools();
+    },
+});
+export const executeInPageTool = definePageTool({
+    name: 'execute_in_page_tool',
+    description: `Executes a tool exposed by the page.`,
+    annotations: {
+        category: ToolCategory.IN_PAGE,
+        readOnlyHint: false,
+        conditions: ['inPageTools'],
+    },
+    schema: {
+        toolName: zod.string().describe('The name of the tool to execute'),
+        params: zod
+            .string()
+            .optional()
+            .describe('The JSON-stringified parameters to pass to the tool'),
+    },
+    handler: async (request, response, context) => {
+        const page = context.getSelectedMcpPage();
+        const toolName = request.params.toolName;
+        let params = {};
+        if (request.params.params) {
+            try {
+                const parsed = JSON.parse(request.params.params);
+                if (typeof parsed === 'object' && parsed !== null) {
+                    params = parsed;
+                }
+                else {
+                    throw new Error('Parsed params is not an object');
+                }
+            }
+            catch (e) {
+                const errorMessage = e instanceof Error ? e.message : String(e);
+                throw new Error(`Failed to parse params as JSON: ${errorMessage}`);
+            }
+        }
+        const toolGroup = context.getInPageTools();
+        const tool = toolGroup?.tools.find(t => t.name === toolName);
+        if (!tool) {
+            throw new Error(`Tool ${toolName} not found`);
+        }
+        const ajvInstance = new ajv();
+        const validate = ajvInstance.compile(tool.inputSchema);
+        const valid = validate(params);
+        if (!valid) {
+            throw new Error(`Invalid parameters for tool ${toolName}: ${ajvInstance.errorsText(validate.errors)}`);
+        }
+        const result = await page.pptrPage.evaluate(async (name, args) => {
+            if (!window.__dtmcp?.executeTool) {
+                throw new Error('No tools found on the page');
+            }
+            const toolResult = await window.__dtmcp.executeTool(name, args);
+            return {
+                result: toolResult,
+            };
+        }, toolName, params);
+        response.appendResponseLine(JSON.stringify(result, null, 2));
+    },
+});

package/build/src/tools/input.js

@@ -186,6 +186,7 @@ async function fillFormElement(uid, value, context, page) {
         void handle.dispose();
     }
 }
+// here
 export const fill = definePageTool({
     name: 'fill',
     description: `Type text into a input, text area or select an option from a <select> element.`,
@@ -274,7 +275,9 @@ export const fillForm = definePageTool({
     },
     schema: {
         elements: zod
-            .array(zod.object({
+            .array(
+        // 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'),
         }))

package/build/src/tools/lighthouse.js

@@ -13,7 +13,7 @@ export const lighthouseAudit = definePageTool({
     description: `Get Lighthouse score and reports for accessibility, SEO and best practices. This excludes performance. For performance audits, run ${startTrace.name}`,
     annotations: {
         category: ToolCategory.DEBUGGING,
-        readOnlyHint: true,
+        readOnlyHint: false,
     },
     schema: {
         mode: zod

package/build/src/tools/memory.js

@@ -8,10 +8,10 @@ import { ToolCategory } from './categories.js';
 import { definePageTool } from './ToolDefinition.js';
 export const takeMemorySnapshot = definePageTool({
     name: 'take_memory_snapshot',
-    description: `Capture a memory heapsnapshot of the currently selected page to memory leak debugging`,
+    description: `Capture a heap snapshot of the currently selected page. Use to analyze the memory distribution of JavaScript objects and debug memory leaks.`,
     annotations: {
         category: ToolCategory.PERFORMANCE,
-        readOnlyHint: true,
+        readOnlyHint: false,
     },
     schema: {
         filePath: zod

package/build/src/tools/pages.js

@@ -7,7 +7,7 @@ import { logger } from '../logger.js';
 import { zod } from '../third_party/index.js';
 import { ToolCategory } from './categories.js';
 import { CLOSE_PAGE_ERROR, definePageTool, defineTool, timeoutSchema, } from './ToolDefinition.js';
-export const listPages = definePageTool(args => {
+export const listPages = defineTool(args => {
     return {
         name: 'list_pages',
         description: `Get a list of pages ${args?.categoryExtensions ? 'including extension service workers' : ''} open in the browser.`,
@@ -18,6 +18,7 @@ export const listPages = definePageTool(args => {
         schema: {},
         handler: async (_request, response) => {
             response.setIncludePages(true);
+            response.setListInPageTools();
         },
     };
 });
@@ -41,6 +42,7 @@ export const selectPage = defineTool({
         const page = context.getPageById(request.params.pageId);
         context.selectPage(page);
         response.setIncludePages(true);
+        response.setListInPageTools();
         if (request.params.bringToFront) {
             await page.pptrPage.bringToFront();
         }
@@ -71,6 +73,7 @@ export const closePage = defineTool({
             }
         }
         response.setIncludePages(true);
+        response.setListInPageTools();
     },
 });
 export const newPage = defineTool({
@@ -102,6 +105,7 @@ export const newPage = defineTool({
             });
         }, { timeout: request.params.timeout });
         response.setIncludePages(true);
+        response.setListInPageTools();
     },
 });
 export const navigatePage = definePageTool({
@@ -222,6 +226,7 @@ export const navigatePage = definePageTool({
             }
         }
         response.setIncludePages(true);
+        response.setListInPageTools();
     },
 });
 export const resizePage = definePageTool({

package/build/src/tools/tools.js

@@ -6,6 +6,7 @@
 import * as consoleTools from './console.js';
 import * as emulationTools from './emulation.js';
 import * as extensionTools from './extensions.js';
+import * as inPageTools from './inPage.js';
 import * as inputTools from './input.js';
 import * as lighthouseTools from './lighthouse.js';
 import * as memoryTools from './memory.js';
@@ -24,6 +25,7 @@ export const createTools = (args) => {
             ...Object.values(consoleTools),
             ...Object.values(emulationTools),
             ...Object.values(extensionTools),
+            ...Object.values(inPageTools),
             ...Object.values(inputTools),
             ...Object.values(lighthouseTools),
             ...Object.values(memoryTools),

package/build/src/version.js

@@ -5,5 +5,5 @@
  */
 // If moved update release-please config
 // x-release-please-start-version
-export const VERSION = '0.20.2';
+export const VERSION = '0.21.0';
 // x-release-please-end

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chrome-devtools-mcp",
-  "version": "0.20.2",
+  "version": "0.21.0",
   "description": "MCP server for Chrome DevTools",
   "type": "module",
   "bin": {
@@ -47,7 +47,7 @@
   "devDependencies": {
     "@eslint/js": "^9.35.0",
     "@google/genai": "^1.37.0",
-    "@modelcontextprotocol/sdk": "1.27.1",
+    "@modelcontextprotocol/sdk": "1.28.0",
     "@rollup/plugin-commonjs": "^29.0.0",
     "@rollup/plugin-json": "^6.1.0",
     "@rollup/plugin-node-resolve": "^16.0.3",
@@ -59,8 +59,8 @@
     "@types/yargs": "^17.0.33",
     "@typescript-eslint/eslint-plugin": "^8.43.0",
     "@typescript-eslint/parser": "^8.43.0",
-    "chrome-devtools-frontend": "1.0.1596260",
-    "core-js": "3.48.0",
+    "chrome-devtools-frontend": "1.0.1602348",
+    "core-js": "3.49.0",
     "debug": "4.4.3",
     "eslint": "^9.35.0",
     "eslint-import-resolver-typescript": "^4.4.4",
@@ -68,8 +68,8 @@
     "globals": "^17.0.0",
     "lighthouse": "13.0.3",
     "prettier": "^3.6.2",
-    "puppeteer": "24.39.1",
-    "rollup": "4.59.0",
+    "puppeteer": "24.40.0",
+    "rollup": "4.59.1",
     "rollup-plugin-cleanup": "^3.2.1",
     "rollup-plugin-license": "^3.6.0",
     "sinon": "^21.0.0",