brave-mcp 1.3.0 → 1.5.0

package/README.md

@@ -239,9 +239,9 @@ To use the Chrome DevTools MCP server follow the instructions from <a href="http
     "chrome-devtools": {
       "command": "npx",
       "args": [
+        "-y",
         "chrome-devtools-mcp@latest",
-        "--browser-url=http://127.0.0.1:9222",
-        "-y"
+        "--browser-url=http://127.0.0.1:9222"
       ]
     }
   }
@@ -632,12 +632,14 @@ 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** (9 tools)
+- **Memory** (11 tools)
   - [`take_heapsnapshot`](docs/tool-reference.md#take_heapsnapshot)
   - [`close_heapsnapshot`](docs/tool-reference.md#close_heapsnapshot)
+  - [`compare_heapsnapshots`](docs/tool-reference.md#compare_heapsnapshots)
   - [`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_duplicate_strings`](docs/tool-reference.md#get_heapsnapshot_duplicate_strings)
   - [`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)
@@ -671,14 +673,17 @@ The Brave DevTools MCP server supports the following configuration options:
 - **`--browserUrl`/ `--browser-url`, `-u`**
   Connect to a running, debuggable Brave instance (e.g. `http://127.0.0.1:9222`).
   - **Type:** string
+  - **Default:** `false`
 
 - **`--wsEndpoint`/ `--ws-endpoint`, `-w`**
   WebSocket endpoint to connect to a running Brave 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.
@@ -688,87 +693,108 @@ The Brave DevTools MCP server supports the following configuration options:
 - **`--executablePath`/ `--executable-path`, `-e`**
   Path to custom Brave executable. Can also be set via BRAVE_PATH environment variable.
   - **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 Brave. Default is $HOME/.cache/brave-devtools-mcp/brave-profile$CHANNEL_SUFFIX_IF_NON_RELEASE
   - **Type:** string
+  - **Default:** `false`
 
 - **`--channel`**
   Specify a different Brave channel that should be used. The default is the release channel.
   - **Type:** string
   - **Choices:** `release`, `beta`, `nightly`, `dev`
+  - **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 Brave 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 Brave 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 Brave with the following flags: `--enable-features=WebMCP,DevToolsWebMCPSupport`
   - **Type:** boolean
+  - **Default:** `false`
 
 - **`--braveArg`/ `--brave-arg`**
   Additional arguments for Brave. Only applies when Brave is launched by brave-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`
 
 - **`--ignoreDefaultBraveArg`/ `--ignore-default-brave-arg`**
   Explicitly disable default arguments for Brave. Only applies when Brave is launched by brave-devtools-mcp.
   - **Type:** array
+  - **Default:** `false`
 
 - **`--categoryEmulation`/ `--category-emulation`**
   Set to false to exclude tools related to emulation.
@@ -809,22 +835,27 @@ The Brave DevTools MCP server supports the following configuration options:
   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.
@@ -930,3 +961,9 @@ Please consult [these instructions](./docs/debugging-android.md) (originally wri
 ## 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

@@ -8,6 +8,7 @@ import path from 'node:path';
 import { DevTools } from './third_party/index.js';
 import { createIdGenerator, stableIdSymbol, } from './utils/id.js';
 export class HeapSnapshotManager {
+    #snapshotIdGenerator = createIdGenerator();
     #snapshots = new Map();
     async getSnapshot(filePath) {
         const absolutePath = path.resolve(filePath);
@@ -15,7 +16,8 @@ export class HeapSnapshotManager {
         if (cached) {
             return cached.snapshot;
         }
-        const { snapshot, worker } = await this.#loadSnapshot(absolutePath);
+        const uid = this.#snapshotIdGenerator();
+        const { snapshot, worker } = await this.#loadSnapshot(absolutePath, uid);
         this.#snapshots.set(absolutePath, {
             snapshot,
             worker,
@@ -100,6 +102,38 @@ export class HeapSnapshotManager {
         const provider = snapshot.createEdgesProvider(nodeIndex);
         return await provider.serializeItemsRange(0, Infinity);
     }
+    async getClassDiffs(baseFilePath, currentFilePath) {
+        const rawDiffs = await this.#getSortedRawClassDiffs(baseFilePath, currentFilePath);
+        return rawDiffs.map(rawDiff => ({
+            className: rawDiff.name,
+            addedCount: rawDiff.addedCount,
+            removedCount: rawDiff.removedCount,
+            countDelta: rawDiff.countDelta,
+            addedSize: rawDiff.addedSize,
+            removedSize: rawDiff.removedSize,
+            sizeDelta: rawDiff.sizeDelta,
+        }));
+    }
+    async getDetailedClassDiff(baseFilePath, currentFilePath, classIndex) {
+        const classDiffs = await this.#getSortedRawClassDiffs(baseFilePath, currentFilePath);
+        const rawDiff = classDiffs[classIndex];
+        if (!rawDiff) {
+            throw new Error(`Invalid classIndex: ${classIndex}. Total classes with changes: ${classDiffs.length}`);
+        }
+        return {
+            className: rawDiff.name,
+            addedCount: rawDiff.addedCount,
+            removedCount: rawDiff.removedCount,
+            countDelta: rawDiff.countDelta,
+            addedSize: rawDiff.addedSize,
+            removedSize: rawDiff.removedSize,
+            sizeDelta: rawDiff.sizeDelta,
+            addedIds: rawDiff.addedIds ?? [],
+            addedSelfSizes: rawDiff.addedSelfSizes ?? [],
+            deletedIds: rawDiff.deletedIds ?? [],
+            deletedSelfSizes: rawDiff.deletedSelfSizes ?? [],
+        };
+    }
     #getCachedSnapshot(filePath) {
         const absolutePath = path.resolve(filePath);
         const cached = this.#snapshots.get(absolutePath);
@@ -108,16 +142,35 @@ export class HeapSnapshotManager {
         }
         return cached;
     }
+    async #getSortedRawClassDiffs(baseFilePath, currentFilePath) {
+        const baseSnapshot = await this.getSnapshot(baseFilePath);
+        const currentSnapshot = await this.getSnapshot(currentFilePath);
+        const interfaceDefinitions = await currentSnapshot.interfaceDefinitions();
+        const aggregatesForDiff = await baseSnapshot.aggregatesForDiff(interfaceDefinitions);
+        const baseSnapshotId = baseSnapshot.uid;
+        if (baseSnapshotId === undefined) {
+            throw new Error('Base snapshot UID is undefined');
+        }
+        // DevTools calculateSnapshotDiff uses the first parameter (baseSnapshotId)
+        // as a cache key. We pass the unique UID of the base snapshot.
+        const rawDiffs = await currentSnapshot.calculateSnapshotDiff(baseSnapshotId, aggregatesForDiff);
+        // Return a filtered and sorted array here to ensure that
+        // compare_heapsnapshot_summary and compare_heapsnapshot_details agree
+        // on indices.
+        return Object.values(rawDiffs)
+            .filter(diff => diff.addedCount > 0 || diff.removedCount > 0)
+            .sort((a, b) => b.sizeDelta - a.sizeDelta);
+    }
     async resolveClassKeyFromId(filePath, id) {
         const cached = this.#getCachedSnapshot(filePath);
         return cached.idToClassKey.get(id);
     }
-    async #loadSnapshot(absolutePath) {
+    async #loadSnapshot(absolutePath, uid) {
         const workerProxy = new DevTools.HeapSnapshotModel.HeapSnapshotProxy.HeapSnapshotWorkerProxy(() => {
             /* noop */
         }, import.meta.resolve('./third_party/devtools-heap-snapshot-worker.js'));
         const { promise: snapshotPromise, resolve: resolveSnapshot } = Promise.withResolvers();
-        const loaderProxy = workerProxy.createLoader(1, snapshotProxy => {
+        const loaderProxy = workerProxy.createLoader(uid, snapshotProxy => {
             resolveSnapshot(snapshotProxy);
         });
         const fileStream = fsSync.createReadStream(absolutePath, {
@@ -131,6 +184,10 @@ export class HeapSnapshotManager {
         const snapshot = await snapshotPromise;
         return { snapshot, worker: workerProxy };
     }
+    async getDuplicateStrings(filePath) {
+        const snapshot = await this.getSnapshot(filePath);
+        return await snapshot.getDuplicateStrings();
+    }
     hasSnapshots() {
         return this.#snapshots.size > 0;
     }

package/build/src/McpContext.js

@@ -16,7 +16,7 @@ import { ServiceWorkerConsoleCollector } from './ServiceWorkerCollector.js';
 import { Locator, PredefinedNetworkConditions, } from './third_party/index.js';
 import { listPages } from './tools/pages.js';
 import { CLOSE_PAGE_ERROR } from './tools/ToolDefinition.js';
-import { ensureExtension, getTempFilePath, resolveCanonicalPath, } from './utils/files.js';
+import { getTempFilePath, resolveCanonicalPath } from './utils/files.js';
 import { getNetworkMultiplierFromString } from './WaitForHelper.js';
 const DEFAULT_TIMEOUT = 5_000;
 const NAVIGATION_TIMEOUT = 10_000;
@@ -156,6 +156,13 @@ export class McpContext {
             throw new Error(`Access denied: path ${filePath} (canonical: ${canonicalPath}) is not within any of the configured workspace roots.`);
         }
     }
+    async ensureExtension(filePath, extension) {
+        const resolvedPath = path.resolve(filePath);
+        const currentExtension = path.extname(resolvedPath);
+        const outputPath = `${resolvedPath.slice(0, resolvedPath.length - currentExtension.length)}${extension}`;
+        await this.validatePath(outputPath);
+        return outputPath;
+    }
     resolveCdpRequestId(page, cdpRequestId) {
         if (!cdpRequestId) {
             this.logger?.('no network request');
@@ -223,12 +230,15 @@ export class McpContext {
         const currentSetting = page.emulationSettings;
         await this.emulate(currentSetting, page.pptrPage);
     }
+    get #hasNetworkBlockOrAllowlist() {
+        return !!(this.#options.allowList || this.#options.blocklist);
+    }
     async emulate(options, targetPage) {
         const page = targetPage ?? this.getSelectedPptrPage();
         const mcpPage = this.#getMcpPage(page);
         const newSettings = { ...mcpPage.emulationSettings };
         // Skip network emulation if blocklist/allowlist is configured, as it conflicts with blocking rules in Puppeteer.
-        if (this.#options.hasNetworkBlockOrAllowlist) {
+        if (this.#hasNetworkBlockOrAllowlist) {
             if (options.networkConditions !== undefined) {
                 throw new Error('Network throttling is not supported when network blocking (allowlist/blocklist) is configured.');
             }
@@ -568,9 +578,8 @@ export class McpContext {
         return { filepath };
     }
     async saveFile(data, clientProvidedFilePath, extension) {
-        await this.validatePath(clientProvidedFilePath);
+        const filePath = await this.ensureExtension(clientProvidedFilePath, extension);
         try {
-            const filePath = ensureExtension(path.resolve(clientProvidedFilePath), extension);
             await fs.mkdir(path.dirname(filePath), { recursive: true });
             await fs.writeFile(filePath, data);
             return { filename: filePath };
@@ -646,6 +655,9 @@ export class McpContext {
     async getHeapSnapshotAggregates(filePath) {
         return await this.#heapSnapshotManager.getAggregates(filePath);
     }
+    async getHeapSnapshotDuplicateStrings(filePath) {
+        return await this.#heapSnapshotManager.getDuplicateStrings(filePath);
+    }
     async getHeapSnapshotStats(filePath) {
         return await this.#heapSnapshotManager.getStats(filePath);
     }
@@ -670,12 +682,36 @@ export class McpContext {
     async getHeapSnapshotDominators(filePath, nodeId) {
         return await this.#heapSnapshotManager.getDominatorsOf(filePath, nodeId);
     }
+    #validateUrlNotBlocked(url) {
+        if (!this.#options.blocklist) {
+            return;
+        }
+        for (const block of this.#options.blocklist) {
+            const pattern = new URLPattern(block);
+            if (pattern.test(url)) {
+                throw new Error(`Blocked by blocklist: ${url}`);
+            }
+        }
+    }
+    #validateUrlAllowed(url) {
+        if (!this.#options.allowList) {
+            return;
+        }
+        for (const allow of this.#options.allowList) {
+            const pattern = new URLPattern(allow);
+            if (pattern.test(url)) {
+                return;
+            }
+        }
+        throw new Error(`Not allowed by allowlist: ${url}`);
+    }
     async loadResource(path) {
         const url = new URL(path);
+        this.#validateUrlNotBlocked(url);
         switch (url.protocol) {
             case 'https:':
             case 'http:': {
-                // TODO: Verify allow/block list
+                this.#validateUrlAllowed(url);
                 const response = await fetch(url);
                 if (!response.ok) {
                     throw new Error(`Failed to load resource: ${url}`);
@@ -693,5 +729,11 @@ export class McpContext {
     async getHeapSnapshotEdges(filePath, nodeId) {
         return await this.#heapSnapshotManager.getEdges(filePath, nodeId);
     }
+    async getHeapSnapshotClassDiffs(baseFilePath, currentFilePath) {
+        return await this.#heapSnapshotManager.getClassDiffs(baseFilePath, currentFilePath);
+    }
+    async getHeapSnapshotDetailedClassDiff(baseFilePath, currentFilePath, classIndex) {
+        return await this.#heapSnapshotManager.getDetailedClassDiff(baseFilePath, currentFilePath, classIndex);
+    }
 }
 //# sourceMappingURL=McpContext.js.map

package/build/src/McpResponse.js

@@ -4,14 +4,13 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { ConsoleFormatter } from './formatters/ConsoleFormatter.js';
-import { HeapSnapshotFormatter } from './formatters/HeapSnapshotFormatter.js';
-import { isEdgeLike, isNodeLike } from './formatters/HeapSnapshotFormatter.js';
+import { HeapSnapshotFormatter, isEdgeLike, isNodeLike, } from './formatters/HeapSnapshotFormatter.js';
 import { IssueFormatter } from './formatters/IssueFormatter.js';
 import { NetworkFormatter } from './formatters/NetworkFormatter.js';
 import { SnapshotFormatter } from './formatters/SnapshotFormatter.js';
 import { UncaughtError } from './PageCollector.js';
 import { TextSnapshot } from './TextSnapshot.js';
-import { DevTools, toonEncode } from './third_party/index.js';
+import { DevTools, getToonEncode } from './third_party/index.js';
 import { handleDialog } from './tools/pages.js';
 import { getInsightOutput, getTraceSummary } from './trace-processing/parse.js';
 import { paginate } from './utils/pagination.js';
@@ -334,6 +333,14 @@ export class McpResponse {
             pagination: options,
         };
     }
+    setHeapSnapshotDuplicateStrings(duplicateStrings, options) {
+        this.#heapSnapshotOptions = {
+            ...this.#heapSnapshotOptions,
+            include: true,
+            duplicateStrings,
+            pagination: options,
+        };
+    }
     setHeapSnapshotRetainingPaths(retainingPaths) {
         this.#heapSnapshotOptions = {
             ...this.#heapSnapshotOptions,
@@ -348,6 +355,20 @@ export class McpResponse {
             dominators,
         };
     }
+    setHeapSnapshotClassDiffs(classDiffs) {
+        this.#heapSnapshotOptions = {
+            ...this.#heapSnapshotOptions,
+            include: true,
+            classDiffs,
+        };
+    }
+    setHeapSnapshotDetailedClassDiff(detailedClassDiff) {
+        this.#heapSnapshotOptions = {
+            ...this.#heapSnapshotOptions,
+            include: true,
+            detailedClassDiff,
+        };
+    }
     attachImage(value) {
         this.#images.push(value);
     }
@@ -548,6 +569,18 @@ export class McpResponse {
     }
     async format(toolName, context, data, useToon) {
         const structuredContent = {};
+        let toonEncode;
+        if (useToon) {
+            try {
+                toonEncode = await getToonEncode();
+            }
+            catch {
+                throw new Error('The `@toon-format/toon` package is required to use the experimental TOON format. ' +
+                    'Make sure the peer dependency is installed:\n' +
+                    '- For npx: npx --package chrome-devtools-mcp@latest --package @toon-format/toon@latest chrome-devtools-mcp --experimentalToonFormat\n' +
+                    '- For npm: npm install @toon-format/toon (add -g if installed globally)');
+            }
+        }
         const response = [];
         if (this.#textResponseLines.length) {
             structuredContent.message = this.#textResponseLines.join('\n');
@@ -726,7 +759,7 @@ Call ${handleDialog.name} to handle it before continuing.`);
             else {
                 structuredContent.snapshot = data.snapshot.toJSON();
                 response.push('## Latest page snapshot');
-                response.push(useToon
+                response.push(useToon && toonEncode
                     ? toonEncode(structuredContent.snapshot)
                     : data.snapshot.toString());
             }
@@ -754,7 +787,7 @@ Call ${handleDialog.name} to handle it before continuing.`);
                 const paginatedRecord = Object.fromEntries(paginationData.items);
                 const formatter = new HeapSnapshotFormatter(paginatedRecord);
                 structuredContent.heapSnapshotData = formatter.toJSON();
-                response.push(useToon
+                response.push(useToon && toonEncode
                     ? toonEncode(structuredContent.heapSnapshotData)
                     : formatter.toString());
             }
@@ -808,6 +841,32 @@ Call ${handleDialog.name} to handle it before continuing.`);
                 }
                 structuredContent.heapSnapshotDominators = dominators;
             }
+            const classDiffs = this.#heapSnapshotOptions.classDiffs;
+            if (classDiffs) {
+                response.push('### Heap Snapshot Diff');
+                response.push(useToon && toonEncode
+                    ? toonEncode(classDiffs)
+                    : HeapSnapshotFormatter.formatDiffSummary(classDiffs));
+                structuredContent.heapSnapshotClassDiffs = classDiffs;
+            }
+            const detailedClassDiff = this.#heapSnapshotOptions.detailedClassDiff;
+            if (detailedClassDiff) {
+                response.push('### Heap Snapshot Detailed Diff');
+                response.push(useToon && toonEncode
+                    ? toonEncode(detailedClassDiff)
+                    : HeapSnapshotFormatter.formatDiffDetails(detailedClassDiff));
+                structuredContent.heapSnapshotDetailedClassDiff = detailedClassDiff;
+            }
+            const duplicateStrings = this.#heapSnapshotOptions.duplicateStrings;
+            if (duplicateStrings) {
+                response.push('### Duplicate Strings');
+                const paginationData = this.#dataWithPagination(duplicateStrings, this.#heapSnapshotOptions.pagination);
+                structuredContent.pagination = paginationData.pagination;
+                response.push(...paginationData.info);
+                const formatted = HeapSnapshotFormatter.formatDuplicateStrings(paginationData.items);
+                response.push(formatted);
+                structuredContent.heapSnapshotDuplicateStrings = paginationData.items;
+            }
         }
         if (data.detailedNetworkRequest) {
             response.push(data.detailedNetworkRequest.toStringDetailed());
@@ -879,7 +938,7 @@ Call ${handleDialog.name} to handle it before continuing.`);
                 response.push(...paginationData.info);
                 if (data.networkRequests) {
                     structuredContent.networkRequests = paginationData.items.map(i => i.toJSON());
-                    response.push(...(useToon
+                    response.push(...(useToon && toonEncode
                         ? [toonEncode(structuredContent.networkRequests)]
                         : paginationData.items.map(i => i.toString())));
                 }
@@ -897,7 +956,7 @@ Call ${handleDialog.name} to handle it before continuing.`);
                 structuredContent.pagination = paginationData.pagination;
                 structuredContent.consoleMessages = paginationData.items.map(item => item.toJSON());
                 response.push(...paginationData.info);
-                if (useToon) {
+                if (useToon && toonEncode) {
                     response.push(toonEncode(structuredContent.consoleMessages));
                 }
                 else {

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

@@ -82,6 +82,30 @@ export const commands = {
             },
         },
     },
+    compare_heapsnapshots: {
+        description: 'Loads two memory heapsnapshots and returns the comparison. If classIndex is provided, returns detailed diff for that class, otherwise returns summary diff. (requires flag: --memoryDebugging=true)',
+        category: 'Memory',
+        args: {
+            baseFilePath: {
+                name: 'baseFilePath',
+                type: 'string',
+                description: 'A path to the base .heapsnapshot file (earlier snapshot).',
+                required: true,
+            },
+            currentFilePath: {
+                name: 'currentFilePath',
+                type: 'string',
+                description: 'A path to the current .heapsnapshot file (later snapshot).',
+                required: true,
+            },
+            classIndex: {
+                name: 'classIndex',
+                type: 'number',
+                description: 'Optional 0-based index of the class in the summary list to filter results, showing individual objects.',
+                required: false,
+            },
+        },
+    },
     drag: {
         description: 'Drag an element onto another element',
         category: 'Input automation',
@@ -157,13 +181,13 @@ export const commands = {
         },
     },
     evaluate_script: {
-        description: 'Evaluate a JavaScript function inside the currently selected page. Returns the response as JSON,\nso returned values have to be JSON-serializable.',
+        description: 'Evaluate a JavaScript function inside the currently selected page. Returns the response as JSON, so returned values have to be JSON-serializable.',
         category: 'Debugging',
         args: {
             function: {
                 name: 'function',
                 type: 'string',
-                description: 'A JavaScript function declaration to be executed by the tool in the currently selected page.\nExample without arguments: `() => {\n  return document.title\n}` or `async () => {\n  return await fetch("example.com")\n}`.\nExample with arguments: `(el) => {\n  return el.innerText;\n}`\n',
+                description: 'A JavaScript function declaration to be executed by the tool in the currently selected page.\nExample without arguments: `() => document.title` or `async () => await fetch("example.com")`.\nExample with arguments: `(el) => el.innerText`\n',
                 required: true,
             },
             args: {
@@ -330,6 +354,30 @@ export const commands = {
             },
         },
     },
+    get_heapsnapshot_duplicate_strings: {
+        description: 'Loads a memory heapsnapshot and returns duplicate strings grouped by their value. (requires flag: --memoryDebugging=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.',
+                required: false,
+            },
+            pageSize: {
+                name: 'pageSize',
+                type: 'number',
+                description: 'The page size for pagination.',
+                required: false,
+            },
+        },
+    },
     get_heapsnapshot_edges: {
         description: 'Loads a memory heapsnapshot and returns outgoing edges (references) for a specific node ID. (requires flag: --memoryDebugging=true)',
         category: 'Memory',
@@ -540,7 +588,7 @@ 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)",
+        description: "Lists all third-party developer tools the page exposes for providing runtime information.\nThird-party developer tools can be called via the 'execute_3p_developer_tool()' MCP tool.\nAlternatively, third-party developer tools can be executed by calling 'evaluate_script' and adding the\nfollowing command to the script:\n`window.__dtmcp.executeTool(toolName, params)`\nThis might be helpful when the third-party developer tools return non-serializable values or when composing\nthird-party developer tools with additional functionality. (requires flag: --categoryExperimentalThirdParty=true)",
         category: 'Third-party',
         args: {},
     },

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

@@ -157,7 +157,7 @@ export const cliOptions = {
     },
     experimentalToonFormat: {
         type: 'boolean',
-        describe: 'Whether to format structured data in text response using Token-Oriented Object Notation. Defaults to false which represents the embedded content as formatted JSON instead.',
+        describe: 'Whether to format structured data in text response using Token-Oriented Object Notation (requires @toon-format/toon). If running via npx, use: npx --package chrome-devtools-mcp@latest --package @toon-format/toon@latest chrome-devtools-mcp --experimentalToonFormat',
         hidden: true,
     },
     experimentalIncludeAllPages: {
@@ -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'],
     },
     ignoreDefaultBraveArg: {