chrome-devtools-mcp 1.2.0 → 1.4.0

package/README.md

@@ -514,12 +514,15 @@ If you run into any issues, checkout our [troubleshooting guide](./docs/troubles
   - [`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** (6 tools)
+- **Memory** (9 tools)
   - [`take_heapsnapshot`](docs/tool-reference.md#take_heapsnapshot)
   - [`close_heapsnapshot`](docs/tool-reference.md#close_heapsnapshot)
   - [`get_heapsnapshot_class_nodes`](docs/tool-reference.md#get_heapsnapshot_class_nodes)
   - [`get_heapsnapshot_details`](docs/tool-reference.md#get_heapsnapshot_details)
+  - [`get_heapsnapshot_dominators`](docs/tool-reference.md#get_heapsnapshot_dominators)
+  - [`get_heapsnapshot_edges`](docs/tool-reference.md#get_heapsnapshot_edges)
   - [`get_heapsnapshot_retainers`](docs/tool-reference.md#get_heapsnapshot_retainers)
+  - [`get_heapsnapshot_retaining_paths`](docs/tool-reference.md#get_heapsnapshot_retaining_paths)
   - [`get_heapsnapshot_summary`](docs/tool-reference.md#get_heapsnapshot_summary)
 - **Extensions** (5 tools)
   - [`install_extension`](docs/tool-reference.md#install_extension)
@@ -550,14 +553,17 @@ The Chrome DevTools MCP server supports the following configuration option:
 - **`--browserUrl`/ `--browser-url`, `-u`**
   Connect to a running, debuggable Chrome instance (e.g. `http://127.0.0.1:9222`). For more details see: https://github.com/ChromeDevTools/chrome-devtools-mcp#connecting-to-a-running-chrome-instance.
   - **Type:** string
+  - **Default:** `false`
 
 - **`--wsEndpoint`/ `--ws-endpoint`, `-w`**
   WebSocket endpoint to connect to a running Chrome instance (e.g., ws://127.0.0.1:9222/devtools/browser/<id>). Alternative to --browserUrl.
   - **Type:** string
+  - **Default:** `false`
 
 - **`--wsHeaders`/ `--ws-headers`**
   Custom headers for WebSocket connection in JSON format (e.g., '{"Authorization":"Bearer token"}'). Only works with --wsEndpoint.
   - **Type:** string
+  - **Default:** `false`
 
 - **`--headless`**
   Whether to run in headless (no UI) mode.
@@ -567,87 +573,108 @@ The Chrome DevTools MCP server supports the following configuration option:
 - **`--executablePath`/ `--executable-path`, `-e`**
   Path to custom Chrome executable.
   - **Type:** string
+  - **Default:** `false`
 
 - **`--isolated`**
   If specified, creates a temporary user-data-dir that is automatically cleaned up after the browser is closed. Defaults to false.
   - **Type:** boolean
+  - **Default:** `false`
 
 - **`--userDataDir`/ `--user-data-dir`**
   Path to the user data directory for Chrome. Default is $HOME/.cache/chrome-devtools-mcp/chrome-profile$CHANNEL_SUFFIX_IF_NON_STABLE
   - **Type:** string
+  - **Default:** `false`
 
 - **`--channel`**
   Specify a different Chrome channel that should be used. The default is the stable channel version.
   - **Type:** string
   - **Choices:** `canary`, `dev`, `beta`, `stable`
+  - **Default:** `false`
 
 - **`--logFile`/ `--log-file`**
   Path to a file to write debug logs to. Set the env variable `DEBUG` to `*` to enable verbose logs. Useful for submitting bug reports.
   - **Type:** string
+  - **Default:** `false`
 
 - **`--viewport`**
   Initial viewport size for the Chrome instances started by the server. For example, `1280x720`. In headless mode, max size is 3840x2160px.
   - **Type:** string
+  - **Default:** `false`
 
 - **`--proxyServer`/ `--proxy-server`**
   Proxy server configuration for Chrome passed as --proxy-server when launching the browser. See https://www.chromium.org/developers/design-documents/network-settings/ for details.
   - **Type:** string
+  - **Default:** `false`
 
 - **`--acceptInsecureCerts`/ `--accept-insecure-certs`**
   If enabled, ignores errors relative to self-signed and expired certificates. Use with caution.
   - **Type:** boolean
+  - **Default:** `false`
 
 - **`--experimentalPageIdRouting`/ `--experimental-page-id-routing`**
   Whether to expose pageId on page-scoped tools and route requests by page ID (useful for concurrent agent sessions).
   - **Type:** boolean
+  - **Default:** `false`
 
 - **`--experimentalDevtools`/ `--experimental-devtools`**
   Whether to enable automation over DevTools targets
   - **Type:** boolean
+  - **Default:** `false`
 
 - **`--experimentalVision`/ `--experimental-vision`**
   Whether to enable coordinate-based tools such as click_at(x,y). Usually requires a computer-use model able to produce accurate coordinates by looking at screenshots.
   - **Type:** boolean
+  - **Default:** `false`
 
 - **`--memoryDebugging`/ `--memory-debugging`, `-experimentalMemory`**
   Whether to enable memory debugging tools.
   - **Type:** boolean
+  - **Default:** `false`
 
 - **`--experimentalStructuredContent`/ `--experimental-structured-content`**
   Whether to output structured formatted content.
   - **Type:** boolean
+  - **Default:** `false`
 
 - **`--experimentalIncludeAllPages`/ `--experimental-include-all-pages`**
   Whether to include all kinds of pages such as webviews or background pages as pages.
   - **Type:** boolean
+  - **Default:** `false`
 
 - **`--experimentalScreencast`/ `--experimental-screencast`**
   Exposes experimental screencast tools (requires ffmpeg). Install ffmpeg https://www.ffmpeg.org/download.html and ensure it is available in the MCP server PATH.
   - **Type:** boolean
+  - **Default:** `false`
 
 - **`--experimentalFfmpegPath`/ `--experimental-ffmpeg-path`**
   Path to ffmpeg executable for screencast recording.
   - **Type:** string
+  - **Default:** `false`
 
 - **`--categoryExperimentalWebmcp`/ `--category-experimental-webmcp`**
-  Set to true to enable debugging WebMCP tools. Requires Chrome 149+ with the following flags: `--enable-features=WebMCPTesting,DevToolsWebMCPSupport`
+  Set to true to enable debugging WebMCP tools. Requires Chrome 149+ with the following flags: `--enable-features=WebMCP,DevToolsWebMCPSupport`
   - **Type:** boolean
+  - **Default:** `false`
 
 - **`--chromeArg`/ `--chrome-arg`**
   Additional arguments for Chrome. Only applies when Chrome is launched by chrome-devtools-mcp.
   - **Type:** array
+  - **Default:** `false`
 
 - **`--blockedUrlPattern`/ `--blocked-url-pattern`**
-  Restricts network access by blocking specified URL patterns (uses https://urlpattern.spec.whatwg.org/). Silently detaches from targets with blocked URLs upon connection, and blocks runtime requests (including navigations and subresources). Accepts an array of patterns.
+  Restricts browser's network access by blocking specified URL patterns (uses https://urlpattern.spec.whatwg.org/). Silently detaches from targets with blocked URLs upon connection, and blocks runtime requests (including navigations and subresources). Accepts an array of patterns.
   - **Type:** array
+  - **Default:** `false`
 
 - **`--allowedUrlPattern`/ `--allowed-url-pattern`**
-  Restricts network access by allowing only specified URL patterns (uses https://urlpattern.spec.whatwg.org/). Requires Chrome 149+. Silently detaches from targets with unallowed URLs upon connection, and blocks runtime requests (including navigations and subresources). Accepts an array of patterns.
+  Restricts browser's network access by allowing only specified URL patterns (uses https://urlpattern.spec.whatwg.org/). Requires Chrome 149+. Silently detaches from targets with unallowed URLs upon connection, and blocks runtime requests (including navigations and subresources). Accepts an array of patterns.
   - **Type:** array
+  - **Default:** `false`
 
 - **`--ignoreDefaultChromeArg`/ `--ignore-default-chrome-arg`**
   Explicitly disable default arguments for Chrome. Only applies when Chrome is launched by chrome-devtools-mcp.
   - **Type:** array
+  - **Default:** `false`
 
 - **`--categoryEmulation`/ `--category-emulation`**
   Set to false to exclude tools related to emulation.
@@ -684,9 +711,31 @@ The Chrome DevTools MCP server supports the following configuration option:
   - **Type:** boolean
   - **Default:** `true`
 
+- **`--screenshotFormat`/ `--screenshot-format`**
+  Override the default output format used by take_screenshot when the caller does not specify one. JPEG and WebP are ~3-5x smaller than PNG, which helps reduce context size in AI conversations. Unset preserves the existing default ("png").
+  - **Type:** string
+  - **Choices:** `jpeg`, `png`, `webp`
+  - **Default:** `false`
+
+- **`--screenshotQuality`/ `--screenshot-quality`**
+  Override the default compression quality (0-100) used by take_screenshot for JPEG and WebP when the caller does not specify one. Lower values mean smaller files. Ignored for PNG. Unset preserves the Puppeteer default.
+  - **Type:** number
+  - **Default:** `false`
+
+- **`--screenshotMaxWidth`/ `--screenshot-max-width`**
+  Maximum width in pixels for screenshots. If the captured image is wider, it is downscaled (preserving aspect ratio) before being returned. Reduces context size in AI conversations. Unset means no resize.
+  - **Type:** number
+  - **Default:** `false`
+
+- **`--screenshotMaxHeight`/ `--screenshot-max-height`**
+  Maximum height in pixels for screenshots. If the captured image is taller, it is downscaled (preserving aspect ratio) before being returned. Can be combined with --screenshot-max-width; the smaller scale factor wins. Unset means no resize.
+  - **Type:** number
+  - **Default:** `false`
+
 - **`--slim`**
   Exposes a "slim" set of 3 tools covering navigation, script execution and screenshots only. Useful for basic browser tasks.
   - **Type:** boolean
+  - **Default:** `false`
 
 - **`--redactNetworkHeaders`/ `--redact-network-headers`**
   If true, redacts some of the network headers considered sensitive before returning to the client.
@@ -909,3 +958,9 @@ Please consult [these instructions](./docs/debugging-android.md).
 ## Known limitations
 
 See [Troubleshooting](./docs/troubleshooting.md).
+
+## Integrating as a browser subagent
+
+If you are developing agentic tooling and want to provide an integrated browser subagent as part of your product, we recommend building on top of Chrome DevTools for agents.
+
+For a reference implementation, see the [Gemini CLI browser agent documentation](https://geminicli.com/docs/core/subagents/#browser-agent).

package/build/src/HeapSnapshotManager.js

@@ -5,7 +5,6 @@
  */
 import fsSync from 'node:fs';
 import path from 'node:path';
-import { isNodeLike } from './formatters/HeapSnapshotFormatter.js';
 import { DevTools } from './third_party/index.js';
 import { createIdGenerator, stableIdSymbol, } from './utils/id.js';
 export class HeapSnapshotManager {
@@ -67,28 +66,38 @@ export class HeapSnapshotManager {
         const provider = snapshot.createNodesProviderForClass(className, filter);
         return await provider.serializeItemsRange(0, Infinity);
     }
-    async findNodeIndexById(filePath, nodeId) {
+    async getRetainers(filePath, nodeId) {
         const snapshot = await this.getSnapshot(filePath);
-        const aggregates = await this.getAggregates(filePath);
-        const filter = new DevTools.HeapSnapshotModel.HeapSnapshotModel.NodeFilter();
-        for (const classKey of Object.keys(aggregates)) {
-            const provider = snapshot.createNodesProviderForClass(classKey, filter);
-            const range = await provider.serializeItemsRange(0, Infinity);
-            for (const item of range.items) {
-                if (isNodeLike(item) && item.id === nodeId) {
-                    return item.nodeIndex;
-                }
-            }
+        const nodeIndex = await snapshot.nodeIndexForId(nodeId);
+        if (nodeIndex === undefined) {
+            throw new Error(`Node with ID ${nodeId} not found`);
         }
-        return undefined;
+        const provider = snapshot.createRetainingEdgesProvider(nodeIndex);
+        return await provider.serializeItemsRange(0, Infinity);
     }
-    async getRetainers(filePath, nodeId) {
-        const nodeIndex = await this.findNodeIndexById(filePath, nodeId);
+    async getRetainingPaths(filePath, nodeId, maxDepth, maxNodes, maxSiblings) {
+        const snapshot = await this.getSnapshot(filePath);
+        const nodeIndex = await snapshot.nodeIndexForId(nodeId);
         if (nodeIndex === undefined) {
             throw new Error(`Node with ID ${nodeId} not found`);
         }
+        return await snapshot.getRetainingPaths(nodeIndex, maxDepth, maxNodes, maxSiblings);
+    }
+    async getDominatorsOf(filePath, nodeId) {
         const snapshot = await this.getSnapshot(filePath);
-        const provider = snapshot.createRetainingEdgesProvider(nodeIndex);
+        const nodeIndex = await snapshot.nodeIndexForId(nodeId);
+        if (nodeIndex === undefined) {
+            throw new Error(`Node with ID ${nodeId} not found`);
+        }
+        return await snapshot.getDominatorsOf(nodeIndex);
+    }
+    async getEdges(filePath, nodeId) {
+        const snapshot = await this.getSnapshot(filePath);
+        const nodeIndex = await snapshot.nodeIndexForId(nodeId);
+        if (nodeIndex === undefined) {
+            throw new Error(`Node with ID ${nodeId} not found`);
+        }
+        const provider = snapshot.createEdgesProvider(nodeIndex);
         return await provider.serializeItemsRange(0, Infinity);
     }
     #getCachedSnapshot(filePath) {

package/build/src/McpContext.js

@@ -8,7 +8,7 @@ import fsPromises from 'node:fs/promises';
 import os from 'node:os';
 import path from 'node:path';
 import { fileURLToPath, pathToFileURL } from 'node:url';
-import { UniverseManager } from './DevtoolsUtils.js';
+import { overrideDevToolsGlobals, UniverseManager, } from './devtools/DevtoolsUtils.js';
 import { HeapSnapshotManager } from './HeapSnapshotManager.js';
 import { McpPage } from './McpPage.js';
 import { NetworkCollector, ConsoleCollector, } from './PageCollector.js';
@@ -47,6 +47,11 @@ export class McpContext {
     #heapSnapshotManager = new HeapSnapshotManager();
     #roots = undefined;
     constructor(browser, logger, options, locatorClass) {
+        overrideDevToolsGlobals({
+            loadResource: (url) => {
+                return this.loadResource(url);
+            },
+        });
         this.browser = browser;
         this.logger = logger;
         this.#locatorClass = locatorClass;
@@ -659,5 +664,34 @@ export class McpContext {
     hasHeapSnapshots() {
         return this.#heapSnapshotManager.hasSnapshots();
     }
+    async getHeapSnapshotRetainingPaths(filePath, nodeId, maxDepth, maxNodes, maxSiblings) {
+        return await this.#heapSnapshotManager.getRetainingPaths(filePath, nodeId, maxDepth, maxNodes, maxSiblings);
+    }
+    async getHeapSnapshotDominators(filePath, nodeId) {
+        return await this.#heapSnapshotManager.getDominatorsOf(filePath, nodeId);
+    }
+    async loadResource(path) {
+        const url = new URL(path);
+        switch (url.protocol) {
+            case 'https:':
+            case 'http:': {
+                // TODO: Verify allow/block list
+                const response = await fetch(url);
+                if (!response.ok) {
+                    throw new Error(`Failed to load resource: ${url}`);
+                }
+                return response.text();
+            }
+            case 'file:': {
+                await this.validatePath(fileURLToPath(url));
+                return await fsPromises.readFile(url, 'utf-8');
+            }
+            default:
+                throw new Error(`Unsupported protocol for: ${url}`);
+        }
+    }
+    async getHeapSnapshotEdges(filePath, nodeId) {
+        return await this.#heapSnapshotManager.getEdges(filePath, nodeId);
+    }
 }
 //# sourceMappingURL=McpContext.js.map

package/build/src/McpResponse.js

@@ -73,6 +73,9 @@ async function getToolGroups(page) {
         return [];
     }
     const toolGroups = await page.pptrPage.evaluate(() => {
+        if (window.__dtmcp) {
+            window.__dtmcp.toolGroups = [];
+        }
         return new Promise(resolve => {
             const event = new CustomEvent('devtoolstooldiscovery');
             const groups = [];
@@ -85,7 +88,8 @@ async function getToolGroups(page) {
                     window.__dtmcp.toolGroups = [];
                 }
                 if (typeof toolGroup.name !== 'string' ||
-                    typeof toolGroup.description !== 'string' ||
+                    (toolGroup.description &&
+                        typeof toolGroup.description !== 'string') ||
                     !Array.isArray(toolGroup.tools)) {
                     console.error('Invalid toolGroup:', toolGroup);
                     return;
@@ -330,6 +334,20 @@ export class McpResponse {
             pagination: options,
         };
     }
+    setHeapSnapshotRetainingPaths(retainingPaths) {
+        this.#heapSnapshotOptions = {
+            ...this.#heapSnapshotOptions,
+            include: true,
+            retainingPaths,
+        };
+    }
+    setHeapSnapshotDominators(dominators) {
+        this.#heapSnapshotOptions = {
+            ...this.#heapSnapshotOptions,
+            include: true,
+            dominators,
+        };
+    }
     attachImage(value) {
         this.#images.push(value);
     }
@@ -528,7 +546,7 @@ export class McpResponse {
             errorMessage: this.#error?.message,
         }, useToon);
     }
-    format(toolName, context, data, useToon) {
+    async format(toolName, context, data, useToon) {
         const structuredContent = {};
         const response = [];
         if (this.#textResponseLines.length) {
@@ -608,8 +626,12 @@ Call ${handleDialog.name} to handle it before continuing.`);
                     const contextLabel = isolatedContextName
                         ? ` isolatedContext=${isolatedContextName}`
                         : '';
-                    parts.push(`${context.getPageId(page)}: ${page.url()}${context.isPageSelected(page) ? ' [selected]' : ''}${contextLabel}`);
-                    structuredPages.push(createStructuredPage(page, context));
+                    const title = await fetchPageTitle(page);
+                    const pageLabel = title
+                        ? `${truncateTitle(title)} (${page.url()})`
+                        : page.url();
+                    parts.push(`${context.getPageId(page)}: ${pageLabel}${context.isPageSelected(page) ? ' [selected]' : ''}${contextLabel}`);
+                    structuredPages.push(createStructuredPage(page, context, title));
                 }
                 response.push(...parts);
                 structuredContent.pages = structuredPages;
@@ -623,8 +645,12 @@ Call ${handleDialog.name} to handle it before continuing.`);
                         const contextLabel = isolatedContextName
                             ? ` isolatedContext=${isolatedContextName}`
                             : '';
-                        response.push(`${context.getPageId(page)}: ${page.url()}${context.isPageSelected(page) ? ' [selected]' : ''}${contextLabel}`);
-                        structuredExtensionPages.push(createStructuredPage(page, context));
+                        const title = await fetchPageTitle(page);
+                        const pageLabel = title
+                            ? `${truncateTitle(title)} (${page.url()})`
+                            : page.url();
+                        response.push(`${context.getPageId(page)}: ${pageLabel}${context.isPageSelected(page) ? ' [selected]' : ''}${contextLabel}`);
+                        structuredExtensionPages.push(createStructuredPage(page, context, title));
                     }
                     structuredContent.extensionPages = structuredExtensionPages;
                 }
@@ -752,6 +778,36 @@ Call ${handleDialog.name} to handle it before continuing.`);
                 response.push(...paginationData.info);
                 structuredContent.heapSnapshotNodes = paginationData.items;
             }
+            const retainingPaths = this.#heapSnapshotOptions.retainingPaths;
+            if (retainingPaths) {
+                response.push('### Retaining Paths');
+                const { paths, limitsReached } = retainingPaths;
+                if (paths.length === 0) {
+                    response.push('No retaining paths found.');
+                }
+                else {
+                    response.push(HeapSnapshotFormatter.formatRetainingPaths(paths));
+                }
+                const reached = Object.entries(limitsReached)
+                    .filter(([, hit]) => hit)
+                    .map(([limit]) => limit);
+                if (reached.length > 0) {
+                    response.push(`Note: results are truncated, the following limits were reached: ${reached.join(', ')}.`);
+                }
+                structuredContent.heapSnapshotRetainingPaths =
+                    retainingPaths;
+            }
+            const dominators = this.#heapSnapshotOptions.dominators;
+            if (dominators) {
+                response.push('### Dominator Chain');
+                if (dominators.length === 0) {
+                    response.push('No dominators found.');
+                }
+                else {
+                    response.push(HeapSnapshotFormatter.formatDominators(dominators));
+                }
+                structuredContent.heapSnapshotDominators = dominators;
+            }
         }
         if (data.detailedNetworkRequest) {
             response.push(data.detailedNetworkRequest.toStringDetailed());
@@ -905,11 +961,25 @@ Call ${handleDialog.name} to handle it before continuing.`);
         this.#textResponseLines = [];
     }
 }
-function createStructuredPage(page, context) {
+function truncateTitle(title, maxLength = 50) {
+    if (title.length <= maxLength) {
+        return title;
+    }
+    return title.slice(0, maxLength - 3) + '...';
+}
+async function fetchPageTitle(page) {
+    return Promise.race([
+        page.title().catch(() => ''),
+        new Promise(resolve => setTimeout(() => resolve(''), 1000)),
+    ]);
+}
+function createStructuredPage(page, context, rawTitle) {
     const isolatedContextName = context.getIsolatedContextName(page);
+    const title = truncateTitle(rawTitle);
     const entry = {
         id: context.getPageId(page),
         url: page.url(),
+        title,
         selected: context.isPageSelected(page),
     };
     if (isolatedContextName) {

package/build/src/PageCollector.js

@@ -3,7 +3,7 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { FakeIssuesManager } from './DevtoolsUtils.js';
+import { FakeIssuesManager } from './devtools/DevtoolsUtils.js';
 import { logger } from './logger.js';
 import { DevTools } from './third_party/index.js';
 import { createIdGenerator, stableIdSymbol, } from './utils/id.js';

package/build/src/bin/check-latest-version.js

@@ -18,6 +18,7 @@ function getRegistry() {
             encoding: 'utf8',
             stdio: ['ignore', 'pipe', 'ignore'],
             timeout: 5000,
+            windowsHide: true,
         })
             .trim()
             .replace(/\/$/, '');

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

@@ -312,6 +312,54 @@ export const commands = {
             },
         },
     },
+    get_heapsnapshot_dominators: {
+        description: 'Loads a memory heapsnapshot and returns the dominator chain for a specific node ID. This helps to identify which objects are keeping the target node alive. (requires flag: --memoryDebugging=true)',
+        category: 'Memory',
+        args: {
+            filePath: {
+                name: 'filePath',
+                type: 'string',
+                description: 'A path to a .heapsnapshot file to read.',
+                required: true,
+            },
+            nodeId: {
+                name: 'nodeId',
+                type: 'number',
+                description: 'The node ID to get the dominator chain for.',
+                required: true,
+            },
+        },
+    },
+    get_heapsnapshot_edges: {
+        description: 'Loads a memory heapsnapshot and returns outgoing edges (references) for a specific node ID. (requires flag: --memoryDebugging=true)',
+        category: 'Memory',
+        args: {
+            filePath: {
+                name: 'filePath',
+                type: 'string',
+                description: 'A path to a .heapsnapshot file to read.',
+                required: true,
+            },
+            nodeId: {
+                name: 'nodeId',
+                type: 'number',
+                description: 'The node ID to get outgoing edges for.',
+                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,
+            },
+        },
+    },
     get_heapsnapshot_retainers: {
         description: 'Loads a memory heapsnapshot and returns retainers for a specific node ID. (requires flag: --memoryDebugging=true)',
         category: 'Memory',
@@ -342,6 +390,42 @@ export const commands = {
             },
         },
     },
+    get_heapsnapshot_retaining_paths: {
+        description: 'Loads a memory heapsnapshot and returns retaining paths for a specific node ID. This helps to understand why a node is not being garbage collected. (requires flag: --memoryDebugging=true)',
+        category: 'Memory',
+        args: {
+            filePath: {
+                name: 'filePath',
+                type: 'string',
+                description: 'A path to a .heapsnapshot file to read.',
+                required: true,
+            },
+            nodeId: {
+                name: 'nodeId',
+                type: 'number',
+                description: 'The node ID to get retaining paths for.',
+                required: true,
+            },
+            maxDepth: {
+                name: 'maxDepth',
+                type: 'number',
+                description: 'The maximum depth to search for retaining paths.',
+                required: false,
+            },
+            maxNodes: {
+                name: 'maxNodes',
+                type: 'number',
+                description: 'The maximum number of nodes to return.',
+                required: false,
+            },
+            maxSiblings: {
+                name: 'maxSiblings',
+                type: 'number',
+                description: 'The maximum number of siblings to return.',
+                required: false,
+            },
+        },
+    },
     get_heapsnapshot_summary: {
         description: 'Loads a memory heapsnapshot and returns snapshot summary stats. (requires flag: --memoryDebugging=true)',
         category: 'Memory',

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

@@ -185,7 +185,7 @@ export const cliOptions = {
     },
     categoryExperimentalWebmcp: {
         type: 'boolean',
-        describe: 'Set to true to enable debugging WebMCP tools. Requires Chrome 149+ with the following flags: `--enable-features=WebMCPTesting,DevToolsWebMCPSupport`',
+        describe: 'Set to true to enable debugging WebMCP tools. Requires Chrome 149+ with the following flags: `--enable-features=WebMCP,DevToolsWebMCPSupport`',
     },
     chromeArg: {
         type: 'array',
@@ -193,12 +193,12 @@ export const cliOptions = {
     },
     blockedUrlPattern: {
         type: 'array',
-        describe: 'Restricts network access by blocking specified URL patterns (uses https://urlpattern.spec.whatwg.org/). Silently detaches from targets with blocked URLs upon connection, and blocks runtime requests (including navigations and subresources). Accepts an array of patterns.',
+        describe: "Restricts browser's network access by blocking specified URL patterns (uses https://urlpattern.spec.whatwg.org/). Silently detaches from targets with blocked URLs upon connection, and blocks runtime requests (including navigations and subresources). Accepts an array of patterns.",
         conflicts: ['allowedUrlPattern'],
     },
     allowedUrlPattern: {
         type: 'array',
-        describe: 'Restricts network access by allowing only specified URL patterns (uses https://urlpattern.spec.whatwg.org/). Requires Chrome 149+. Silently detaches from targets with unallowed URLs upon connection, and blocks runtime requests (including navigations and subresources). Accepts an array of patterns.',
+        describe: "Restricts browser's network access by allowing only specified URL patterns (uses https://urlpattern.spec.whatwg.org/). Requires Chrome 149+. Silently detaches from targets with unallowed URLs upon connection, and blocks runtime requests (including navigations and subresources). Accepts an array of patterns.",
         conflicts: ['blockedUrlPattern'],
     },
     ignoreDefaultChromeArg: {
@@ -256,6 +256,50 @@ export const cliOptions = {
         hidden: true,
         describe: 'Include watchdog PID in Clearcut request headers (for testing).',
     },
+    screenshotFormat: {
+        type: 'string',
+        description: 'Override the default output format used by take_screenshot when the caller does not specify one. JPEG and WebP are ~3-5x smaller than PNG, which helps reduce context size in AI conversations. Unset preserves the existing default ("png").',
+        choices: ['jpeg', 'png', 'webp'],
+    },
+    screenshotQuality: {
+        type: 'number',
+        description: 'Override the default compression quality (0-100) used by take_screenshot for JPEG and WebP when the caller does not specify one. Lower values mean smaller files. Ignored for PNG. Unset preserves the Puppeteer default.',
+        coerce: (value) => {
+            if (value === undefined) {
+                return;
+            }
+            if (!Number.isInteger(value) || value < 0 || value > 100) {
+                throw new Error(`Invalid screenshotQuality ${value}. Expected an integer between 0 and 100.`);
+            }
+            return value;
+        },
+    },
+    screenshotMaxWidth: {
+        type: 'number',
+        description: 'Maximum width in pixels for screenshots. If the captured image is wider, it is downscaled (preserving aspect ratio) before being returned. Reduces context size in AI conversations. Unset means no resize.',
+        coerce: (value) => {
+            if (value === undefined) {
+                return;
+            }
+            if (!Number.isInteger(value) || value <= 0) {
+                throw new Error(`Invalid screenshotMaxWidth ${value}. Expected a positive integer.`);
+            }
+            return value;
+        },
+    },
+    screenshotMaxHeight: {
+        type: 'number',
+        description: 'Maximum height in pixels for screenshots. If the captured image is taller, it is downscaled (preserving aspect ratio) before being returned. Can be combined with --screenshot-max-width; the smaller scale factor wins. Unset means no resize.',
+        coerce: (value) => {
+            if (value === undefined) {
+                return;
+            }
+            if (!Number.isInteger(value) || value <= 0) {
+                throw new Error(`Invalid screenshotMaxHeight ${value}. Expected a positive integer.`);
+            }
+            return value;
+        },
+    },
     slim: {
         type: 'boolean',
         describe: 'Exposes a "slim" set of 3 tools covering navigation, script execution and screenshots only. Useful for basic browser tasks.',

package/build/src/{DevToolsConnectionAdapter.js → devtools/DevToolsConnectionAdapter.js}

@@ -3,7 +3,7 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { CDPSessionEvent } from './third_party/index.js';
+import { CDPSessionEvent } from '../third_party/index.js';
 /**
  * This class makes a puppeteer connection look like DevTools CDPConnection.
  *