feat: add take_memory_snapshot tool

Author: OrKoN

README.md

@@ -440,10 +440,11 @@ If you run into any issues, checkout our [troubleshooting guide](./docs/troubles
 - **Network** (2 tools)
   - [`get_network_request`](docs/tool-reference.md#get_network_request)
   - [`list_network_requests`](docs/tool-reference.md#list_network_requests)
-- **Debugging** (5 tools)
+- **Debugging** (6 tools)
   - [`evaluate_script`](docs/tool-reference.md#evaluate_script)
   - [`get_console_message`](docs/tool-reference.md#get_console_message)
   - [`list_console_messages`](docs/tool-reference.md#list_console_messages)
+  - [`take_memory_snapshot`](docs/tool-reference.md#take_memory_snapshot)
   - [`take_screenshot`](docs/tool-reference.md#take_screenshot)
   - [`take_snapshot`](docs/tool-reference.md#take_snapshot)
 

docs/tool-reference.md

@@ -1,6 +1,6 @@
 <!-- AUTO GENERATED DO NOT EDIT - run 'npm run docs' to update-->
 
-# Chrome DevTools MCP Tool Reference (~6719 cl100k_base tokens)
+# Chrome DevTools MCP Tool Reference (~6889 cl100k_base tokens)
 
 - **[Input automation](#input-automation)** (8 tools)
   - [`click`](#click)
@@ -28,10 +28,11 @@
 - **[Network](#network)** (2 tools)
   - [`get_network_request`](#get_network_request)
   - [`list_network_requests`](#list_network_requests)
-- **[Debugging](#debugging)** (5 tools)
+- **[Debugging](#debugging)** (6 tools)
   - [`evaluate_script`](#evaluate_script)
   - [`get_console_message`](#get_console_message)
   - [`list_console_messages`](#list_console_messages)
+  - [`take_memory_snapshot`](#take_memory_snapshot)
   - [`take_screenshot`](#take_screenshot)
   - [`take_snapshot`](#take_snapshot)
 
@@ -335,6 +336,16 @@ so returned values have to be JSON-serializable.
 
 ---
 
+### `take_memory_snapshot`
+
+**Description:** Capture a memory heapsnapshot of the currently seelcted page to memory leak debuggin
+
+**Parameters:**
+
+- **filePath** (string) **(required)**: A path to a .heapsnapshot file to save the heapsnapshot to.
+
+---
+
 ### `take_screenshot`
 
 **Description:** Take a screenshot of the page or element.

src/tools/memory.ts

@@ -0,0 +1,36 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import {zod} from '../third_party/index.js';
+
+import {ToolCategory} from './categories.js';
+import {defineTool} from './ToolDefinition.js';
+
+export const takeMemorySnapshot = defineTool({
+  name: 'take_memory_snapshot',
+  description: `Capture a memory heapsnapshot of the currently seelcted page to memory leak debuggin`,
+  annotations: {
+    category: ToolCategory.DEBUGGING,
+    readOnlyHint: true,
+  },
+  schema: {
+    filePath: zod
+      .string()
+      .describe('A path to a .heapsnapshot file to save the heapsnapshot to.')
+      .endsWith('.heapsnapshot'),
+  },
+  handler: async (request, response, context) => {
+    const page = context.getSelectedPage();
+
+    await page.captureHeapSnapshot({
+      path: request.params.filePath,
+    });
+
+    response.appendResponseLine(
+      `Heap snapshot saved to ${request.params.filePath}`,
+    );
+  },
+});

src/tools/tools.ts

@@ -8,6 +8,7 @@ import * as consoleTools from './console.js';
 import * as emulationTools from './emulation.js';
 import * as extensionTools from './extensions.js';
 import * as inputTools from './input.js';
+import * as memoryTools from './memory.js';
 import * as networkTools from './network.js';
 import * as pagesTools from './pages.js';
 import * as performanceTools from './performance.js';
@@ -22,6 +23,7 @@ const tools = [
   ...Object.values(emulationTools),
   ...Object.values(extensionTools),
   ...Object.values(inputTools),
+  ...Object.values(memoryTools),
   ...Object.values(networkTools),
   ...Object.values(pagesTools),
   ...Object.values(performanceTools),

tests/tools/memory.test.ts

@@ -0,0 +1,39 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import assert from 'node:assert';
+import {existsSync} from 'node:fs';
+import {rm} from 'node:fs/promises';
+import {tmpdir} from 'node:os';
+import {join} from 'node:path';
+import {describe, it} from 'node:test';
+
+import {takeMemorySnapshot} from '../../src/tools/memory.js';
+import {withMcpContext} from '../utils.js';
+
+describe('memory', () => {
+  describe('take_memory_snapshot', () => {
+    it('with default options', async () => {
+      await withMcpContext(async (response, context) => {
+        const filePath = join(tmpdir(), 'test-screenshot.heapsnapshot');
+        try {
+          await takeMemorySnapshot.handler(
+            {params: {filePath}},
+            response,
+            context,
+          );
+          assert.equal(
+            response.responseLines.at(0),
+            `Heap snapshot saved to ${filePath}`,
+          );
+          assert.ok(existsSync(filePath));
+        } finally {
+          await rm(filePath, {force: true});
+        }
+      });
+    });
+  });
+});