From a728c04466fedaf3bd0e794777a6600daff1c07d Mon Sep 17 00:00:00 2001
From: alinavarkki <alinavarkki@google.com>
Date: Tue, 30 Sep 2025 07:51:44 +0200
Subject: [PATCH 01/44] format

---
 docs/tool-reference.md | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/docs/tool-reference.md b/docs/tool-reference.md
index ad9410a2..0ba03b8e 100644
--- a/docs/tool-reference.md
+++ b/docs/tool-reference.md
@@ -285,15 +285,16 @@ so returned values have to JSON-serializable.
 
 - **args** (array) _(optional)_: An optional list of arguments to pass to the function.
 - **function** (string) **(required)**: A JavaScript function to run in the currently selected page.
-  Example without arguments: `() => {
+Example without arguments: `() => {
   return document.title
 }` or `async () => {
   return await fetch("example.com")
 }`.
-  Example with arguments: `(el) => {
+Example with arguments: `(el) => {
   return el.innerText;
 }`
 
+
 ---
 
 ### `list_console_messages`

From ee14198f27047eac011d1df487b9815bc8546c8a Mon Sep 17 00:00:00 2001
From: alinavarkki <alinavarkki@google.com>
Date: Tue, 30 Sep 2025 08:52:08 +0200
Subject: [PATCH 02/44] format

---
 docs/tool-reference.md | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/docs/tool-reference.md b/docs/tool-reference.md
index 0ba03b8e..ad9410a2 100644
--- a/docs/tool-reference.md
+++ b/docs/tool-reference.md
@@ -285,16 +285,15 @@ so returned values have to JSON-serializable.
 
 - **args** (array) _(optional)_: An optional list of arguments to pass to the function.
 - **function** (string) **(required)**: A JavaScript function to run in the currently selected page.
-Example without arguments: `() => {
+  Example without arguments: `() => {
   return document.title
 }` or `async () => {
   return await fetch("example.com")
 }`.
-Example with arguments: `(el) => {
+  Example with arguments: `(el) => {
   return el.innerText;
 }`
 
-
 ---
 
 ### `list_console_messages`

From 56ab3217b12b9309edfe22a4a9d1472c76a39905 Mon Sep 17 00:00:00 2001
From: alinavarkki <alinavarkki@google.com>
Date: Wed, 1 Oct 2025 11:56:17 +0200
Subject: [PATCH 03/44] option handle seperately

---
 src/McpContext.ts | 28 +++++++++++++++++++++++-----
 1 file changed, 23 insertions(+), 5 deletions(-)

diff --git a/src/McpContext.ts b/src/McpContext.ts
index d1037935..803b4887 100644
--- a/src/McpContext.ts
+++ b/src/McpContext.ts
@@ -30,6 +30,7 @@ import {WaitForHelper} from './WaitForHelper.js';
 export interface TextSnapshotNode extends SerializedAXNode {
   id: string;
   children: TextSnapshotNode[];
+  value?: string | number;
 }
 
 export interface TextSnapshot {
@@ -326,19 +327,36 @@ export class McpContext implements Context {
     // will be used for the tree serialization and mapping ids back to nodes.
     let idCounter = 0;
     const idToNode = new Map<string, TextSnapshotNode>();
-    const assignIds = (node: SerializedAXNode): TextSnapshotNode => {
+    const assignIds = async (
+      node: SerializedAXNode,
+    ): Promise<TextSnapshotNode> => {
       const nodeWithId: TextSnapshotNode = {
         ...node,
         id: `${snapshotId}_${idCounter++}`,
-        children: node.children
-          ? node.children.map(child => assignIds(child))
-          : [],
+        children: [],
       };
+
+      // The AXNode for an option doesn't contain its value, so add it from the element.
+      if (node.role === 'option') {
+        const handle = await node.elementHandle();
+        if (handle) {
+          const valueHandle = await handle.getProperty('value');
+          const optionValue = await valueHandle.jsonValue();
+          if (optionValue) {
+            nodeWithId.value = optionValue.toString();
+          }
+        }
+      }
+
+      nodeWithId.children = node.children
+        ? await Promise.all(node.children.map(child => assignIds(child)))
+        : [];
+
       idToNode.set(nodeWithId.id, nodeWithId);
       return nodeWithId;
     };
 
-    const rootNodeWithId = assignIds(rootNode);
+    const rootNodeWithId = await assignIds(rootNode);
     this.#textSnapshot = {
       root: rootNodeWithId,
       snapshotId: String(snapshotId),

From b1506edbee2d4b040d64988461250dd115bb0249 Mon Sep 17 00:00:00 2001
From: alinavarkki <alinavarkki@google.com>
Date: Wed, 1 Oct 2025 13:52:19 +0200
Subject: [PATCH 04/44] add test

---
 tests/McpContext.test.ts | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/tests/McpContext.test.ts b/tests/McpContext.test.ts
index a054baba..d1ad1958 100644
--- a/tests/McpContext.test.ts
+++ b/tests/McpContext.test.ts
@@ -33,6 +33,30 @@ describe('McpContext', () => {
     });
   });
 
+  it('should include the value of an option in the text snapshot', async () => {
+    await withBrowser(async (_response, context) => {
+      const page = context.getSelectedPage();
+      await page.setContent(`
+        <!DOCTYPE html>
+        <select>
+          <option value="1">One</option>
+          <option value="2">Two</option>
+        </select>
+      `);
+      await context.createTextSnapshot();
+      const snapshot = context.getTextSnapshot();
+      assert.ok(snapshot);
+
+      const option1 = snapshot.root.children[0]?.children[0];
+      assert.strictEqual(option1?.role, 'option');
+      assert.strictEqual(option1?.value, '1');
+
+      const option2 = snapshot.root.children[0]?.children[1];
+      assert.strictEqual(option2?.role, 'option');
+      assert.strictEqual(option2?.value, '2');
+    });
+  });
+
   it('can store and retrieve performance traces', async () => {
     await withBrowser(async (_response, context) => {
       const fakeTrace1 = {} as unknown as TraceResult;

From 047c403ee242a52b216da637ee2b0aa7c5d71234 Mon Sep 17 00:00:00 2001
From: alinavarkki <alinavarkki@google.com>
Date: Wed, 1 Oct 2025 13:55:14 +0200
Subject: [PATCH 05/44] make value string

---
 src/McpContext.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/McpContext.ts b/src/McpContext.ts
index 803b4887..8e71361a 100644
--- a/src/McpContext.ts
+++ b/src/McpContext.ts
@@ -30,7 +30,7 @@ import {WaitForHelper} from './WaitForHelper.js';
 export interface TextSnapshotNode extends SerializedAXNode {
   id: string;
   children: TextSnapshotNode[];
-  value?: string | number;
+  value?: string;
 }
 
 export interface TextSnapshot {

From c680b3ce4dd0495f9baa650933ad0a08da3f416d Mon Sep 17 00:00:00 2001
From: alinavarkki <alinavarkki@google.com>
Date: Wed, 1 Oct 2025 14:06:04 +0200
Subject: [PATCH 06/44] remove value

---
 src/McpContext.ts | 1 -
 1 file changed, 1 deletion(-)

diff --git a/src/McpContext.ts b/src/McpContext.ts
index 8e71361a..af543998 100644
--- a/src/McpContext.ts
+++ b/src/McpContext.ts
@@ -30,7 +30,6 @@ import {WaitForHelper} from './WaitForHelper.js';
 export interface TextSnapshotNode extends SerializedAXNode {
   id: string;
   children: TextSnapshotNode[];
-  value?: string;
 }
 
 export interface TextSnapshot {

From dcced0fd6043e5a2236dada49afe6c853926384a Mon Sep 17 00:00:00 2001
From: alinavarkki <alinavarkki@google.com>
Date: Wed, 1 Oct 2025 19:16:08 +0200
Subject: [PATCH 07/44] use option text as value

---
 src/McpContext.ts         | 11 ++++++-----
 src/tools/input.ts        | 21 ++++++++++++++++++++-
 tests/McpContext.test.ts  | 24 ------------------------
 tests/tools/input.test.ts | 29 +++++++++++++++++++++++++++++
 4 files changed, 55 insertions(+), 30 deletions(-)

diff --git a/src/McpContext.ts b/src/McpContext.ts
index af543998..1b21ebd8 100644
--- a/src/McpContext.ts
+++ b/src/McpContext.ts
@@ -335,14 +335,15 @@ export class McpContext implements Context {
         children: [],
       };
 
-      // The AXNode for an option doesn't contain its value, so add it from the element.
+      // The AXNode for an option doesn't contain its `value`.
+      // Therefore, set text content of the option as value.
       if (node.role === 'option') {
         const handle = await node.elementHandle();
         if (handle) {
-          const valueHandle = await handle.getProperty('value');
-          const optionValue = await valueHandle.jsonValue();
-          if (optionValue) {
-            nodeWithId.value = optionValue.toString();
+          const textContentHandle = await handle.getProperty('textContent');
+          const optionText = await textContentHandle.jsonValue();
+          if (optionText) {
+            nodeWithId.value = optionText.toString();
           }
         }
       }
diff --git a/src/tools/input.ts b/src/tools/input.ts
index eda04e80..95694a72 100644
--- a/src/tools/input.ts
+++ b/src/tools/input.ts
@@ -97,7 +97,26 @@ export const fill = defineTool({
     const handle = await context.getElementByUid(request.params.uid);
     try {
       await context.waitForEventsAfterAction(async () => {
-        await handle.asLocator().fill(request.params.value);
+        // The AXNode for an option doesn't contain its `value`. We set text content of the option as value.
+        // To fill the form, get the correct option by its text value.
+        const isSelectElement = await handle.evaluate(
+          el => el.tagName === 'SELECT',
+        );
+        if (isSelectElement) {
+          const value = await handle.evaluate((el, text) => {
+            const option = Array.from((el as HTMLSelectElement).options).find(
+              option => option.text === text,
+            );
+            if (option) {
+              return option.value;
+            }
+            return request.params.value;
+          }, request.params.value);
+
+          await handle.asLocator().fill(value);
+        } else {
+          await handle.asLocator().fill(request.params.value);
+        }
       });
       response.appendResponseLine(`Successfully filled out the element`);
       response.setIncludeSnapshot(true);
diff --git a/tests/McpContext.test.ts b/tests/McpContext.test.ts
index d1ad1958..a054baba 100644
--- a/tests/McpContext.test.ts
+++ b/tests/McpContext.test.ts
@@ -33,30 +33,6 @@ describe('McpContext', () => {
     });
   });
 
-  it('should include the value of an option in the text snapshot', async () => {
-    await withBrowser(async (_response, context) => {
-      const page = context.getSelectedPage();
-      await page.setContent(`
-        <!DOCTYPE html>
-        <select>
-          <option value="1">One</option>
-          <option value="2">Two</option>
-        </select>
-      `);
-      await context.createTextSnapshot();
-      const snapshot = context.getTextSnapshot();
-      assert.ok(snapshot);
-
-      const option1 = snapshot.root.children[0]?.children[0];
-      assert.strictEqual(option1?.role, 'option');
-      assert.strictEqual(option1?.value, '1');
-
-      const option2 = snapshot.root.children[0]?.children[1];
-      assert.strictEqual(option2?.role, 'option');
-      assert.strictEqual(option2?.value, '2');
-    });
-  });
-
   it('can store and retrieve performance traces', async () => {
     await withBrowser(async (_response, context) => {
       const fakeTrace1 = {} as unknown as TraceResult;
diff --git a/tests/tools/input.test.ts b/tests/tools/input.test.ts
index 8329192f..b788c7b5 100644
--- a/tests/tools/input.test.ts
+++ b/tests/tools/input.test.ts
@@ -202,6 +202,35 @@ describe('input', () => {
         assert.ok(await page.$('text/test'));
       });
     });
+
+    it('fills out a select by text', async () => {
+      await withBrowser(async (response, context) => {
+        const page = context.getSelectedPage();
+        await page.setContent(
+          `<!DOCTYPE html><select><option value="v1">one</option><option value="v2">two</option></select>`,
+        );
+        await context.createTextSnapshot();
+        await fill.handler(
+          {
+            params: {
+              uid: '1_1',
+              value: 'two',
+            },
+          },
+          response,
+          context,
+        );
+        assert.strictEqual(
+          response.responseLines[0],
+          'Successfully filled out the element',
+        );
+        assert.ok(response.includeSnapshot);
+        const selectedValue = await page.evaluate(
+          () => document.querySelector('select')!.value,
+        );
+        assert.strictEqual(selectedValue, 'v2');
+      });
+    });
   });
 
   describe('drags', () => {

From e873cd9b9d2c2b1fe1d22cb4bbd3cbd8a533f0f7 Mon Sep 17 00:00:00 2001
From: alinavarkki <alinavarkki@google.com>
Date: Thu, 2 Oct 2025 19:42:13 +0200
Subject: [PATCH 08/44] check if element is selector through ax node and
 extract method

---
 src/McpContext.ts           |  4 ++
 src/tools/ToolDefinition.ts |  2 +
 src/tools/input.ts          | 89 ++++++++++++++++++++++---------------
 3 files changed, 58 insertions(+), 37 deletions(-)

diff --git a/src/McpContext.ts b/src/McpContext.ts
index 1b21ebd8..5b29ce09 100644
--- a/src/McpContext.ts
+++ b/src/McpContext.ts
@@ -272,6 +272,10 @@ export class McpContext implements Context {
     return page.getDefaultNavigationTimeout();
   }
 
+  getAXNodeByUid(uid: string) {
+    return this.#textSnapshot?.idToNode.get(uid);
+  }
+
   async getElementByUid(uid: string): Promise<ElementHandle<Element>> {
     if (!this.#textSnapshot?.idToNode.size) {
       throw new Error(
diff --git a/src/tools/ToolDefinition.ts b/src/tools/ToolDefinition.ts
index fe2fae7b..56fdb53a 100644
--- a/src/tools/ToolDefinition.ts
+++ b/src/tools/ToolDefinition.ts
@@ -7,6 +7,7 @@
 import type {Dialog, ElementHandle, Page} from 'puppeteer-core';
 import z from 'zod';
 
+import type {TextSnapshotNode} from '../McpContext.js';
 import type {TraceResult} from '../trace-processing/parse.js';
 
 import type {ToolCategories} from './categories.js';
@@ -68,6 +69,7 @@ export type Context = Readonly<{
   closePage(pageIdx: number): Promise<void>;
   setSelectedPageIdx(idx: number): void;
   getElementByUid(uid: string): Promise<ElementHandle<Element>>;
+  getAXNodeByUid(uid: string): TextSnapshotNode | undefined;
   setNetworkConditions(conditions: string | null): void;
   setCpuThrottlingRate(rate: number): void;
   saveTemporaryFile(
diff --git a/src/tools/input.ts b/src/tools/input.ts
index 95694a72..1d595d0f 100644
--- a/src/tools/input.ts
+++ b/src/tools/input.ts
@@ -7,6 +7,8 @@
 import type {ElementHandle} from 'puppeteer-core';
 import z from 'zod';
 
+import type {McpContext} from '../McpContext.js';
+
 import {ToolCategories} from './categories.js';
 import {defineTool} from './ToolDefinition.js';
 
@@ -78,6 +80,40 @@ export const hover = defineTool({
   },
 });
 
+async function fillFormElement(
+  uid: string,
+  value: string,
+  context: McpContext,
+) {
+  const handle = await context.getElementByUid(uid);
+  try {
+    // The AXNode for an option doesn't contain its `value`. We set text content of the option as value.
+    // If the form is a combobox, we need to find the correct option by its text value.
+    // To do that, loop through the children while checking which child's text matches the requested value (requested value is actually the text content).
+    // When the correct option is found, use the element handle to get the real value.
+    const aXNode = context.getAXNodeByUid(uid);
+    if (aXNode && aXNode.role === 'combobox' && aXNode.children) {
+      for (const child of aXNode.children) {
+        if (child.role === 'option' && child.name === value && child.value) {
+          const childHandle = await child.elementHandle();
+          if (childHandle) {
+            const childValueHandle = await childHandle.getProperty('value');
+            const childValue = await childValueHandle.jsonValue();
+            if (childValue) {
+              await handle.asLocator().fill(childValue.toString());
+            }
+            break;
+          }
+        }
+      }
+    } else {
+      await handle.asLocator().fill(value);
+    }
+  } finally {
+    void handle.dispose();
+  }
+}
+
 export const fill = defineTool({
   name: 'fill',
   description: `Type text into a input, text area or select an option from a <select> element.`,
@@ -94,35 +130,15 @@ export const fill = defineTool({
     value: z.string().describe('The value to fill in'),
   },
   handler: async (request, response, context) => {
-    const handle = await context.getElementByUid(request.params.uid);
-    try {
-      await context.waitForEventsAfterAction(async () => {
-        // The AXNode for an option doesn't contain its `value`. We set text content of the option as value.
-        // To fill the form, get the correct option by its text value.
-        const isSelectElement = await handle.evaluate(
-          el => el.tagName === 'SELECT',
-        );
-        if (isSelectElement) {
-          const value = await handle.evaluate((el, text) => {
-            const option = Array.from((el as HTMLSelectElement).options).find(
-              option => option.text === text,
-            );
-            if (option) {
-              return option.value;
-            }
-            return request.params.value;
-          }, request.params.value);
-
-          await handle.asLocator().fill(value);
-        } else {
-          await handle.asLocator().fill(request.params.value);
-        }
-      });
-      response.appendResponseLine(`Successfully filled out the element`);
-      response.setIncludeSnapshot(true);
-    } finally {
-      void handle.dispose();
-    }
+    await context.waitForEventsAfterAction(async () => {
+      await fillFormElement(
+        request.params.uid,
+        request.params.value,
+        context as McpContext,
+      );
+    });
+    response.appendResponseLine(`Successfully filled out the element`);
+    response.setIncludeSnapshot(true);
   },
 });
 
@@ -174,14 +190,13 @@ export const fillForm = defineTool({
   },
   handler: async (request, response, context) => {
     for (const element of request.params.elements) {
-      const handle = await context.getElementByUid(element.uid);
-      try {
-        await context.waitForEventsAfterAction(async () => {
-          await handle.asLocator().fill(element.value);
-        });
-      } finally {
-        void handle.dispose();
-      }
+      await context.waitForEventsAfterAction(async () => {
+        await fillFormElement(
+          element.uid,
+          element.value,
+          context as McpContext,
+        );
+      });
     }
     response.appendResponseLine(`Successfully filled out the form`);
     response.setIncludeSnapshot(true);

From 8775b54c84b78a1831a23fb3c59e6c873e092d70 Mon Sep 17 00:00:00 2001
From: Xin Huang <dev@ret0.dev>
Date: Tue, 7 Oct 2025 00:06:55 -0700
Subject: [PATCH 09/44] docs: fix macOS typo (#263)

Fix the typo, rename MacOS to MacOS.
---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index fa62a49c..4a9f6f5b 100644
--- a/README.md
+++ b/README.md
@@ -320,7 +320,7 @@ You can also run `npx chrome-devtools-mcp@latest --help` to see all available co
 `chrome-devtools-mcp` starts a Chrome's stable channel instance using the following user
 data directory:
 
-- Linux / MacOS: `$HOME/.cache/chrome-devtools-mcp/chrome-profile-$CHANNEL`
+- Linux / macOS: `$HOME/.cache/chrome-devtools-mcp/chrome-profile-$CHANNEL`
 - Windows: `%HOMEPATH%/.cache/chrome-devtools-mcp/chrome-profile-$CHANNEL`
 
 The user data directory is not cleared between runs and shared across

From b15c44b85d011c9c247354d8c659c2ca48e8bbf1 Mon Sep 17 00:00:00 2001
From: leslie liu <35414983+leslieo2@users.noreply.github.com>
Date: Tue, 7 Oct 2025 20:04:41 +0800
Subject: [PATCH 10/44] fix: guard performance_stop_trace when tracing inactive
 (#295)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

PR Description

- Fix the stop-trace guard to call context.isRunningPerformanceTrace()
so we skip page.tracing.stop() when nothing is recording, avoiding the
Puppeteer error that bubbled up
    to users.
- Extend the “does nothing” test to stub tracing.stop() and assert it
stays untouched, guaranteeing the guard path is covered.
---
 src/tools/performance.ts        | 2 +-
 tests/tools/performance.test.ts | 4 ++++
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/src/tools/performance.ts b/src/tools/performance.ts
index 6f3af7c3..c9de76f7 100644
--- a/src/tools/performance.ts
+++ b/src/tools/performance.ts
@@ -111,7 +111,7 @@ export const stopTrace = defineTool({
   },
   schema: {},
   handler: async (_request, response, context) => {
-    if (!context.isRunningPerformanceTrace) {
+    if (!context.isRunningPerformanceTrace()) {
       return;
     }
     const page = context.getSelectedPage();
diff --git a/tests/tools/performance.test.ts b/tests/tools/performance.test.ts
index ec14381e..b8ac5533 100644
--- a/tests/tools/performance.test.ts
+++ b/tests/tools/performance.test.ts
@@ -218,7 +218,11 @@ describe('performance', () => {
     it('does nothing if the trace is not running and does not error', async () => {
       await withBrowser(async (response, context) => {
         context.setIsRunningPerformanceTrace(false);
+        const selectedPage = context.getSelectedPage();
+        const stopTracingStub = sinon.stub(selectedPage.tracing, 'stop');
         await stopTrace.handler({params: {}}, response, context);
+        sinon.assert.notCalled(stopTracingStub);
+        assert.strictEqual(context.isRunningPerformanceTrace(), false);
       });
     });
 

From 75f63a2b9b44a9aabb5bc9fed819633501ecefed Mon Sep 17 00:00:00 2001
From: Alex Rudenko <OrKoN@users.noreply.github.com>
Date: Tue, 7 Oct 2025 14:33:59 +0200
Subject: [PATCH 11/44] fix(cli): tolerate empty browser URLs (#298)

it seems some clients default to empty default values for args. We can
accept that and do not error for these.

Closes https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/264
---
 src/cli.ts        |  5 ++++-
 tests/cli.test.ts | 19 +++++++++++++++++++
 2 files changed, 23 insertions(+), 1 deletion(-)

diff --git a/src/cli.ts b/src/cli.ts
index 23719fb1..85fcf839 100644
--- a/src/cli.ts
+++ b/src/cli.ts
@@ -14,7 +14,10 @@ export const cliOptions = {
     description:
       'Connect to a running Chrome instance using port forwarding. For more details see: https://developer.chrome.com/docs/devtools/remote-debugging/local-server.',
     alias: 'u',
-    coerce: (url: string) => {
+    coerce: (url: string | undefined) => {
+      if (!url) {
+        return;
+      }
       try {
         new URL(url);
       } catch {
diff --git a/tests/cli.test.ts b/tests/cli.test.ts
index 014faf95..1580825c 100644
--- a/tests/cli.test.ts
+++ b/tests/cli.test.ts
@@ -38,6 +38,25 @@ describe('cli args parsing', () => {
     });
   });
 
+  it('parses an empty browser url', async () => {
+    const args = parseArguments('1.0.0', [
+      'node',
+      'main.js',
+      '--browserUrl',
+      '',
+    ]);
+    assert.deepStrictEqual(args, {
+      _: [],
+      headless: false,
+      isolated: false,
+      $0: 'npx chrome-devtools-mcp@latest',
+      'browser-url': undefined,
+      browserUrl: undefined,
+      u: undefined,
+      channel: 'stable',
+    });
+  });
+
   it('parses with executable path', async () => {
     const args = parseArguments('1.0.0', [
       'node',

From 5bc6379fe934eb08f601dacdd75f131b900e4ec3 Mon Sep 17 00:00:00 2001
From: Alex Rudenko <OrKoN@users.noreply.github.com>
Date: Tue, 7 Oct 2025 15:27:23 +0200
Subject: [PATCH 12/44] fix: change default screen size in headless (#299)

Sets the screen size in headless to be 3840x2160px to allow resize tool
to work correctly for most use cases.

Closes https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/294
---
 README.md             | 2 +-
 src/browser.ts        | 3 +++
 src/cli.ts            | 2 +-
 tests/browser.test.ts | 8 ++++----
 4 files changed, 9 insertions(+), 6 deletions(-)

diff --git a/README.md b/README.md
index 4a9f6f5b..e083f1c8 100644
--- a/README.md
+++ b/README.md
@@ -280,7 +280,7 @@ The Chrome DevTools MCP server supports the following configuration option:
   - **Type:** string
 
 - **`--viewport`**
-  Initial viewport size for the Chrome instances started by the server. For example, `1280x720`
+  Initial viewport size for the Chrome instances started by the server. For example, `1280x720`. In headless mode, max size is 3840x2160px.
   - **Type:** string
 
 - **`--proxyServer`**
diff --git a/src/browser.ts b/src/browser.ts
index d5a17e17..5387b3ef 100644
--- a/src/browser.ts
+++ b/src/browser.ts
@@ -99,6 +99,9 @@ export async function launch(options: McpLaunchOptions): Promise<Browser> {
   if (customDevTools) {
     args.push(`--custom-devtools-frontend=file://${customDevTools}`);
   }
+  if (headless) {
+    args.push('--screen-info={3840x2160}');
+  }
   let puppeteerChannel: ChromeReleaseChannel | undefined;
   if (!executablePath) {
     puppeteerChannel =
diff --git a/src/cli.ts b/src/cli.ts
index 85fcf839..909d1a21 100644
--- a/src/cli.ts
+++ b/src/cli.ts
@@ -65,7 +65,7 @@ export const cliOptions = {
   viewport: {
     type: 'string',
     describe:
-      'Initial viewport size for the Chrome instances started by the server. For example, `1280x720`',
+      'Initial viewport size for the Chrome instances started by the server. For example, `1280x720`. In headless mode, max size is 3840x2160px.',
     coerce: (arg: string | undefined) => {
       if (arg === undefined) {
         return;
diff --git a/tests/browser.test.ts b/tests/browser.test.ts
index 3dc8eff0..b4811202 100644
--- a/tests/browser.test.ts
+++ b/tests/browser.test.ts
@@ -52,8 +52,8 @@ describe('browser', () => {
       userDataDir: folderPath,
       executablePath: executablePath(),
       viewport: {
-        width: 700,
-        height: 500,
+        width: 1501,
+        height: 801,
       },
     });
     try {
@@ -62,8 +62,8 @@ describe('browser', () => {
         return {width: window.innerWidth, height: window.innerHeight};
       });
       assert.deepStrictEqual(result, {
-        width: 700,
-        height: 500,
+        width: 1501,
+        height: 801,
       });
     } finally {
       await browser.close();

From f9290a538c7412c4988830d3792c922af567d741 Mon Sep 17 00:00:00 2001
From: browser-automation-bot
 <133232582+browser-automation-bot@users.noreply.github.com>
Date: Wed, 8 Oct 2025 08:46:49 +0200
Subject: [PATCH 13/44] chore(main): release chrome-devtools-mcp 0.6.1 (#297)

:robot: I have created a release *beep* *boop*
---


##
[0.6.1](https://github.com/ChromeDevTools/chrome-devtools-mcp/compare/chrome-devtools-mcp-v0.6.0...chrome-devtools-mcp-v0.6.1)
(2025-10-07)


### Bug Fixes

* change default screen size in headless
([#299](https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/299))
([357db65](https://github.com/ChromeDevTools/chrome-devtools-mcp/commit/357db65d18f87b1299a0f6212b7ec982ef187171))
* **cli:** tolerate empty browser URLs
([#298](https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/298))
([098a904](https://github.com/ChromeDevTools/chrome-devtools-mcp/commit/098a904b363f3ad81595ed58c25d34dd7d82bcd8))
* guard performance_stop_trace when tracing inactive
([#295](https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/295))
([8200194](https://github.com/ChromeDevTools/chrome-devtools-mcp/commit/8200194c8037cc30b8ab815e5ee0d0b2b000bea6))

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).
---
 .release-please-manifest.json | 2 +-
 CHANGELOG.md                  | 9 +++++++++
 package-lock.json             | 4 ++--
 package.json                  | 2 +-
 4 files changed, 13 insertions(+), 4 deletions(-)

diff --git a/.release-please-manifest.json b/.release-please-manifest.json
index bcd05228..5d02000a 100644
--- a/.release-please-manifest.json
+++ b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "0.6.0"
+  ".": "0.6.1"
 }
diff --git a/CHANGELOG.md b/CHANGELOG.md
index d708adcb..3b88b615 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,14 @@
 # Changelog
 
+## [0.6.1](https://github.com/ChromeDevTools/chrome-devtools-mcp/compare/chrome-devtools-mcp-v0.6.0...chrome-devtools-mcp-v0.6.1) (2025-10-07)
+
+
+### Bug Fixes
+
+* change default screen size in headless ([#299](https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/299)) ([357db65](https://github.com/ChromeDevTools/chrome-devtools-mcp/commit/357db65d18f87b1299a0f6212b7ec982ef187171))
+* **cli:** tolerate empty browser URLs ([#298](https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/298)) ([098a904](https://github.com/ChromeDevTools/chrome-devtools-mcp/commit/098a904b363f3ad81595ed58c25d34dd7d82bcd8))
+* guard performance_stop_trace when tracing inactive ([#295](https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/295)) ([8200194](https://github.com/ChromeDevTools/chrome-devtools-mcp/commit/8200194c8037cc30b8ab815e5ee0d0b2b000bea6))
+
 ## [0.6.0](https://github.com/ChromeDevTools/chrome-devtools-mcp/compare/chrome-devtools-mcp-v0.5.1...chrome-devtools-mcp-v0.6.0) (2025-10-01)
 
 
diff --git a/package-lock.json b/package-lock.json
index 0248f049..2435a3f2 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "chrome-devtools-mcp",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "chrome-devtools-mcp",
-      "version": "0.6.0",
+      "version": "0.6.1",
       "license": "Apache-2.0",
       "dependencies": {
         "@modelcontextprotocol/sdk": "1.19.1",
diff --git a/package.json b/package.json
index 63f7ceee..fe960cf4 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "chrome-devtools-mcp",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "MCP server for Chrome DevTools",
   "type": "module",
   "bin": "./build/src/index.js",

From c5e399ea30c57a722e77a82dc252d271b3bbb9f8 Mon Sep 17 00:00:00 2001
From: HARSHITH LUCKY <101515387+harshithluc073@users.noreply.github.com>
Date: Wed, 8 Oct 2025 14:30:23 +0530
Subject: [PATCH 14/44] docs: fix typo in save configuration shortcut (#307)

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index e083f1c8..d0f8204f 100644
--- a/README.md
+++ b/README.md
@@ -111,7 +111,7 @@ Start the dialog to add a new MCP server by running:
 /mcp add
 ```
 
-Configure the following fields and press `CTR-S` to save the configuration:
+Configure the following fields and press `CTRL+S` to save the configuration:
 
 - **Server name:** `chrome-devtools`
 - **Server Type:** `[1] Local`

From 5fc53d7f4b6c311bb79b412839165555ecfadf06 Mon Sep 17 00:00:00 2001
From: Nicholas Roscino <nroscino@google.com>
Date: Wed, 8 Oct 2025 11:22:10 +0200
Subject: [PATCH 15/44] feat: add request and response body (#267)

This PR adds the request and response bodies into the context if they
are available and in a readable format.

---------

Co-authored-by: Nicholas Roscino <nroscino@chromium.org>
Co-authored-by: Nikolay Vitkov <34244704+Lightning00Blade@users.noreply.github.com>
---
 src/McpResponse.ts                        |  45 ++++++-
 src/formatters/networkFormatter.ts        |  64 +++++++++-
 tests/McpResponse.test.ts                 |  47 +++++++-
 tests/formatters/networkFormatter.test.ts | 139 +++++++++++++++++++++-
 tests/utils.ts                            |  12 ++
 5 files changed, 299 insertions(+), 8 deletions(-)

diff --git a/src/McpResponse.ts b/src/McpResponse.ts
index fa3c69ae..bf7603bf 100644
--- a/src/McpResponse.ts
+++ b/src/McpResponse.ts
@@ -12,6 +12,8 @@ import type {ResourceType} from 'puppeteer-core';
 import {formatConsoleEvent} from './formatters/consoleFormatter.js';
 import {
   getFormattedHeaderValue,
+  getFormattedResponseBody,
+  getFormattedRequestBody,
   getShortDescriptionForRequest,
   getStatusFromRequest,
 } from './formatters/networkFormatter.js';
@@ -21,10 +23,16 @@ import {handleDialog} from './tools/pages.js';
 import type {ImageContentData, Response} from './tools/ToolDefinition.js';
 import {paginate, type PaginationOptions} from './utils/pagination.js';
 
+interface NetworkRequestData {
+  networkRequestUrl: string;
+  requestBody?: string;
+  responseBody?: string;
+}
+
 export class McpResponse implements Response {
   #includePages = false;
   #includeSnapshot = false;
-  #attachedNetworkRequestUrl?: string;
+  #attachedNetworkRequestData?: NetworkRequestData;
   #includeConsoleData = false;
   #textResponseLines: string[] = [];
   #formattedConsoleData?: string[];
@@ -74,7 +82,9 @@ export class McpResponse implements Response {
   }
 
   attachNetworkRequest(url: string): void {
-    this.#attachedNetworkRequestUrl = url;
+    this.#attachedNetworkRequestData = {
+      networkRequestUrl: url,
+    };
   }
 
   get includePages(): boolean {
@@ -89,7 +99,7 @@ export class McpResponse implements Response {
     return this.#includeConsoleData;
   }
   get attachedNetworkRequestUrl(): string | undefined {
-    return this.#attachedNetworkRequestUrl;
+    return this.#attachedNetworkRequestData?.networkRequestUrl;
   }
   get networkRequestsPageIdx(): number | undefined {
     return this.#networkRequestsOptions?.pagination?.pageIdx;
@@ -127,6 +137,22 @@ export class McpResponse implements Response {
     }
 
     let formattedConsoleMessages: string[];
+
+    if (this.#attachedNetworkRequestData?.networkRequestUrl) {
+      const request = context.getNetworkRequestByUrl(
+        this.#attachedNetworkRequestData.networkRequestUrl,
+      );
+
+      this.#attachedNetworkRequestData.requestBody =
+        await getFormattedRequestBody(request);
+
+      const response = request.response();
+      if (response) {
+        this.#attachedNetworkRequestData.responseBody =
+          await getFormattedResponseBody(response);
+      }
+    }
+
     if (this.#includeConsoleData) {
       const consoleMessages = context.getConsoleData();
       if (consoleMessages) {
@@ -274,10 +300,11 @@ Call ${handleDialog.name} to handle it before continuing.`);
 
   #getIncludeNetworkRequestsData(context: McpContext): string[] {
     const response: string[] = [];
-    const url = this.#attachedNetworkRequestUrl;
+    const url = this.#attachedNetworkRequestData?.networkRequestUrl;
     if (!url) {
       return response;
     }
+
     const httpRequest = context.getNetworkRequestByUrl(url);
     response.push(`## Request ${httpRequest.url()}`);
     response.push(`Status:  ${getStatusFromRequest(httpRequest)}`);
@@ -286,6 +313,11 @@ Call ${handleDialog.name} to handle it before continuing.`);
       response.push(line);
     }
 
+    if (this.#attachedNetworkRequestData?.requestBody) {
+      response.push(`### Request Body`);
+      response.push(this.#attachedNetworkRequestData.requestBody);
+    }
+
     const httpResponse = httpRequest.response();
     if (httpResponse) {
       response.push(`### Response Headers`);
@@ -294,6 +326,11 @@ Call ${handleDialog.name} to handle it before continuing.`);
       }
     }
 
+    if (this.#attachedNetworkRequestData?.responseBody) {
+      response.push(`### Response Body`);
+      response.push(this.#attachedNetworkRequestData.responseBody);
+    }
+
     const httpFailure = httpRequest.failure();
     if (httpFailure) {
       response.push(`### Request failed with`);
diff --git a/src/formatters/networkFormatter.ts b/src/formatters/networkFormatter.ts
index f74e954f..7796f01a 100644
--- a/src/formatters/networkFormatter.ts
+++ b/src/formatters/networkFormatter.ts
@@ -4,7 +4,11 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
-import type {HTTPRequest} from 'puppeteer-core';
+import {isUtf8} from 'node:buffer';
+
+import type {HTTPRequest, HTTPResponse} from 'puppeteer-core';
+
+const BODY_CONTEXT_SIZE_LIMIT = 10000;
 
 export function getShortDescriptionForRequest(request: HTTPRequest): string {
   return `${request.url()} ${request.method()} ${getStatusFromRequest(request)}`;
@@ -37,3 +41,61 @@ export function getFormattedHeaderValue(
   }
   return response;
 }
+
+export async function getFormattedResponseBody(
+  httpResponse: HTTPResponse,
+  sizeLimit = BODY_CONTEXT_SIZE_LIMIT,
+): Promise<string | undefined> {
+  try {
+    const responseBuffer = await httpResponse.buffer();
+
+    if (isUtf8(responseBuffer)) {
+      const responseAsTest = responseBuffer.toString('utf-8');
+
+      if (responseAsTest.length === 0) {
+        return `<empty response>`;
+      }
+
+      return `${getSizeLimitedString(responseAsTest, sizeLimit)}`;
+    }
+
+    return `<binary data>`;
+  } catch {
+    // buffer() call might fail with CDP exception, in this case we don't print anything in the context
+    return;
+  }
+}
+
+export async function getFormattedRequestBody(
+  httpRequest: HTTPRequest,
+  sizeLimit: number = BODY_CONTEXT_SIZE_LIMIT,
+): Promise<string | undefined> {
+  if (httpRequest.hasPostData()) {
+    const data = httpRequest.postData();
+
+    if (data) {
+      return `${getSizeLimitedString(data, sizeLimit)}`;
+    }
+
+    try {
+      const fetchData = await httpRequest.fetchPostData();
+
+      if (fetchData) {
+        return `${getSizeLimitedString(fetchData, sizeLimit)}`;
+      }
+    } catch {
+      // fetchPostData() call might fail with CDP exception, in this case we don't print anything in the context
+      return;
+    }
+  }
+
+  return;
+}
+
+function getSizeLimitedString(text: string, sizeLimit: number) {
+  if (text.length > sizeLimit) {
+    return `${text.substring(0, sizeLimit) + '... <truncated>'}`;
+  }
+
+  return `${text}`;
+}
diff --git a/tests/McpResponse.test.ts b/tests/McpResponse.test.ts
index 87529102..586b524f 100644
--- a/tests/McpResponse.test.ts
+++ b/tests/McpResponse.test.ts
@@ -6,7 +6,7 @@
 import assert from 'node:assert';
 import {describe, it} from 'node:test';
 
-import {getMockRequest, html, withBrowser} from './utils.js';
+import {getMockRequest, getMockResponse, html, withBrowser} from './utils.js';
 
 describe('McpResponse', () => {
   it('list pages', async () => {
@@ -202,6 +202,51 @@ http://example.com GET [pending]`,
     });
   });
 
+  it('add network request when attached with POST data', async () => {
+    await withBrowser(async (response, context) => {
+      response.setIncludeNetworkRequests(true);
+      const httpResponse = getMockResponse();
+      httpResponse.buffer = () => {
+        return Promise.resolve(Buffer.from(JSON.stringify({response: 'body'})));
+      };
+      httpResponse.headers = () => {
+        return {
+          'Content-Type': 'application/json',
+        };
+      };
+      const request = getMockRequest({
+        method: 'POST',
+        hasPostData: true,
+        postData: JSON.stringify({request: 'body'}),
+        response: httpResponse,
+      });
+      context.getNetworkRequests = () => {
+        return [request];
+      };
+      response.attachNetworkRequest(request.url());
+
+      const result = await response.handle('test', context);
+
+      assert.strictEqual(
+        result[0].text,
+        `# test response
+## Request http://example.com
+Status:  [success - 200]
+### Request Headers
+- content-size:10
+### Request Body
+${JSON.stringify({request: 'body'})}
+### Response Headers
+- Content-Type:application/json
+### Response Body
+${JSON.stringify({response: 'body'})}
+## Network requests
+Showing 1-1 of 1 (Page 1 of 1).
+http://example.com POST [success - 200]`,
+      );
+    });
+  });
+
   it('add network request when attached', async () => {
     await withBrowser(async (response, context) => {
       response.setIncludeNetworkRequests(true);
diff --git a/tests/formatters/networkFormatter.test.ts b/tests/formatters/networkFormatter.test.ts
index 515d94ee..23c8a323 100644
--- a/tests/formatters/networkFormatter.test.ts
+++ b/tests/formatters/networkFormatter.test.ts
@@ -7,8 +7,12 @@
 import assert from 'node:assert';
 import {describe, it} from 'node:test';
 
+import {ProtocolError} from 'puppeteer-core';
+
 import {
   getFormattedHeaderValue,
+  getFormattedRequestBody,
+  getFormattedResponseBody,
   getShortDescriptionForRequest,
 } from '../../src/formatters/networkFormatter.js';
 import {getMockRequest, getMockResponse} from '../utils.js';
@@ -34,7 +38,6 @@ describe('networkFormatter', () => {
 
       assert.equal(result, 'http://example.com GET [success - 200]');
     });
-
     it('shows correct status for request with response code in 100', async () => {
       const response = getMockResponse({
         status: 199,
@@ -53,7 +56,6 @@ describe('networkFormatter', () => {
 
       assert.equal(result, 'http://example.com GET [failed - 300]');
     });
-
     it('shows correct status for request that failed', async () => {
       const request = getMockRequest({
         failure() {
@@ -100,4 +102,137 @@ describe('networkFormatter', () => {
       assert.deepEqual(result, []);
     });
   });
+
+  describe('getFormattedRequestBody', () => {
+    it('shows data from fetchPostData if postData is undefined', async () => {
+      const request = getMockRequest({
+        hasPostData: true,
+        postData: undefined,
+        fetchPostData: Promise.resolve('test'),
+      });
+
+      const result = await getFormattedRequestBody(request, 200);
+
+      assert.strictEqual(result, 'test');
+    });
+    it('shows empty string when no postData available', async () => {
+      const request = getMockRequest({
+        hasPostData: false,
+      });
+
+      const result = await getFormattedRequestBody(request, 200);
+
+      assert.strictEqual(result, undefined);
+    });
+    it('shows request body when postData is available', async () => {
+      const request = getMockRequest({
+        postData: JSON.stringify({
+          request: 'body',
+        }),
+        hasPostData: true,
+      });
+
+      const result = await getFormattedRequestBody(request, 200);
+
+      assert.strictEqual(
+        result,
+        `${JSON.stringify({
+          request: 'body',
+        })}`,
+      );
+    });
+    it('shows trunkated string correctly with postData', async () => {
+      const request = getMockRequest({
+        postData: 'some text that is longer than expected',
+        hasPostData: true,
+      });
+
+      const result = await getFormattedRequestBody(request, 20);
+
+      assert.strictEqual(result, 'some text that is lo... <truncated>');
+    });
+    it('shows trunkated string correctly with fetchPostData', async () => {
+      const request = getMockRequest({
+        fetchPostData: Promise.resolve(
+          'some text that is longer than expected',
+        ),
+        postData: undefined,
+        hasPostData: true,
+      });
+
+      const result = await getFormattedRequestBody(request, 20);
+
+      assert.strictEqual(result, 'some text that is lo... <truncated>');
+    });
+    it('shows nothing on exception', async () => {
+      const request = getMockRequest({
+        hasPostData: true,
+        postData: undefined,
+        fetchPostData: Promise.reject(new ProtocolError()),
+      });
+
+      const result = await getFormattedRequestBody(request, 200);
+
+      assert.strictEqual(result, undefined);
+    });
+  });
+
+  describe('getFormattedResponseBody', () => {
+    it('handles empty buffer correctly', async () => {
+      const response = getMockResponse();
+      response.buffer = () => {
+        return Promise.resolve(Buffer.from(''));
+      };
+
+      const result = await getFormattedResponseBody(response, 200);
+
+      assert.strictEqual(result, '<empty response>');
+    });
+    it('handles base64 text correctly', async () => {
+      const binaryBuffer = Buffer.from([
+        0xde, 0xad, 0xbe, 0xef, 0x00, 0x41, 0x42, 0x43,
+      ]);
+      const response = getMockResponse();
+      response.buffer = () => {
+        return Promise.resolve(binaryBuffer);
+      };
+
+      const result = await getFormattedResponseBody(response, 200);
+
+      assert.strictEqual(result, '<binary data>');
+    });
+    it('handles the text limit correctly', async () => {
+      const response = getMockResponse();
+      response.buffer = () => {
+        return Promise.resolve(
+          Buffer.from('some text that is longer than expected'),
+        );
+      };
+
+      const result = await getFormattedResponseBody(response, 20);
+
+      assert.strictEqual(result, 'some text that is lo... <truncated>');
+    });
+    it('handles the text format correctly', async () => {
+      const response = getMockResponse();
+      response.buffer = () => {
+        return Promise.resolve(Buffer.from(JSON.stringify({response: 'body'})));
+      };
+
+      const result = await getFormattedResponseBody(response, 200);
+
+      assert.strictEqual(result, `${JSON.stringify({response: 'body'})}`);
+    });
+    it('handles error correctly', async () => {
+      const response = getMockResponse();
+      response.buffer = () => {
+        // CDP Error simulation
+        return Promise.reject(new ProtocolError());
+      };
+
+      const result = await getFormattedResponseBody(response, 200);
+
+      assert.strictEqual(result, undefined);
+    });
+  });
 });
diff --git a/tests/utils.ts b/tests/utils.ts
index 82b4da4e..0197e181 100644
--- a/tests/utils.ts
+++ b/tests/utils.ts
@@ -46,6 +46,9 @@ export function getMockRequest(
     response?: HTTPResponse;
     failure?: HTTPRequest['failure'];
     resourceType?: string;
+    hasPostData?: boolean;
+    postData?: string;
+    fetchPostData?: Promise<string>;
   } = {},
 ): HTTPRequest {
   return {
@@ -55,6 +58,15 @@ export function getMockRequest(
     method() {
       return options.method ?? 'GET';
     },
+    fetchPostData() {
+      return options.fetchPostData ?? Promise.reject();
+    },
+    hasPostData() {
+      return options.hasPostData ?? false;
+    },
+    postData() {
+      return options.postData;
+    },
     response() {
       return options.response ?? null;
     },

From af8152f42f7ab4c6b597aa7e1c8742d969573904 Mon Sep 17 00:00:00 2001
From: Nikolay Vitkov <34244704+Lightning00Blade@users.noreply.github.com>
Date: Wed, 8 Oct 2025 11:50:28 +0200
Subject: [PATCH 16/44] ci: add rerun for publish (#309)

This will allow us to manually call the run so the latest GitHub Action
config from main is picked up.
It also updates the Publisher to the latest version, and extracts the
command in vars so its easier to
update and read.
---
 .github/workflows/publish-to-npm-on-tag.yml | 12 +++++++++++-
 server.json                                 |  4 ++--
 2 files changed, 13 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/publish-to-npm-on-tag.yml b/.github/workflows/publish-to-npm-on-tag.yml
index 69112d3b..aa921432 100644
--- a/.github/workflows/publish-to-npm-on-tag.yml
+++ b/.github/workflows/publish-to-npm-on-tag.yml
@@ -4,6 +4,14 @@ on:
   push:
     tags:
       - 'chrome-devtools-mcp-v*'
+  workflow_call:
+    inputs:
+      npm-publish:
+        default: false
+        type: boolean
+      mcp-publish:
+        default: true
+        type: boolean
 
 permissions:
   id-token: write # Required for OIDC
@@ -70,7 +78,9 @@ jobs:
 
       - name: Install MCP Publisher
         run: |
-          curl -L "https://github.com/modelcontextprotocol/registry/releases/download/v1.1.0/mcp-publisher_1.1.0_$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz" | tar xz mcp-publisher
+          export VERSION="1.2.1"
+          export OS=$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/')
+          curl -L "https://github.com/modelcontextprotocol/registry/releases/download/v${VERSION}/mcp-publisher_${VERSION}_${OS}.tar.gz" | tar xz mcp-publisher
 
       - name: Login to MCP Registry
         run: ./mcp-publisher login github-oidc
diff --git a/server.json b/server.json
index 11ce929d..a7e366a6 100644
--- a/server.json
+++ b/server.json
@@ -7,13 +7,13 @@
     "url": "https://github.com/ChromeDevTools/chrome-devtools-mcp",
     "source": "github"
   },
-  "version": "0.2.5",
+  "version": "0.6.0",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "chrome-devtools-mcp",
-      "version": "0.2.5",
+      "version": "0.6.0",
       "transport": {
         "type": "stdio"
       },

From 05bd82c13e29388e0b8e65cf7a25a8759b14c703 Mon Sep 17 00:00:00 2001
From: Nikolay Vitkov <34244704+Lightning00Blade@users.noreply.github.com>
Date: Wed, 8 Oct 2025 11:54:55 +0200
Subject: [PATCH 17/44] chore: provide a structured bug template (#301)

I think this will help people structure what is needed more easily.
The current version does not restrict anything so it's as close as a
no-op as possible

TODO: I need to look in how to add the screenshot part back.
---
 .github/ISSUE_TEMPLATE/01-bug.yml    | 73 ++++++++++++++++++++++++++++
 .github/ISSUE_TEMPLATE/bug_report.md | 31 ------------
 2 files changed, 73 insertions(+), 31 deletions(-)
 create mode 100644 .github/ISSUE_TEMPLATE/01-bug.yml
 delete mode 100644 .github/ISSUE_TEMPLATE/bug_report.md

diff --git a/.github/ISSUE_TEMPLATE/01-bug.yml b/.github/ISSUE_TEMPLATE/01-bug.yml
new file mode 100644
index 00000000..8267bd70
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/01-bug.yml
@@ -0,0 +1,73 @@
+name: Bug report
+description: File a bug report for chrome-devtools-mcp
+title: '<short description of the bug>'
+labels:
+  - 'bug'
+body:
+  - id: description
+    type: textarea
+    attributes:
+      label: Description of the bug
+      description: >
+        A clear and concise description of what the bug is.
+      placeholder:
+    validations:
+      required: true
+
+  - id: reproduce
+    type: textarea
+    attributes:
+      label: Reproduction
+      description: >
+        Steps to reproduce the behavior:
+      placeholder: |
+        1. Use tool '...'
+        2. Then use tool '...'
+
+  - id: expectation
+    type: textarea
+    attributes:
+      label: Expectation
+      description: A clear and concise description of what you expected to happen.
+
+  - id: mcp-configuration
+    type: textarea
+    attributes:
+      label: MCP configuration
+
+  - id: node-version
+    type: input
+    attributes:
+      label: Node version
+      description: >
+        Please verify you have the minimal supported version listed in the README.md
+
+  - id: chrome-version
+    type: input
+    attributes:
+      label: Chrome version
+
+  - id: coding-agent-version
+    type: input
+    attributes:
+      label: Coding agent version
+
+  - id: model-version
+    type: input
+    attributes:
+      label: Model version
+
+  - id: chat-log
+    type: input
+    attributes:
+      label: Chat log
+
+  - id: operating-system
+    type: dropdown
+    attributes:
+      label: Operating system
+      description: What supported operating system are you running?
+      options:
+        - Windows
+        - macOS
+        - Linux
diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md
deleted file mode 100644
index 96e9aee3..00000000
--- a/.github/ISSUE_TEMPLATE/bug_report.md
+++ /dev/null
@@ -1,31 +0,0 @@
----
-name: Bug report
-about: Create a report to help us improve
-title: ''
-labels: bug
-assignees: ''
----
-
-**Describe the bug**
-A clear and concise description of what the bug is.
-
-**To Reproduce**
-Steps to reproduce the behavior:
-
-1. Go to '...'
-2. Click on '....'
-3. Scroll down to '....'
-4. See error
-
-**Expected behavior**
-A clear and concise description of what you expected to happen.
-
-**Chrome version:**
-**Coding agent version:**
-**Model version:**
-
-**Screenshots**
-If applicable, add screenshots to help explain your problem.
-
-**Chat log**
-The full log of the chat with your coding agent.

From 85829d9954718f17ea1273f1e0a4a6285e26a09d Mon Sep 17 00:00:00 2001
From: Nikolay Vitkov <34244704+Lightning00Blade@users.noreply.github.com>
Date: Wed, 8 Oct 2025 12:05:20 +0200
Subject: [PATCH 18/44] chore: fix manual workflow (#310)

Action was wrong, and the jobs were not stop depending on the input.
---
 .github/workflows/publish-to-npm-on-tag.yml | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/publish-to-npm-on-tag.yml b/.github/workflows/publish-to-npm-on-tag.yml
index aa921432..6a8a4e95 100644
--- a/.github/workflows/publish-to-npm-on-tag.yml
+++ b/.github/workflows/publish-to-npm-on-tag.yml
@@ -4,12 +4,14 @@ on:
   push:
     tags:
       - 'chrome-devtools-mcp-v*'
-  workflow_call:
+  workflow_dispatch:
     inputs:
       npm-publish:
+        description: 'Whether or not to try to publish to NPM'
         default: false
         type: boolean
       mcp-publish:
+        description: 'Whether or not to try to publish to MCP registry'
         default: true
         type: boolean
 
@@ -20,6 +22,7 @@ permissions:
 jobs:
   publish-to-npm:
     runs-on: ubuntu-latest
+    if: ${{ github.event_name != 'workflow_dispatch' || inputs.npm-publish }}
     steps:
       - name: Check out repository
         uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
@@ -49,6 +52,7 @@ jobs:
 
   publish-to-mcp-registry:
     runs-on: ubuntu-latest
+    if: ${{ github.event_name != 'workflow_dispatch' || inputs.mcp-publish }}
     needs: publish-to-npm
     steps:
       - name: Check out repository

From bb9e22cf2d3e42eec6e12727b4bb141cec1216a6 Mon Sep 17 00:00:00 2001
From: Nikolay Vitkov <34244704+Lightning00Blade@users.noreply.github.com>
Date: Wed, 8 Oct 2025 13:39:07 +0200
Subject: [PATCH 19/44] chore: fix manual  workflow (#312)

The first job was skipped so the second one that was marked as `needs:
npm-publish` was getting skipped as well
I think this should fix that.
---
 .github/workflows/publish-to-npm-on-tag.yml | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/publish-to-npm-on-tag.yml b/.github/workflows/publish-to-npm-on-tag.yml
index 6a8a4e95..ceeaa377 100644
--- a/.github/workflows/publish-to-npm-on-tag.yml
+++ b/.github/workflows/publish-to-npm-on-tag.yml
@@ -7,11 +7,11 @@ on:
   workflow_dispatch:
     inputs:
       npm-publish:
-        description: 'Whether or not to try to publish to NPM'
+        description: 'Try to publish to NPM'
         default: false
         type: boolean
       mcp-publish:
-        description: 'Whether or not to try to publish to MCP registry'
+        description: 'Try to publish to MCP registry'
         default: true
         type: boolean
 
@@ -22,7 +22,7 @@ permissions:
 jobs:
   publish-to-npm:
     runs-on: ubuntu-latest
-    if: ${{ github.event_name != 'workflow_dispatch' || inputs.npm-publish }}
+    if: ${{ (github.event_name != 'workflow_dispatch') || (inputs.npm-publish && always()) }}
     steps:
       - name: Check out repository
         uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
@@ -52,8 +52,8 @@ jobs:
 
   publish-to-mcp-registry:
     runs-on: ubuntu-latest
-    if: ${{ github.event_name != 'workflow_dispatch' || inputs.mcp-publish }}
     needs: publish-to-npm
+    if: ${{ (github.event_name != 'workflow_dispatch' && needs.publish-to-npm.result == 'success') || (inputs.mcp-publish && always()) }}
     steps:
       - name: Check out repository
         uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0

From d3ae91ff9811367a88b5da0b222a92f833de4936 Mon Sep 17 00:00:00 2001
From: Nikolay Vitkov <34244704+Lightning00Blade@users.noreply.github.com>
Date: Wed, 8 Oct 2025 14:09:41 +0200
Subject: [PATCH 20/44] fix: publishing to MCP registry (#313)

Closes https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/304


https://github.com/modelcontextprotocol/registry/blob/main/docs/reference/server-json/CHANGELOG.md#migration-checklist-for-publishers
---
 server.json | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/server.json b/server.json
index a7e366a6..1f1e7f6b 100644
--- a/server.json
+++ b/server.json
@@ -1,8 +1,7 @@
 {
-  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-09-16/server.schema.json",
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-09-29/server.schema.json",
   "name": "io.github.ChromeDevTools/chrome-devtools-mcp",
   "description": "MCP server for Chrome DevTools",
-  "status": "active",
   "repository": {
     "url": "https://github.com/ChromeDevTools/chrome-devtools-mcp",
     "source": "github"

From 799c7803f5a28b78f9088d921fad4b621eb966ee Mon Sep 17 00:00:00 2001
From: Nikolay Vitkov <34244704+Lightning00Blade@users.noreply.github.com>
Date: Wed, 8 Oct 2025 17:15:43 +0200
Subject: [PATCH 21/44] fix: use default ProtocolTimeout (#315)

Closes https://github.com/ChromeDevTools/chrome-devtools-mcp/pull/271
---
 src/browser.ts | 2 --
 1 file changed, 2 deletions(-)

diff --git a/src/browser.ts b/src/browser.ts
index 5387b3ef..083e9c09 100644
--- a/src/browser.ts
+++ b/src/browser.ts
@@ -40,8 +40,6 @@ function targetFilter(target: Target): boolean {
 
 const connectOptions: ConnectOptions = {
   targetFilter,
-  // We do not expect any single CDP command to take more than 10sec.
-  protocolTimeout: 10_000,
 };
 
 export async function ensureBrowserConnected(browserURL: string) {

From 3890723a2ec744ae4db3aa66f23f4f3ed4ea1c50 Mon Sep 17 00:00:00 2001
From: Nikolay Vitkov <34244704+Lightning00Blade@users.noreply.github.com>
Date: Thu, 9 Oct 2025 22:08:28 +0200
Subject: [PATCH 22/44] chore: switch to issue type in bug template (#325)

Use the native issue time that was recently added.
---
 .github/ISSUE_TEMPLATE/01-bug.yml | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/.github/ISSUE_TEMPLATE/01-bug.yml b/.github/ISSUE_TEMPLATE/01-bug.yml
index 8267bd70..02010b90 100644
--- a/.github/ISSUE_TEMPLATE/01-bug.yml
+++ b/.github/ISSUE_TEMPLATE/01-bug.yml
@@ -1,8 +1,7 @@
 name: Bug report
 description: File a bug report for chrome-devtools-mcp
 title: '<short description of the bug>'
-labels:
-  - 'bug'
+type: 'Bug'
 body:
   - id: description
     type: textarea

From c9551243ef1ccc1132c0c18090a25be7e86ecde2 Mon Sep 17 00:00:00 2001
From: Alex Rudenko <OrKoN@users.noreply.github.com>
Date: Fri, 10 Oct 2025 09:11:36 +0200
Subject: [PATCH 23/44] docs: fix arg name typo (#327)

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index d0f8204f..032afd8e 100644
--- a/README.md
+++ b/README.md
@@ -336,5 +336,5 @@ Some MCP clients allow sandboxing the MCP server using macOS Seatbelt or Linux
 containers. If sandboxes are enabled, `chrome-devtools-mcp` is not able to start
 Chrome that requires permissions to create its own sandboxes. As a workaround,
 either disable sandboxing for `chrome-devtools-mcp` in your MCP client or use
-`--connect-url` to connect to a Chrome instance that you start manually outside
+`--browser-url` to connect to a Chrome instance that you start manually outside
 of the MCP client sandbox.

From 0129f7b6d16eedea915e8df88d3e01d2d866b04c Mon Sep 17 00:00:00 2001
From: iamitesh <84463539+iamitesh@users.noreply.github.com>
Date: Fri, 10 Oct 2025 12:52:16 +0530
Subject: [PATCH 24/44] feat: Add offline network emulation support to
 emulate_network command (#326)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/320
Issue:
It would be very useful to have the ability to simulate offline network
conditions directly through the MCP emulate_network command, similar to
how it's possible in DevTools.
Currently, the command doesn’t support an Offline state, which limits
testing for PWA and offline-first web applications. Adding this option
would make it easier to automate and validate offline behavior through
MCP scripts or tools that rely on this API.

Solution
- Add 'Offline' option to throttlingOptions for simulating offline
network conditions
- Update emulate_network tool to handle offline mode with proper network
conditions
- Update documentation to include offline option and usage instructions
- Add test coverage for offline network emulation functionality
- Enable testing of PWA and offline-first web applications through MCP
---
 docs/tool-reference.md        |  4 ++--
 package-lock.json             | 20 +++++++++-----------
 package.json                  |  5 +++--
 src/tools/emulation.ts        | 16 ++++++++++++++--
 tests/tools/emulation.test.ts | 15 +++++++++++++++
 5 files changed, 43 insertions(+), 17 deletions(-)

diff --git a/docs/tool-reference.md b/docs/tool-reference.md
index ad9410a2..070cd548 100644
--- a/docs/tool-reference.md
+++ b/docs/tool-reference.md
@@ -200,11 +200,11 @@
 
 ### `emulate_network`
 
-**Description:** Emulates network conditions such as throttling on the selected page.
+**Description:** Emulates network conditions such as throttling or offline mode on the selected page.
 
 **Parameters:**
 
-- **throttlingOption** (enum: "No emulation", "Slow 3G", "Fast 3G", "Slow 4G", "Fast 4G") **(required)**: The network throttling option to emulate. Available throttling options are: No emulation, Slow 3G, Fast 3G, Slow 4G, Fast 4G. Set to "No emulation" to disable.
+- **throttlingOption** (enum: "No emulation", "Offline", "Slow 3G", "Fast 3G", "Slow 4G", "Fast 4G") **(required)**: The network throttling option to emulate. Available throttling options are: No emulation, Offline, Slow 3G, Fast 3G, Slow 4G, Fast 4G. Set to "No emulation" to disable. Set to "Offline" to simulate offline network conditions.
 
 ---
 
diff --git a/package-lock.json b/package-lock.json
index 2435a3f2..77e6717d 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -12,8 +12,9 @@
         "@modelcontextprotocol/sdk": "1.19.1",
         "core-js": "3.45.1",
         "debug": "4.4.3",
-        "puppeteer-core": "24.23.0",
-        "yargs": "18.0.0"
+        "puppeteer-core": "^24.23.0",
+        "yargs": "18.0.0",
+        "zod": "^3.25.76"
       },
       "bin": {
         "chrome-devtools-mcp": "build/src/index.js"
@@ -4735,7 +4736,6 @@
       "version": "24.23.0",
       "resolved": "https://registry.npmjs.org/puppeteer-core/-/puppeteer-core-24.23.0.tgz",
       "integrity": "sha512-yl25C59gb14sOdIiSnJ08XiPP+O2RjuyZmEG+RjYmCXO7au0jcLf7fRiyii96dXGUBW7Zwei/mVKfxMx/POeFw==",
-      "license": "Apache-2.0",
       "dependencies": {
         "@puppeteer/browsers": "2.10.10",
         "chromium-bidi": "9.1.0",
@@ -6194,19 +6194,17 @@
       }
     },
     "node_modules/zod": {
-      "version": "3.24.3",
-      "resolved": "https://registry.npmjs.org/zod/-/zod-3.24.3.tgz",
-      "integrity": "sha512-HhY1oqzWCQWuUqvBFnsyrtZRhyPeR7SUGv+C4+MsisMuVfSPx8HpwWqH8tRahSlt6M3PiFAcoeFhZAqIXTxoSg==",
-      "license": "MIT",
+      "version": "3.25.76",
+      "resolved": "https://registry.npmjs.org/zod/-/zod-3.25.76.tgz",
+      "integrity": "sha512-gzUt/qt81nXsFGKIFcC3YnfEAx5NkunCfnDlvuBSSFS02bcXu4Lmea0AFIUwbLWxWPx3d9p8S5QoaujKcNQxcQ==",
       "funding": {
         "url": "https://github.com/sponsors/colinhacks"
       }
     },
     "node_modules/zod-to-json-schema": {
-      "version": "3.24.5",
-      "resolved": "https://registry.npmjs.org/zod-to-json-schema/-/zod-to-json-schema-3.24.5.tgz",
-      "integrity": "sha512-/AuWwMP+YqiPbsJx5D6TfgRTc4kTLjsh5SOcd4bLsfUg2RcEXrFMJl1DGgdHy2aCfsIA/cr/1JM0xcB2GZji8g==",
-      "license": "ISC",
+      "version": "3.24.6",
+      "resolved": "https://registry.npmjs.org/zod-to-json-schema/-/zod-to-json-schema-3.24.6.tgz",
+      "integrity": "sha512-h/z3PKvcTcTetyjl1fkj79MHNEjm+HpD6NXheWjzOekY7kV+lwDYnHw+ivHkijnCSMz1yJaWBD9vu/Fcmk+vEg==",
       "peerDependencies": {
         "zod": "^3.24.1"
       }
diff --git a/package.json b/package.json
index fe960cf4..807b8f44 100644
--- a/package.json
+++ b/package.json
@@ -40,8 +40,9 @@
     "@modelcontextprotocol/sdk": "1.19.1",
     "core-js": "3.45.1",
     "debug": "4.4.3",
-    "puppeteer-core": "24.23.0",
-    "yargs": "18.0.0"
+    "puppeteer-core": "^24.23.0",
+    "yargs": "18.0.0",
+    "zod": "^3.25.76"
   },
   "devDependencies": {
     "@eslint/js": "^9.35.0",
diff --git a/src/tools/emulation.ts b/src/tools/emulation.ts
index 9228c59b..92b949e9 100644
--- a/src/tools/emulation.ts
+++ b/src/tools/emulation.ts
@@ -12,12 +12,13 @@ import {defineTool} from './ToolDefinition.js';
 
 const throttlingOptions: [string, ...string[]] = [
   'No emulation',
+  'Offline',
   ...Object.keys(PredefinedNetworkConditions),
 ];
 
 export const emulateNetwork = defineTool({
   name: 'emulate_network',
-  description: `Emulates network conditions such as throttling on the selected page.`,
+  description: `Emulates network conditions such as throttling or offline mode on the selected page.`,
   annotations: {
     category: ToolCategories.EMULATION,
     readOnlyHint: false,
@@ -26,7 +27,7 @@ export const emulateNetwork = defineTool({
     throttlingOption: z
       .enum(throttlingOptions)
       .describe(
-        `The network throttling option to emulate. Available throttling options are: ${throttlingOptions.join(', ')}. Set to "No emulation" to disable.`,
+        `The network throttling option to emulate. Available throttling options are: ${throttlingOptions.join(', ')}. Set to "No emulation" to disable. Set to "Offline" to simulate offline network conditions.`,
       ),
   },
   handler: async (request, _response, context) => {
@@ -39,6 +40,17 @@ export const emulateNetwork = defineTool({
       return;
     }
 
+    if (conditions === 'Offline') {
+      await page.emulateNetworkConditions({
+        offline: true,
+        download: 0,
+        upload: 0,
+        latency: 0,
+      });
+      context.setNetworkConditions('Offline');
+      return;
+    }
+
     if (conditions in PredefinedNetworkConditions) {
       const networkCondition =
         PredefinedNetworkConditions[
diff --git a/tests/tools/emulation.test.ts b/tests/tools/emulation.test.ts
index 151a621b..0b64e484 100644
--- a/tests/tools/emulation.test.ts
+++ b/tests/tools/emulation.test.ts
@@ -11,6 +11,21 @@ import {withBrowser} from '../utils.js';
 
 describe('emulation', () => {
   describe('network', () => {
+    it('emulates offline network conditions', async () => {
+      await withBrowser(async (response, context) => {
+        await emulateNetwork.handler(
+          {
+            params: {
+              throttlingOption: 'Offline',
+            },
+          },
+          response,
+          context,
+        );
+
+        assert.strictEqual(context.getNetworkConditions(), 'Offline');
+      });
+    });
     it('emulates network throttling when the throttling option is valid ', async () => {
       await withBrowser(async (response, context) => {
         await emulateNetwork.handler(

From ffde28b59a032138f5a7e74addf6f6f3796ba494 Mon Sep 17 00:00:00 2001
From: Alex Rudenko <OrKoN@users.noreply.github.com>
Date: Fri, 10 Oct 2025 14:35:43 +0200
Subject: [PATCH 25/44] chore(deps): bump puppeteer (#331)

Includes fixes for Chrome installation detection on Windows and WSL
---
 package-lock.json | 43 ++++++++++++++++++++++---------------------
 package.json      |  4 ++--
 2 files changed, 24 insertions(+), 23 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 77e6717d..f30bb018 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -12,7 +12,7 @@
         "@modelcontextprotocol/sdk": "1.19.1",
         "core-js": "3.45.1",
         "debug": "4.4.3",
-        "puppeteer-core": "^24.23.0",
+        "puppeteer-core": "^24.23.1",
         "yargs": "18.0.0",
         "zod": "^3.25.76"
       },
@@ -35,7 +35,7 @@
         "eslint-plugin-import": "^2.32.0",
         "globals": "^16.4.0",
         "prettier": "^3.6.2",
-        "puppeteer": "24.23.0",
+        "puppeteer": "24.23.1",
         "sinon": "^21.0.0",
         "typescript": "^5.9.2",
         "typescript-eslint": "^8.43.0"
@@ -446,9 +446,9 @@
       }
     },
     "node_modules/@puppeteer/browsers": {
-      "version": "2.10.10",
-      "resolved": "https://registry.npmjs.org/@puppeteer/browsers/-/browsers-2.10.10.tgz",
-      "integrity": "sha512-3ZG500+ZeLql8rE0hjfhkycJjDj0pI/btEh3L9IkWUYcOrgP0xCNRq3HbtbqOPbvDhFaAWD88pDFtlLv8ns8gA==",
+      "version": "2.10.11",
+      "resolved": "https://registry.npmjs.org/@puppeteer/browsers/-/browsers-2.10.11.tgz",
+      "integrity": "sha512-kp3ORGce+oC3qUMJ+g5NH9W4Q7mMG7gV2I+alv0bCbfkZ36B2V/xKCg9uYavSgjmsElhwBneahWjJP7A6fuKLw==",
       "license": "Apache-2.0",
       "dependencies": {
         "debug": "^4.4.3",
@@ -456,7 +456,7 @@
         "progress": "^2.0.3",
         "proxy-agent": "^6.5.0",
         "semver": "^7.7.2",
-        "tar-fs": "^3.1.0",
+        "tar-fs": "^3.1.1",
         "yargs": "^17.7.2"
       },
       "bin": {
@@ -1502,9 +1502,9 @@
       }
     },
     "node_modules/b4a": {
-      "version": "1.7.2",
-      "resolved": "https://registry.npmjs.org/b4a/-/b4a-1.7.2.tgz",
-      "integrity": "sha512-DyUOdz+E8R6+sruDpQNOaV0y/dBbV6X/8ZkxrDcR0Ifc3BgKlpgG0VAtfOozA0eMtJO5GGe9FsZhueLs00pTww==",
+      "version": "1.7.3",
+      "resolved": "https://registry.npmjs.org/b4a/-/b4a-1.7.3.tgz",
+      "integrity": "sha512-5Q2mfq2WfGuFp3uS//0s6baOJLMoVduPYVeNmDYxu5OUA1/cBfvr2RIS7vi62LdNj/urk1hfmj867I3qt6uZ7Q==",
       "license": "Apache-2.0",
       "peerDependencies": {
         "react-native-b4a": "*"
@@ -1529,9 +1529,9 @@
       "license": "Apache-2.0"
     },
     "node_modules/bare-fs": {
-      "version": "4.4.4",
-      "resolved": "https://registry.npmjs.org/bare-fs/-/bare-fs-4.4.4.tgz",
-      "integrity": "sha512-Q8yxM1eLhJfuM7KXVP3zjhBvtMJCYRByoTT+wHXjpdMELv0xICFJX+1w4c7csa+WZEOsq4ItJ4RGwvzid6m/dw==",
+      "version": "4.4.9",
+      "resolved": "https://registry.npmjs.org/bare-fs/-/bare-fs-4.4.9.tgz",
+      "integrity": "sha512-sh8UV8OvXBZa3Yg5rhF1LNH3U4DfHniexdqyUXelC1thQUxO9TCF37yvd1/7Ir+cgeSg/6YrXyH67xvRr7yaOg==",
       "license": "Apache-2.0",
       "optional": true,
       "dependencies": {
@@ -4711,18 +4711,18 @@
       }
     },
     "node_modules/puppeteer": {
-      "version": "24.23.0",
-      "resolved": "https://registry.npmjs.org/puppeteer/-/puppeteer-24.23.0.tgz",
-      "integrity": "sha512-BVR1Lg8sJGKXY79JARdIssFWK2F6e1j+RyuJP66w4CUmpaXjENicmA3nNpUXA8lcTdDjAndtP+oNdni3T/qQqA==",
+      "version": "24.23.1",
+      "resolved": "https://registry.npmjs.org/puppeteer/-/puppeteer-24.23.1.tgz",
+      "integrity": "sha512-Az5+ufV/opJqgTaCdkJvE0ZeQ8Xgc57jjwkKKfNblyX6fO5w8a7V4+YRMA7jDEtDYF6XxOzG6q/tuqgEaBNEFQ==",
       "dev": true,
       "hasInstallScript": true,
       "license": "Apache-2.0",
       "dependencies": {
-        "@puppeteer/browsers": "2.10.10",
+        "@puppeteer/browsers": "2.10.11",
         "chromium-bidi": "9.1.0",
         "cosmiconfig": "^9.0.0",
         "devtools-protocol": "0.0.1508733",
-        "puppeteer-core": "24.23.0",
+        "puppeteer-core": "24.23.1",
         "typed-query-selector": "^2.12.0"
       },
       "bin": {
@@ -4733,11 +4733,12 @@
       }
     },
     "node_modules/puppeteer-core": {
-      "version": "24.23.0",
-      "resolved": "https://registry.npmjs.org/puppeteer-core/-/puppeteer-core-24.23.0.tgz",
-      "integrity": "sha512-yl25C59gb14sOdIiSnJ08XiPP+O2RjuyZmEG+RjYmCXO7au0jcLf7fRiyii96dXGUBW7Zwei/mVKfxMx/POeFw==",
+      "version": "24.23.1",
+      "resolved": "https://registry.npmjs.org/puppeteer-core/-/puppeteer-core-24.23.1.tgz",
+      "integrity": "sha512-TH7YjTj5pjwM0hicDSqIYBFgHCJqPO+zWS/iaoKrlIfKOERJBtEc0kHCTTPRy0FoGrMYqYlIUL3WJZG0h5NOPQ==",
+      "license": "Apache-2.0",
       "dependencies": {
-        "@puppeteer/browsers": "2.10.10",
+        "@puppeteer/browsers": "2.10.11",
         "chromium-bidi": "9.1.0",
         "debug": "^4.4.3",
         "devtools-protocol": "0.0.1508733",
diff --git a/package.json b/package.json
index 807b8f44..9fd6a155 100644
--- a/package.json
+++ b/package.json
@@ -40,7 +40,7 @@
     "@modelcontextprotocol/sdk": "1.19.1",
     "core-js": "3.45.1",
     "debug": "4.4.3",
-    "puppeteer-core": "^24.23.0",
+    "puppeteer-core": "^24.23.1",
     "yargs": "18.0.0",
     "zod": "^3.25.76"
   },
@@ -60,7 +60,7 @@
     "eslint-plugin-import": "^2.32.0",
     "globals": "^16.4.0",
     "prettier": "^3.6.2",
-    "puppeteer": "24.23.0",
+    "puppeteer": "24.23.1",
     "sinon": "^21.0.0",
     "typescript": "^5.9.2",
     "typescript-eslint": "^8.43.0"

From adebb8f1517d38f86251df01b93ae8dde9b44868 Mon Sep 17 00:00:00 2001
From: zyzyzyryxy <31672205+zyzyzyryxy@users.noreply.github.com>
Date: Fri, 10 Oct 2025 14:46:35 +0200
Subject: [PATCH 26/44] docs: Add note on node version when building (#333)

I heard several people had issues installing the project locally due to
not noticing the difference between node version required to run vs to
build the project. This improvement aims at helping in those cases and
hopefully preventing small waste of time.

Co-authored-by: Piotr Paulski <piotrpaulski@chromium.org>
---
 CONTRIBUTING.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index cad5d3ef..cea89123 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -39,6 +39,8 @@ for PR and commit titles.
 
 ## Installation
 
+Check that you are using node version specified in .nvmrc, then run following commands:
+
 ```sh
 git clone https://github.com/ChromeDevTools/chrome-devtools-mcp.git
 cd chrome-devtools-mcp

From 8b14d56550a5784f76541b5158ac4eb92a700001 Mon Sep 17 00:00:00 2001
From: Jack Franklin <jacktfranklin@google.com>
Date: Fri, 10 Oct 2025 13:52:16 +0100
Subject: [PATCH 27/44] fix: ordering of information in performance trace
 summary (#334)

Fixes a bug where the output contained "this is a high level summary"
before then outputting the call frame / network format information
before then outputting the trace summary.

With this commit, we now output the summary & insights before ending
with the format information.
---
 src/tools/performance.ts                      |  3 -
 src/trace-processing/parse.ts                 | 12 +--
 tests/tools/performance.test.js.snapshot      | 90 +++++++++----------
 tests/trace-processing/parse.test.js.snapshot | 89 +++++++++---------
 4 files changed, 97 insertions(+), 97 deletions(-)

diff --git a/src/tools/performance.ts b/src/tools/performance.ts
index c9de76f7..9a6a3b95 100644
--- a/src/tools/performance.ts
+++ b/src/tools/performance.ts
@@ -167,9 +167,6 @@ async function stopTracingAndAppendOutput(
     response.appendResponseLine('The performance trace has been stopped.');
     if (traceResultIsSuccess(result)) {
       context.storeTraceRecording(result);
-      response.appendResponseLine(
-        'Here is a high level summary of the trace and the Insights that were found:',
-      );
       const traceSummaryText = getTraceSummary(result);
       response.appendResponseLine(traceSummaryText);
     } else {
diff --git a/src/trace-processing/parse.ts b/src/trace-processing/parse.ts
index d2932fed..2b0f523f 100644
--- a/src/trace-processing/parse.ts
+++ b/src/trace-processing/parse.ts
@@ -77,15 +77,17 @@ const extraFormatDescriptions = `Information on performance traces may contain m
 
 ${PerformanceTraceFormatter.callFrameDataFormatDescription}
 
-${PerformanceTraceFormatter.networkDataFormatDescription}
-`;
+${PerformanceTraceFormatter.networkDataFormatDescription}`;
+
 export function getTraceSummary(result: TraceResult): string {
   const focus = AgentFocus.fromParsedTrace(result.parsedTrace);
   const formatter = new PerformanceTraceFormatter(focus);
-  const output = formatter.formatTraceSummary();
-  return `${extraFormatDescriptions}
+  const summaryText = formatter.formatTraceSummary();
+  return `## Summary of Performance trace findings:
+${summaryText}
 
-${output}`;
+## Details on call tree & network request formats:
+${extraFormatDescriptions}`;
 }
 
 export type InsightName = keyof TraceEngine.Insights.Types.InsightModels;
diff --git a/tests/tools/performance.test.js.snapshot b/tests/tools/performance.test.js.snapshot
index 071909f4..ba704151 100644
--- a/tests/tools/performance.test.js.snapshot
+++ b/tests/tools/performance.test.js.snapshot
@@ -50,7 +50,51 @@ No buffer was provided.
 
 exports[`performance > performance_stop_trace > returns the high level summary of the performance trace 1`] = `
 The performance trace has been stopped.
-Here is a high level summary of the trace and the Insights that were found:
+## Summary of Performance trace findings:
+URL: https://web.dev/
+Bounds: {min: 122410994891, max: 122416385853}
+CPU throttling: none
+Network throttling: none
+Metrics (lab / observed):
+  - LCP: 129 ms, event: (eventKey: r-6063, ts: 122411126100), nodeId: 7
+  - LCP breakdown:
+    - TTFB: 8 ms, bounds: {min: 122410996889, max: 122411004828}
+    - Load delay: 33 ms, bounds: {min: 122411004828, max: 122411037986}
+    - Load duration: 15 ms, bounds: {min: 122411037986, max: 122411052690}
+    - Render delay: 73 ms, bounds: {min: 122411052690, max: 122411126100}
+  - CLS: 0.00
+Metrics (field / real users): n/a – no data for this page in CrUX
+Available insights:
+  - insight name: LCPBreakdown
+    description: Each [subpart has specific improvement strategies](https://web.dev/articles/optimize-lcp#lcp-breakdown). Ideally, most of the LCP time should be spent on loading the resources, not within delays.
+    relevant trace bounds: {min: 122410996889, max: 122411126100}
+    example question: Help me optimize my LCP score
+    example question: Which LCP phase was most problematic?
+    example question: What can I do to reduce the LCP time for this page load?
+  - insight name: LCPDiscovery
+    description: Optimize LCP by making the LCP image [discoverable](https://web.dev/articles/optimize-lcp#1_eliminate_resource_load_delay) from the HTML immediately, and [avoiding lazy-loading](https://web.dev/articles/lcp-lazy-loading)
+    relevant trace bounds: {min: 122411004828, max: 122411055039}
+    example question: Suggest fixes to reduce my LCP
+    example question: What can I do to reduce my LCP discovery time?
+    example question: Why is LCP discovery time important?
+  - insight name: RenderBlocking
+    description: Requests are blocking the page's initial render, which may delay LCP. [Deferring or inlining](https://web.dev/learn/performance/understanding-the-critical-path#render-blocking_resources) can move these network requests out of the critical path.
+    relevant trace bounds: {min: 122411037528, max: 122411053852}
+    example question: Show me the most impactful render blocking requests that I should focus on
+    example question: How can I reduce the number of render blocking requests?
+  - insight name: DocumentLatency
+    description: Your first network request is the most important.  Reduce its latency by avoiding redirects, ensuring a fast server response, and enabling text compression.
+    relevant trace bounds: {min: 122410998910, max: 122411043781}
+    estimated metric savings: FCP 0 ms, LCP 0 ms
+    estimated wasted bytes: 77.1 kB
+    example question: How do I decrease the initial loading time of my page?
+    example question: Did anything slow down the request for this document?
+  - insight name: ThirdParties
+    description: 3rd party code can significantly impact load performance. [Reduce and defer loading of 3rd party code](https://web.dev/articles/optimizing-content-efficiency-loading-third-party-javascript/) to prioritize your page's content.
+    relevant trace bounds: {min: 122411037881, max: 122416229595}
+    example question: Which third parties are having the largest impact on my page performance?
+
+## Details on call tree & network request formats:
 Information on performance traces may contain main thread activity represented as call frames and network requests.
 
 Each call frame is presented in the following format:
@@ -105,48 +149,4 @@ Durations (all in milliseconds):
 - \`responseHeaders\`: A list (separated by '|') of values for specific, pre-defined response headers, enclosed in square brackets.
 The order of headers corresponds to an internal fixed list. If a header is not present, its value will be empty.
 
-
-
-URL: https://web.dev/
-Bounds: {min: 122410994891, max: 122416385853}
-CPU throttling: none
-Network throttling: none
-Metrics (lab / observed):
-  - LCP: 129 ms, event: (eventKey: r-6063, ts: 122411126100), nodeId: 7
-  - LCP breakdown:
-    - TTFB: 8 ms, bounds: {min: 122410996889, max: 122411004828}
-    - Load delay: 33 ms, bounds: {min: 122411004828, max: 122411037986}
-    - Load duration: 15 ms, bounds: {min: 122411037986, max: 122411052690}
-    - Render delay: 73 ms, bounds: {min: 122411052690, max: 122411126100}
-  - CLS: 0.00
-Metrics (field / real users): n/a – no data for this page in CrUX
-Available insights:
-  - insight name: LCPBreakdown
-    description: Each [subpart has specific improvement strategies](https://web.dev/articles/optimize-lcp#lcp-breakdown). Ideally, most of the LCP time should be spent on loading the resources, not within delays.
-    relevant trace bounds: {min: 122410996889, max: 122411126100}
-    example question: Help me optimize my LCP score
-    example question: Which LCP phase was most problematic?
-    example question: What can I do to reduce the LCP time for this page load?
-  - insight name: LCPDiscovery
-    description: Optimize LCP by making the LCP image [discoverable](https://web.dev/articles/optimize-lcp#1_eliminate_resource_load_delay) from the HTML immediately, and [avoiding lazy-loading](https://web.dev/articles/lcp-lazy-loading)
-    relevant trace bounds: {min: 122411004828, max: 122411055039}
-    example question: Suggest fixes to reduce my LCP
-    example question: What can I do to reduce my LCP discovery time?
-    example question: Why is LCP discovery time important?
-  - insight name: RenderBlocking
-    description: Requests are blocking the page's initial render, which may delay LCP. [Deferring or inlining](https://web.dev/learn/performance/understanding-the-critical-path#render-blocking_resources) can move these network requests out of the critical path.
-    relevant trace bounds: {min: 122411037528, max: 122411053852}
-    example question: Show me the most impactful render blocking requests that I should focus on
-    example question: How can I reduce the number of render blocking requests?
-  - insight name: DocumentLatency
-    description: Your first network request is the most important.  Reduce its latency by avoiding redirects, ensuring a fast server response, and enabling text compression.
-    relevant trace bounds: {min: 122410998910, max: 122411043781}
-    estimated metric savings: FCP 0 ms, LCP 0 ms
-    estimated wasted bytes: 77.1 kB
-    example question: How do I decrease the initial loading time of my page?
-    example question: Did anything slow down the request for this document?
-  - insight name: ThirdParties
-    description: 3rd party code can significantly impact load performance. [Reduce and defer loading of 3rd party code](https://web.dev/articles/optimizing-content-efficiency-loading-third-party-javascript/) to prioritize your page's content.
-    relevant trace bounds: {min: 122411037881, max: 122416229595}
-    example question: Which third parties are having the largest impact on my page performance?
 `;
diff --git a/tests/trace-processing/parse.test.js.snapshot b/tests/trace-processing/parse.test.js.snapshot
index 5ce7918f..815206d5 100644
--- a/tests/trace-processing/parse.test.js.snapshot
+++ b/tests/trace-processing/parse.test.js.snapshot
@@ -1,4 +1,49 @@
 exports[`Trace parsing > can format results of a trace 1`] = `
+## Summary of Performance trace findings:
+URL: https://web.dev/
+Bounds: {min: 122410994891, max: 122416385853}
+CPU throttling: none
+Network throttling: none
+Metrics (lab / observed):
+  - LCP: 129 ms, event: (eventKey: r-6063, ts: 122411126100), nodeId: 7
+  - LCP breakdown:
+    - TTFB: 8 ms, bounds: {min: 122410996889, max: 122411004828}
+    - Load delay: 33 ms, bounds: {min: 122411004828, max: 122411037986}
+    - Load duration: 15 ms, bounds: {min: 122411037986, max: 122411052690}
+    - Render delay: 73 ms, bounds: {min: 122411052690, max: 122411126100}
+  - CLS: 0.00
+Metrics (field / real users): n/a – no data for this page in CrUX
+Available insights:
+  - insight name: LCPBreakdown
+    description: Each [subpart has specific improvement strategies](https://web.dev/articles/optimize-lcp#lcp-breakdown). Ideally, most of the LCP time should be spent on loading the resources, not within delays.
+    relevant trace bounds: {min: 122410996889, max: 122411126100}
+    example question: Help me optimize my LCP score
+    example question: Which LCP phase was most problematic?
+    example question: What can I do to reduce the LCP time for this page load?
+  - insight name: LCPDiscovery
+    description: Optimize LCP by making the LCP image [discoverable](https://web.dev/articles/optimize-lcp#1_eliminate_resource_load_delay) from the HTML immediately, and [avoiding lazy-loading](https://web.dev/articles/lcp-lazy-loading)
+    relevant trace bounds: {min: 122411004828, max: 122411055039}
+    example question: Suggest fixes to reduce my LCP
+    example question: What can I do to reduce my LCP discovery time?
+    example question: Why is LCP discovery time important?
+  - insight name: RenderBlocking
+    description: Requests are blocking the page's initial render, which may delay LCP. [Deferring or inlining](https://web.dev/learn/performance/understanding-the-critical-path#render-blocking_resources) can move these network requests out of the critical path.
+    relevant trace bounds: {min: 122411037528, max: 122411053852}
+    example question: Show me the most impactful render blocking requests that I should focus on
+    example question: How can I reduce the number of render blocking requests?
+  - insight name: DocumentLatency
+    description: Your first network request is the most important.  Reduce its latency by avoiding redirects, ensuring a fast server response, and enabling text compression.
+    relevant trace bounds: {min: 122410998910, max: 122411043781}
+    estimated metric savings: FCP 0 ms, LCP 0 ms
+    estimated wasted bytes: 77.1 kB
+    example question: How do I decrease the initial loading time of my page?
+    example question: Did anything slow down the request for this document?
+  - insight name: ThirdParties
+    description: 3rd party code can significantly impact load performance. [Reduce and defer loading of 3rd party code](https://web.dev/articles/optimizing-content-efficiency-loading-third-party-javascript/) to prioritize your page's content.
+    relevant trace bounds: {min: 122411037881, max: 122416229595}
+    example question: Which third parties are having the largest impact on my page performance?
+
+## Details on call tree & network request formats:
 Information on performance traces may contain main thread activity represented as call frames and network requests.
 
 Each call frame is presented in the following format:
@@ -53,48 +98,4 @@ Durations (all in milliseconds):
 - \`responseHeaders\`: A list (separated by '|') of values for specific, pre-defined response headers, enclosed in square brackets.
 The order of headers corresponds to an internal fixed list. If a header is not present, its value will be empty.
 
-
-
-URL: https://web.dev/
-Bounds: {min: 122410994891, max: 122416385853}
-CPU throttling: none
-Network throttling: none
-Metrics (lab / observed):
-  - LCP: 129 ms, event: (eventKey: r-6063, ts: 122411126100), nodeId: 7
-  - LCP breakdown:
-    - TTFB: 8 ms, bounds: {min: 122410996889, max: 122411004828}
-    - Load delay: 33 ms, bounds: {min: 122411004828, max: 122411037986}
-    - Load duration: 15 ms, bounds: {min: 122411037986, max: 122411052690}
-    - Render delay: 73 ms, bounds: {min: 122411052690, max: 122411126100}
-  - CLS: 0.00
-Metrics (field / real users): n/a – no data for this page in CrUX
-Available insights:
-  - insight name: LCPBreakdown
-    description: Each [subpart has specific improvement strategies](https://web.dev/articles/optimize-lcp#lcp-breakdown). Ideally, most of the LCP time should be spent on loading the resources, not within delays.
-    relevant trace bounds: {min: 122410996889, max: 122411126100}
-    example question: Help me optimize my LCP score
-    example question: Which LCP phase was most problematic?
-    example question: What can I do to reduce the LCP time for this page load?
-  - insight name: LCPDiscovery
-    description: Optimize LCP by making the LCP image [discoverable](https://web.dev/articles/optimize-lcp#1_eliminate_resource_load_delay) from the HTML immediately, and [avoiding lazy-loading](https://web.dev/articles/lcp-lazy-loading)
-    relevant trace bounds: {min: 122411004828, max: 122411055039}
-    example question: Suggest fixes to reduce my LCP
-    example question: What can I do to reduce my LCP discovery time?
-    example question: Why is LCP discovery time important?
-  - insight name: RenderBlocking
-    description: Requests are blocking the page's initial render, which may delay LCP. [Deferring or inlining](https://web.dev/learn/performance/understanding-the-critical-path#render-blocking_resources) can move these network requests out of the critical path.
-    relevant trace bounds: {min: 122411037528, max: 122411053852}
-    example question: Show me the most impactful render blocking requests that I should focus on
-    example question: How can I reduce the number of render blocking requests?
-  - insight name: DocumentLatency
-    description: Your first network request is the most important.  Reduce its latency by avoiding redirects, ensuring a fast server response, and enabling text compression.
-    relevant trace bounds: {min: 122410998910, max: 122411043781}
-    estimated metric savings: FCP 0 ms, LCP 0 ms
-    estimated wasted bytes: 77.1 kB
-    example question: How do I decrease the initial loading time of my page?
-    example question: Did anything slow down the request for this document?
-  - insight name: ThirdParties
-    description: 3rd party code can significantly impact load performance. [Reduce and defer loading of 3rd party code](https://web.dev/articles/optimizing-content-efficiency-loading-third-party-javascript/) to prioritize your page's content.
-    relevant trace bounds: {min: 122411037881, max: 122416229595}
-    example question: Which third parties are having the largest impact on my page performance?
 `;

From 847c8ecd5fde1270fba812108416ee6f2f9494a2 Mon Sep 17 00:00:00 2001
From: browser-automation-bot
 <133232582+browser-automation-bot@users.noreply.github.com>
Date: Fri, 10 Oct 2025 15:22:23 +0200
Subject: [PATCH 28/44] chore(main): release chrome-devtools-mcp 0.7.0 (#308)

:robot: I have created a release *beep* *boop*
---


##
[0.7.0](https://github.com/ChromeDevTools/chrome-devtools-mcp/compare/chrome-devtools-mcp-v0.6.1...chrome-devtools-mcp-v0.7.0)
(2025-10-10)


### Features

* Add offline network emulation support to emulate_network command
([#326](https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/326))
([139ce60](https://github.com/ChromeDevTools/chrome-devtools-mcp/commit/139ce607814bf25ba541a7264ce96a04b2fac871))
* add request and response body
([#267](https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/267))
([dd3c143](https://github.com/ChromeDevTools/chrome-devtools-mcp/commit/dd3c14336ee44d057d06231a5bfd5c5bcf661029))


### Bug Fixes

* ordering of information in performance trace summary
([#334](https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/334))
([2d4484a](https://github.com/ChromeDevTools/chrome-devtools-mcp/commit/2d4484a123968754b4840d112b9c1ca59fb29997))
* publishing to MCP registry
([#313](https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/313))
([1faec78](https://github.com/ChromeDevTools/chrome-devtools-mcp/commit/1faec78f84569a03f63585fb84df35992bcfe81a))
* use default ProtocolTimeout
([#315](https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/315))
([a525f19](https://github.com/ChromeDevTools/chrome-devtools-mcp/commit/a525f199458afb266db4540bf0fa8007323f3301))

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).
---
 .release-please-manifest.json |  2 +-
 CHANGELOG.md                  | 15 +++++++++++++++
 package-lock.json             |  4 ++--
 package.json                  |  2 +-
 4 files changed, 19 insertions(+), 4 deletions(-)

diff --git a/.release-please-manifest.json b/.release-please-manifest.json
index 5d02000a..e7ca6139 100644
--- a/.release-please-manifest.json
+++ b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "0.6.1"
+  ".": "0.7.0"
 }
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 3b88b615..7a258aa9 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,20 @@
 # Changelog
 
+## [0.7.0](https://github.com/ChromeDevTools/chrome-devtools-mcp/compare/chrome-devtools-mcp-v0.6.1...chrome-devtools-mcp-v0.7.0) (2025-10-10)
+
+
+### Features
+
+* Add offline network emulation support to emulate_network command ([#326](https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/326)) ([139ce60](https://github.com/ChromeDevTools/chrome-devtools-mcp/commit/139ce607814bf25ba541a7264ce96a04b2fac871))
+* add request and response body ([#267](https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/267)) ([dd3c143](https://github.com/ChromeDevTools/chrome-devtools-mcp/commit/dd3c14336ee44d057d06231a5bfd5c5bcf661029))
+
+
+### Bug Fixes
+
+* ordering of information in performance trace summary ([#334](https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/334)) ([2d4484a](https://github.com/ChromeDevTools/chrome-devtools-mcp/commit/2d4484a123968754b4840d112b9c1ca59fb29997))
+* publishing to MCP registry ([#313](https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/313)) ([1faec78](https://github.com/ChromeDevTools/chrome-devtools-mcp/commit/1faec78f84569a03f63585fb84df35992bcfe81a))
+* use default ProtocolTimeout ([#315](https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/315)) ([a525f19](https://github.com/ChromeDevTools/chrome-devtools-mcp/commit/a525f199458afb266db4540bf0fa8007323f3301))
+
 ## [0.6.1](https://github.com/ChromeDevTools/chrome-devtools-mcp/compare/chrome-devtools-mcp-v0.6.0...chrome-devtools-mcp-v0.6.1) (2025-10-07)
 
 
diff --git a/package-lock.json b/package-lock.json
index f30bb018..856eea68 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "chrome-devtools-mcp",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "chrome-devtools-mcp",
-      "version": "0.6.1",
+      "version": "0.7.0",
       "license": "Apache-2.0",
       "dependencies": {
         "@modelcontextprotocol/sdk": "1.19.1",
diff --git a/package.json b/package.json
index 9fd6a155..8beafbf3 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "chrome-devtools-mcp",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "description": "MCP server for Chrome DevTools",
   "type": "module",
   "bin": "./build/src/index.js",

From 28f2e79a4035e7da3d06344bffd13c4586916786 Mon Sep 17 00:00:00 2001
From: Alex Rudenko <OrKoN@users.noreply.github.com>
Date: Fri, 10 Oct 2025 15:46:58 +0200
Subject: [PATCH 29/44] chore(deps): bump pptr (#336)

Includes improvements for DevTools.
---
 package-lock.json | 34 +++++++++++++++++++++-------------
 package.json      |  4 ++--
 2 files changed, 23 insertions(+), 15 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 856eea68..1bfd3e7a 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -12,7 +12,7 @@
         "@modelcontextprotocol/sdk": "1.19.1",
         "core-js": "3.45.1",
         "debug": "4.4.3",
-        "puppeteer-core": "^24.23.1",
+        "puppeteer-core": "^24.24.0",
         "yargs": "18.0.0",
         "zod": "^3.25.76"
       },
@@ -35,7 +35,7 @@
         "eslint-plugin-import": "^2.32.0",
         "globals": "^16.4.0",
         "prettier": "^3.6.2",
-        "puppeteer": "24.23.1",
+        "puppeteer": "24.24.0",
         "sinon": "^21.0.0",
         "typescript": "^5.9.2",
         "typescript-eslint": "^8.43.0"
@@ -1523,10 +1523,18 @@
       "license": "MIT"
     },
     "node_modules/bare-events": {
-      "version": "2.7.0",
-      "resolved": "https://registry.npmjs.org/bare-events/-/bare-events-2.7.0.tgz",
-      "integrity": "sha512-b3N5eTW1g7vXkw+0CXh/HazGTcO5KYuu/RCNaJbDMPI6LHDi+7qe8EmxKUVe1sUbY2KZOVZFyj62x0OEz9qyAA==",
-      "license": "Apache-2.0"
+      "version": "2.8.0",
+      "resolved": "https://registry.npmjs.org/bare-events/-/bare-events-2.8.0.tgz",
+      "integrity": "sha512-AOhh6Bg5QmFIXdViHbMc2tLDsBIRxdkIaIddPslJF9Z5De3APBScuqGP2uThXnIpqFrgoxMNC6km7uXNIMLHXA==",
+      "license": "Apache-2.0",
+      "peerDependencies": {
+        "bare-abort-controller": "*"
+      },
+      "peerDependenciesMeta": {
+        "bare-abort-controller": {
+          "optional": true
+        }
+      }
     },
     "node_modules/bare-fs": {
       "version": "4.4.9",
@@ -4711,9 +4719,9 @@
       }
     },
     "node_modules/puppeteer": {
-      "version": "24.23.1",
-      "resolved": "https://registry.npmjs.org/puppeteer/-/puppeteer-24.23.1.tgz",
-      "integrity": "sha512-Az5+ufV/opJqgTaCdkJvE0ZeQ8Xgc57jjwkKKfNblyX6fO5w8a7V4+YRMA7jDEtDYF6XxOzG6q/tuqgEaBNEFQ==",
+      "version": "24.24.0",
+      "resolved": "https://registry.npmjs.org/puppeteer/-/puppeteer-24.24.0.tgz",
+      "integrity": "sha512-jRn6T8rSrQZXIplXICpH2zYJ2XrIFY7Ug0+TxRTuwY8ZTL7+MKDvFH0aLG7Xx3ts4twzxIKZmiYo+qg7whNpZw==",
       "dev": true,
       "hasInstallScript": true,
       "license": "Apache-2.0",
@@ -4722,7 +4730,7 @@
         "chromium-bidi": "9.1.0",
         "cosmiconfig": "^9.0.0",
         "devtools-protocol": "0.0.1508733",
-        "puppeteer-core": "24.23.1",
+        "puppeteer-core": "24.24.0",
         "typed-query-selector": "^2.12.0"
       },
       "bin": {
@@ -4733,9 +4741,9 @@
       }
     },
     "node_modules/puppeteer-core": {
-      "version": "24.23.1",
-      "resolved": "https://registry.npmjs.org/puppeteer-core/-/puppeteer-core-24.23.1.tgz",
-      "integrity": "sha512-TH7YjTj5pjwM0hicDSqIYBFgHCJqPO+zWS/iaoKrlIfKOERJBtEc0kHCTTPRy0FoGrMYqYlIUL3WJZG0h5NOPQ==",
+      "version": "24.24.0",
+      "resolved": "https://registry.npmjs.org/puppeteer-core/-/puppeteer-core-24.24.0.tgz",
+      "integrity": "sha512-RR5AeQ6dIbSepDe9PTtfgK1fgD7TuA9qqyGxPbFCyGfvfkbR7MiqNYdE7AhbTaFIqG3hFBtWwbVKVZF8oEqj7Q==",
       "license": "Apache-2.0",
       "dependencies": {
         "@puppeteer/browsers": "2.10.11",
diff --git a/package.json b/package.json
index 8beafbf3..dbc40a16 100644
--- a/package.json
+++ b/package.json
@@ -40,7 +40,7 @@
     "@modelcontextprotocol/sdk": "1.19.1",
     "core-js": "3.45.1",
     "debug": "4.4.3",
-    "puppeteer-core": "^24.23.1",
+    "puppeteer-core": "^24.24.0",
     "yargs": "18.0.0",
     "zod": "^3.25.76"
   },
@@ -60,7 +60,7 @@
     "eslint-plugin-import": "^2.32.0",
     "globals": "^16.4.0",
     "prettier": "^3.6.2",
-    "puppeteer": "24.23.1",
+    "puppeteer": "24.24.0",
     "sinon": "^21.0.0",
     "typescript": "^5.9.2",
     "typescript-eslint": "^8.43.0"

From 1a64686aad2361f356ac7be33dacf60a8c96a3b6 Mon Sep 17 00:00:00 2001
From: Alex Rudenko <OrKoN@users.noreply.github.com>
Date: Fri, 10 Oct 2025 15:51:36 +0200
Subject: [PATCH 30/44] fix: document that console and requests are since the
 last nav (#335)

Closes https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/240
---
 docs/tool-reference.md | 4 ++--
 src/tools/console.ts   | 3 ++-
 src/tools/network.ts   | 2 +-
 3 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/docs/tool-reference.md b/docs/tool-reference.md
index 070cd548..be12f101 100644
--- a/docs/tool-reference.md
+++ b/docs/tool-reference.md
@@ -264,7 +264,7 @@
 
 ### `list_network_requests`
 
-**Description:** List all requests for the currently selected page
+**Description:** List all requests for the currently selected page since the last navigation.
 
 **Parameters:**
 
@@ -298,7 +298,7 @@ so returned values have to JSON-serializable.
 
 ### `list_console_messages`
 
-**Description:** List all console messages for the currently selected page
+**Description:** List all console messages for the currently selected page since the last navigation.
 
 **Parameters:** None
 
diff --git a/src/tools/console.ts b/src/tools/console.ts
index 9a3ff114..4fb752f2 100644
--- a/src/tools/console.ts
+++ b/src/tools/console.ts
@@ -9,7 +9,8 @@ import {defineTool} from './ToolDefinition.js';
 
 export const consoleTool = defineTool({
   name: 'list_console_messages',
-  description: 'List all console messages for the currently selected page',
+  description:
+    'List all console messages for the currently selected page since the last navigation.',
   annotations: {
     category: ToolCategories.DEBUGGING,
     readOnlyHint: true,
diff --git a/src/tools/network.ts b/src/tools/network.ts
index 5943b0f5..1fc82a5a 100644
--- a/src/tools/network.ts
+++ b/src/tools/network.ts
@@ -34,7 +34,7 @@ const FILTERABLE_RESOURCE_TYPES: readonly [ResourceType, ...ResourceType[]] = [
 
 export const listNetworkRequests = defineTool({
   name: 'list_network_requests',
-  description: `List all requests for the currently selected page`,
+  description: `List all requests for the currently selected page since the last navigation.`,
   annotations: {
     category: ToolCategories.NETWORK,
     readOnlyHint: true,

From 5062e9da30bde48ffe36f0693674b9c510a342de Mon Sep 17 00:00:00 2001
From: Michael Hablich <natorion@users.noreply.github.com>
Date: Fri, 10 Oct 2025 16:09:39 +0200
Subject: [PATCH 31/44] docs: Add step-by-step guide for connecting to running
 Chrome instance (#140) (#330)

---
 README.md | 63 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 63 insertions(+)

diff --git a/README.md b/README.md
index 032afd8e..4c5e7a50 100644
--- a/README.md
+++ b/README.md
@@ -328,6 +328,69 @@ all instances of `chrome-devtools-mcp`. Set the `isolated` option to `true`
 to use a temporary user data dir instead which will be cleared automatically after
 the browser is closed.
 
+### Connecting to a running Chrome instance
+
+You can connect to a running Chrome instance by using the `--browser-url` option. This is useful if you want to use your existing Chrome profile or if you are running the MCP server in a sandboxed environment that does not allow starting a new Chrome instance.
+
+Here is a step-by-step guide on how to connect to a running Chrome Stable instance:
+
+**Step 1: Configure the MCP client**
+
+Add the `--browser-url` option to your MCP client configuration. The value of this option should be the URL of the running Chrome instance. `http://localhost:9222` is a common default.
+
+```json
+{
+  "mcpServers": {
+    "chrome-devtools": {
+      "command": "npx",
+      "args": [
+        "chrome-devtools-mcp@latest",
+        "--browser-url=http://localhost:9222"
+      ]
+    }
+  }
+}
+```
+
+**Step 2: Start the Chrome browser**
+
+> [!WARNING]  
+> Enabling the remote debugging port opens up a debugging port on the running browser instance. Any application on your machine can connect to this port and control the browser. Make sure that you are not browsing any sensitive websites while the debugging port is open.
+
+Start the Chrome browser with the remote debugging port enabled. Make sure to close any running Chrome instances before starting a new one with the debugging port enabled. The port number you choose must be the same as the one you specified in the `--browser-url` option in your MCP client configuration.
+
+For security reasons, [Chrome requires you to use a non-default user data directory](https://developer.chrome.com/blog/remote-debugging-port) when enabling the remote debugging port. You can specify a custom directory using the `--user-data-dir` flag. This ensures that your regular browsing profile and data are not exposed to the debugging session.
+
+**macOS**
+
+```bash
+/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-profile-stable
+```
+
+**Linux**
+
+```bash
+/usr/bin/google-chrome --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-profile-stable
+```
+
+**Windows**
+
+```bash
+"C:\Program Files\Google\Chrome\Application\chrome.exe" --remote-debugging-port=9222 --user-data-dir="%TEMP%\chrome-profile-stable"
+```
+
+**Step 3: Test your setup**
+
+After configuring the MCP client and starting the Chrome browser, you can test your setup by running a simple prompt in your MCP client:
+
+```
+Check the performance of https://developers.chrome.com
+```
+
+Your MCP client should connect to the running Chrome instance and receive a performance report.
+
+For more details on remote debugging, see the [Chrome DevTools documentation](https://developer.chrome.com/docs/devtools/remote-debugging/).
+
 ## Known limitations
 
 ### Operating system sandboxes

From a0d960954a42a4c133ea27283649cb5731f80e52 Mon Sep 17 00:00:00 2001
From: Alex Rudenko <OrKoN@users.noreply.github.com>
Date: Fri, 10 Oct 2025 16:17:00 +0200
Subject: [PATCH 32/44] chore: experimental devtools-on-devtools support (#51)

Allows using the MCP server for the devtools development.
---
 src/browser.ts        | 54 +++++++++++++++++++++++++------------------
 src/cli.ts            |  5 ++++
 src/main.ts           | 10 +++++++-
 tests/browser.test.ts |  3 +++
 4 files changed, 48 insertions(+), 24 deletions(-)

diff --git a/src/browser.ts b/src/browser.ts
index 083e9c09..b0a7aaa5 100644
--- a/src/browser.ts
+++ b/src/browser.ts
@@ -11,7 +11,6 @@ import path from 'node:path';
 import type {
   Browser,
   ChromeReleaseChannel,
-  ConnectOptions,
   LaunchOptions,
   Target,
 } from 'puppeteer-core';
@@ -19,37 +18,41 @@ import puppeteer from 'puppeteer-core';
 
 let browser: Browser | undefined;
 
-const ignoredPrefixes = new Set([
-  'chrome://',
-  'chrome-extension://',
-  'chrome-untrusted://',
-  'devtools://',
-]);
+function makeTargetFilter(devtools: boolean) {
+  const ignoredPrefixes = new Set([
+    'chrome://',
+    'chrome-extension://',
+    'chrome-untrusted://',
+  ]);
 
-function targetFilter(target: Target): boolean {
-  if (target.url() === 'chrome://newtab/') {
-    return true;
+  if (!devtools) {
+    ignoredPrefixes.add('devtools://');
   }
-  for (const prefix of ignoredPrefixes) {
-    if (target.url().startsWith(prefix)) {
-      return false;
+  return function targetFilter(target: Target): boolean {
+    if (target.url() === 'chrome://newtab/') {
+      return true;
     }
-  }
-  return true;
+    for (const prefix of ignoredPrefixes) {
+      if (target.url().startsWith(prefix)) {
+        return false;
+      }
+    }
+    return true;
+  };
 }
 
-const connectOptions: ConnectOptions = {
-  targetFilter,
-};
-
-export async function ensureBrowserConnected(browserURL: string) {
+export async function ensureBrowserConnected(options: {
+  browserURL: string;
+  devtools: boolean;
+}) {
   if (browser?.connected) {
     return browser;
   }
   browser = await puppeteer.connect({
-    ...connectOptions,
-    browserURL,
+    targetFilter: makeTargetFilter(options.devtools),
+    browserURL: options.browserURL,
     defaultViewport: null,
+    handleDevToolsAsPage: options.devtools,
   });
   return browser;
 }
@@ -68,6 +71,7 @@ interface McpLaunchOptions {
     height: number;
   };
   args?: string[];
+  devtools: boolean;
 }
 
 export async function launch(options: McpLaunchOptions): Promise<Browser> {
@@ -101,6 +105,9 @@ export async function launch(options: McpLaunchOptions): Promise<Browser> {
     args.push('--screen-info={3840x2160}');
   }
   let puppeteerChannel: ChromeReleaseChannel | undefined;
+  if (options.devtools) {
+    args.push('--auto-open-devtools-for-tabs');
+  }
   if (!executablePath) {
     puppeteerChannel =
       channel && channel !== 'stable'
@@ -110,8 +117,8 @@ export async function launch(options: McpLaunchOptions): Promise<Browser> {
 
   try {
     const browser = await puppeteer.launch({
-      ...connectOptions,
       channel: puppeteerChannel,
+      targetFilter: makeTargetFilter(options.devtools),
       executablePath,
       defaultViewport: null,
       userDataDir,
@@ -119,6 +126,7 @@ export async function launch(options: McpLaunchOptions): Promise<Browser> {
       headless,
       args,
       acceptInsecureCerts: options.acceptInsecureCerts,
+      handleDevToolsAsPage: options.devtools,
     });
     if (options.logFile) {
       // FIXME: we are probably subscribing too late to catch startup logs. We
diff --git a/src/cli.ts b/src/cli.ts
index 909d1a21..17b1df63 100644
--- a/src/cli.ts
+++ b/src/cli.ts
@@ -88,6 +88,11 @@ export const cliOptions = {
     type: 'boolean',
     description: `If enabled, ignores errors relative to self-signed and expired certificates. Use with caution.`,
   },
+  experimentalDevtools: {
+    type: 'boolean' as const,
+    describe: 'Whether to enable automation over DevTools targets',
+    hidden: true,
+  },
 } satisfies Record<string, YargsOptions>;
 
 export function parseArguments(version: string, argv = process.argv) {
diff --git a/src/main.ts b/src/main.ts
index 2663d3c1..fdf18550 100644
--- a/src/main.ts
+++ b/src/main.ts
@@ -73,8 +73,12 @@ async function getContext(): Promise<McpContext> {
   if (args.proxyServer) {
     extraArgs.push(`--proxy-server=${args.proxyServer}`);
   }
+  const devtools = args.experimentalDevtools ?? false;
   const browser = args.browserUrl
-    ? await ensureBrowserConnected(args.browserUrl)
+    ? await ensureBrowserConnected({
+        browserURL: args.browserUrl,
+        devtools,
+      })
     : await ensureBrowserLaunched({
         headless: args.headless,
         executablePath: args.executablePath,
@@ -85,6 +89,7 @@ async function getContext(): Promise<McpContext> {
         viewport: args.viewport,
         args: extraArgs,
         acceptInsecureCerts: args.acceptInsecureCerts,
+        devtools,
       });
 
   if (context?.browser !== browser) {
@@ -143,6 +148,9 @@ function registerTool(tool: ToolDefinition): void {
             isError: true,
           };
         }
+      } catch (err) {
+        logger(`${tool.name} error: ${err.message}`);
+        throw err;
       } finally {
         guard.dispose();
       }
diff --git a/tests/browser.test.ts b/tests/browser.test.ts
index b4811202..8066da5f 100644
--- a/tests/browser.test.ts
+++ b/tests/browser.test.ts
@@ -21,6 +21,7 @@ describe('browser', () => {
       isolated: false,
       userDataDir: folderPath,
       executablePath: executablePath(),
+      devtools: false,
     });
     try {
       try {
@@ -29,6 +30,7 @@ describe('browser', () => {
           isolated: false,
           userDataDir: folderPath,
           executablePath: executablePath(),
+          devtools: false,
         });
         await browser2.close();
         assert.fail('not reached');
@@ -55,6 +57,7 @@ describe('browser', () => {
         width: 1501,
         height: 801,
       },
+      devtools: false,
     });
     try {
       const [page] = await browser.pages();

From ec3848d491f8fc74e9f7631e4dba68c53b0db97f Mon Sep 17 00:00:00 2001
From: browser-automation-bot
 <133232582+browser-automation-bot@users.noreply.github.com>
Date: Fri, 10 Oct 2025 16:55:25 +0200
Subject: [PATCH 33/44] chore(main): release chrome-devtools-mcp 0.7.1 (#337)

:robot: I have created a release *beep* *boop*
---


##
[0.7.1](https://github.com/ChromeDevTools/chrome-devtools-mcp/compare/chrome-devtools-mcp-v0.7.0...chrome-devtools-mcp-v0.7.1)
(2025-10-10)


### Bug Fixes

* document that console and requests are since the last nav
([#335](https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/335))
([9ad7cbb](https://github.com/ChromeDevTools/chrome-devtools-mcp/commit/9ad7cbb2de3d285e46e5f3e7c098b0a7535c7e7a))

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).
---
 .release-please-manifest.json | 2 +-
 CHANGELOG.md                  | 7 +++++++
 package-lock.json             | 4 ++--
 package.json                  | 2 +-
 4 files changed, 11 insertions(+), 4 deletions(-)

diff --git a/.release-please-manifest.json b/.release-please-manifest.json
index e7ca6139..13708fa5 100644
--- a/.release-please-manifest.json
+++ b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "0.7.0"
+  ".": "0.7.1"
 }
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 7a258aa9..cde236a8 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.7.1](https://github.com/ChromeDevTools/chrome-devtools-mcp/compare/chrome-devtools-mcp-v0.7.0...chrome-devtools-mcp-v0.7.1) (2025-10-10)
+
+
+### Bug Fixes
+
+* document that console and requests are since the last nav ([#335](https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/335)) ([9ad7cbb](https://github.com/ChromeDevTools/chrome-devtools-mcp/commit/9ad7cbb2de3d285e46e5f3e7c098b0a7535c7e7a))
+
 ## [0.7.0](https://github.com/ChromeDevTools/chrome-devtools-mcp/compare/chrome-devtools-mcp-v0.6.1...chrome-devtools-mcp-v0.7.0) (2025-10-10)
 
 
diff --git a/package-lock.json b/package-lock.json
index 1bfd3e7a..7807d983 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "chrome-devtools-mcp",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "chrome-devtools-mcp",
-      "version": "0.7.0",
+      "version": "0.7.1",
       "license": "Apache-2.0",
       "dependencies": {
         "@modelcontextprotocol/sdk": "1.19.1",
diff --git a/package.json b/package.json
index dbc40a16..415c6dc8 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "chrome-devtools-mcp",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "MCP server for Chrome DevTools",
   "type": "module",
   "bin": "./build/src/index.js",

From 1a5aa18204210d13ec92d978d6a604605c9b1342 Mon Sep 17 00:00:00 2001
From: Alex Rudenko <OrKoN@users.noreply.github.com>
Date: Fri, 10 Oct 2025 17:05:41 +0200
Subject: [PATCH 34/44] feat: support passing args to Chrome (#338)

Drive-by: removes custom devtools frontend as a dedicated argument.

Closes https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/261
---
 README.md         |  4 ++++
 src/browser.ts    |  6 +-----
 src/cli.ts        | 18 ++++++++++--------
 src/main.ts       |  3 +--
 tests/cli.test.ts | 18 ++++++++++++++++++
 5 files changed, 34 insertions(+), 15 deletions(-)

diff --git a/README.md b/README.md
index 4c5e7a50..be44ccaa 100644
--- a/README.md
+++ b/README.md
@@ -291,6 +291,10 @@ The Chrome DevTools MCP server supports the following configuration option:
   If enabled, ignores errors relative to self-signed and expired certificates. Use with caution.
   - **Type:** boolean
 
+- **`--chromeArg`**
+  Additional arguments for Chrome. Only applies when Chrome is launched by chrome-devtools-mcp.
+  - **Type:** array
+
 <!-- END AUTO GENERATED OPTIONS -->
 
 Pass them via the `args` property in the JSON configuration. For example:
diff --git a/src/browser.ts b/src/browser.ts
index b0a7aaa5..76fd14f4 100644
--- a/src/browser.ts
+++ b/src/browser.ts
@@ -60,7 +60,6 @@ export async function ensureBrowserConnected(options: {
 interface McpLaunchOptions {
   acceptInsecureCerts?: boolean;
   executablePath?: string;
-  customDevTools?: string;
   channel?: Channel;
   userDataDir?: string;
   headless: boolean;
@@ -75,7 +74,7 @@ interface McpLaunchOptions {
 }
 
 export async function launch(options: McpLaunchOptions): Promise<Browser> {
-  const {channel, executablePath, customDevTools, headless, isolated} = options;
+  const {channel, executablePath, headless, isolated} = options;
   const profileDirName =
     channel && channel !== 'stable'
       ? `chrome-profile-${channel}`
@@ -98,9 +97,6 @@ export async function launch(options: McpLaunchOptions): Promise<Browser> {
     ...(options.args ?? []),
     '--hide-crash-restore-bubble',
   ];
-  if (customDevTools) {
-    args.push(`--custom-devtools-frontend=file://${customDevTools}`);
-  }
   if (headless) {
     args.push('--screen-info={3840x2160}');
   }
diff --git a/src/cli.ts b/src/cli.ts
index 17b1df63..513fff33 100644
--- a/src/cli.ts
+++ b/src/cli.ts
@@ -43,13 +43,6 @@ export const cliOptions = {
       'If specified, creates a temporary user-data-dir that is automatically cleaned up after the browser is closed.',
     default: false,
   },
-  customDevtools: {
-    type: 'string',
-    description: 'Path to custom DevTools.',
-    hidden: true,
-    conflicts: 'browserUrl',
-    alias: 'd',
-  },
   channel: {
     type: 'string',
     description:
@@ -89,10 +82,15 @@ export const cliOptions = {
     description: `If enabled, ignores errors relative to self-signed and expired certificates. Use with caution.`,
   },
   experimentalDevtools: {
-    type: 'boolean' as const,
+    type: 'boolean',
     describe: 'Whether to enable automation over DevTools targets',
     hidden: true,
   },
+  chromeArg: {
+    type: 'array',
+    describe:
+      'Additional arguments for Chrome. Only applies when Chrome is launched by chrome-devtools-mcp.',
+  },
 } satisfies Record<string, YargsOptions>;
 
 export function parseArguments(version: string, argv = process.argv) {
@@ -122,6 +120,10 @@ export function parseArguments(version: string, argv = process.argv) {
         '$0 --viewport 1280x720',
         'Launch Chrome with the initial viewport size of 1280x720px',
       ],
+      [
+        `$0 --chrome-arg='--no-sandbox' --chrome-arg='--disable-setuid-sandbox'`,
+        'Launch Chrome without sandboxes. Use with caution.',
+      ],
     ]);
 
   return yargsInstance
diff --git a/src/main.ts b/src/main.ts
index fdf18550..ada8cb30 100644
--- a/src/main.ts
+++ b/src/main.ts
@@ -69,7 +69,7 @@ server.server.setRequestHandler(SetLevelRequestSchema, () => {
 
 let context: McpContext;
 async function getContext(): Promise<McpContext> {
-  const extraArgs: string[] = [];
+  const extraArgs: string[] = (args.chromeArg ?? []).map(String);
   if (args.proxyServer) {
     extraArgs.push(`--proxy-server=${args.proxyServer}`);
   }
@@ -82,7 +82,6 @@ async function getContext(): Promise<McpContext> {
     : await ensureBrowserLaunched({
         headless: args.headless,
         executablePath: args.executablePath,
-        customDevTools: args.customDevtools,
         channel: args.channel as Channel,
         isolated: args.isolated,
         logFile,
diff --git a/tests/cli.test.ts b/tests/cli.test.ts
index 1580825c..ab46582f 100644
--- a/tests/cli.test.ts
+++ b/tests/cli.test.ts
@@ -94,4 +94,22 @@ describe('cli args parsing', () => {
       },
     });
   });
+
+  it('parses viewport', async () => {
+    const args = parseArguments('1.0.0', [
+      'node',
+      'main.js',
+      `--chrome-arg='--no-sandbox'`,
+      `--chrome-arg='--disable-setuid-sandbox'`,
+    ]);
+    assert.deepStrictEqual(args, {
+      _: [],
+      headless: false,
+      isolated: false,
+      $0: 'npx chrome-devtools-mcp@latest',
+      channel: 'stable',
+      'chrome-arg': ['--no-sandbox', '--disable-setuid-sandbox'],
+      chromeArg: ['--no-sandbox', '--disable-setuid-sandbox'],
+    });
+  });
 });

From 0009725bc8e5aad49b2d8db0d7edc523d49e3921 Mon Sep 17 00:00:00 2001
From: browser-automation-bot
 <133232582+browser-automation-bot@users.noreply.github.com>
Date: Fri, 10 Oct 2025 17:13:45 +0200
Subject: [PATCH 35/44] chore(main): release chrome-devtools-mcp 0.8.0 (#339)

:robot: I have created a release *beep* *boop*
---


##
[0.8.0](https://github.com/ChromeDevTools/chrome-devtools-mcp/compare/chrome-devtools-mcp-v0.7.1...chrome-devtools-mcp-v0.8.0)
(2025-10-10)


### Features

* support passing args to Chrome
([#338](https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/338))
([e1b5363](https://github.com/ChromeDevTools/chrome-devtools-mcp/commit/e1b536365363e1e1a3aa7661dd84290c794510ad))

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).
---
 .release-please-manifest.json | 2 +-
 CHANGELOG.md                  | 7 +++++++
 package-lock.json             | 4 ++--
 package.json                  | 2 +-
 4 files changed, 11 insertions(+), 4 deletions(-)

diff --git a/.release-please-manifest.json b/.release-please-manifest.json
index 13708fa5..64f3cdd6 100644
--- a/.release-please-manifest.json
+++ b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "0.7.1"
+  ".": "0.8.0"
 }
diff --git a/CHANGELOG.md b/CHANGELOG.md
index cde236a8..1a42f71e 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.8.0](https://github.com/ChromeDevTools/chrome-devtools-mcp/compare/chrome-devtools-mcp-v0.7.1...chrome-devtools-mcp-v0.8.0) (2025-10-10)
+
+
+### Features
+
+* support passing args to Chrome ([#338](https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/338)) ([e1b5363](https://github.com/ChromeDevTools/chrome-devtools-mcp/commit/e1b536365363e1e1a3aa7661dd84290c794510ad))
+
 ## [0.7.1](https://github.com/ChromeDevTools/chrome-devtools-mcp/compare/chrome-devtools-mcp-v0.7.0...chrome-devtools-mcp-v0.7.1) (2025-10-10)
 
 
diff --git a/package-lock.json b/package-lock.json
index 7807d983..b83debe7 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "chrome-devtools-mcp",
-  "version": "0.7.1",
+  "version": "0.8.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "chrome-devtools-mcp",
-      "version": "0.7.1",
+      "version": "0.8.0",
       "license": "Apache-2.0",
       "dependencies": {
         "@modelcontextprotocol/sdk": "1.19.1",
diff --git a/package.json b/package.json
index 415c6dc8..06137f00 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "chrome-devtools-mcp",
-  "version": "0.7.1",
+  "version": "0.8.0",
   "description": "MCP server for Chrome DevTools",
   "type": "module",
   "bin": "./build/src/index.js",

From eac4d7ad750ac2b9a54edaef0f4c6a92fa22ec6a Mon Sep 17 00:00:00 2001
From: Alex Rudenko <OrKoN@users.noreply.github.com>
Date: Sat, 11 Oct 2025 21:15:10 +0200
Subject: [PATCH 36/44] docs: update browser URL from localhost to 127.0.0.1
 (#342)

Chrome only listens on IPv4 and localhost might resolve to an IPv6 in
some environments.

Closes https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/341
---
 README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index be44ccaa..07f1b7e4 100644
--- a/README.md
+++ b/README.md
@@ -340,7 +340,7 @@ Here is a step-by-step guide on how to connect to a running Chrome Stable instan
 
 **Step 1: Configure the MCP client**
 
-Add the `--browser-url` option to your MCP client configuration. The value of this option should be the URL of the running Chrome instance. `http://localhost:9222` is a common default.
+Add the `--browser-url` option to your MCP client configuration. The value of this option should be the URL of the running Chrome instance. `http://127.0.0.1:9222` is a common default.
 
 ```json
 {
@@ -349,7 +349,7 @@ Add the `--browser-url` option to your MCP client configuration. The value of th
       "command": "npx",
       "args": [
         "chrome-devtools-mcp@latest",
-        "--browser-url=http://localhost:9222"
+        "--browser-url=http://127.0.0.1:9222"
       ]
     }
   }

From 6a0d013ca5623310c6112dd0c9fce75fb5296843 Mon Sep 17 00:00:00 2001
From: Nikolay Vitkov <34244704+Lightning00Blade@users.noreply.github.com>
Date: Sun, 12 Oct 2025 13:14:27 +0200
Subject: [PATCH 37/44] refactor: use release-please to bump version in files
 (#349)

---
 .github/workflows/publish-to-npm-on-tag.yml |  3 ---
 package.json                                |  3 +--
 release-please-config.json                  | 19 ++++++++++++-
 scripts/sync-server-json-version.ts         | 16 -----------
 src/main.ts                                 | 30 +++++----------------
 5 files changed, 26 insertions(+), 45 deletions(-)
 delete mode 100644 scripts/sync-server-json-version.ts

diff --git a/.github/workflows/publish-to-npm-on-tag.yml b/.github/workflows/publish-to-npm-on-tag.yml
index ceeaa377..d50cdd97 100644
--- a/.github/workflows/publish-to-npm-on-tag.yml
+++ b/.github/workflows/publish-to-npm-on-tag.yml
@@ -77,9 +77,6 @@ jobs:
       - name: Build
         run: npm run build
 
-      - name: Bump
-        run: npm run sync-server-json-version
-
       - name: Install MCP Publisher
         run: |
           export VERSION="1.2.1"
diff --git a/package.json b/package.json
index 06137f00..7c198264 100644
--- a/package.json
+++ b/package.json
@@ -19,8 +19,7 @@
     "test:only": "npm run build && node --require ./build/tests/setup.js --no-warnings=ExperimentalWarning --test-reporter spec --test-force-exit --test --test-only \"build/tests/**/*.test.js\"",
     "test:only:no-build": "node --require ./build/tests/setup.js --no-warnings=ExperimentalWarning --test-reporter spec --test-force-exit --test --test-only \"build/tests/**/*.test.js\"",
     "test:update-snapshots": "npm run build && node --require ./build/tests/setup.js --no-warnings=ExperimentalWarning --test-force-exit --test --test-update-snapshots \"build/tests/**/*.test.js\"",
-    "prepare": "node --experimental-strip-types scripts/prepare.ts",
-    "sync-server-json-version": "node  --experimental-strip-types scripts/sync-server-json-version.ts && npm run format"
+    "prepare": "node --experimental-strip-types scripts/prepare.ts"
   },
   "files": [
     "build/src",
diff --git a/release-please-config.json b/release-please-config.json
index 826a6b2f..1cfd0ac1 100644
--- a/release-please-config.json
+++ b/release-please-config.json
@@ -1,5 +1,22 @@
 {
   "packages": {
-    ".": {}
+    ".": {
+      "extra-files": [
+        {
+          "type": "generic",
+          "path": "src/main.ts"
+        },
+        {
+          "type": "json",
+          "path": "server.json",
+          "jsonpath": "version"
+        },
+        {
+          "type": "json",
+          "path": "server.json",
+          "jsonpath": "packages[0].version"
+        }
+      ]
+    }
   }
 }
diff --git a/scripts/sync-server-json-version.ts b/scripts/sync-server-json-version.ts
deleted file mode 100644
index 27fe176e..00000000
--- a/scripts/sync-server-json-version.ts
+++ /dev/null
@@ -1,16 +0,0 @@
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-import fs from 'node:fs';
-
-const packageJson = JSON.parse(fs.readFileSync('./package.json', 'utf-8'));
-const serverJson = JSON.parse(fs.readFileSync('./server.json', 'utf-8'));
-
-serverJson.version = packageJson.version;
-for (const pkg of serverJson.packages) {
-  pkg.version = packageJson.version;
-}
-
-fs.writeFileSync('./server.json', JSON.stringify(serverJson, null, 2));
diff --git a/src/main.ts b/src/main.ts
index ada8cb30..3452620e 100644
--- a/src/main.ts
+++ b/src/main.ts
@@ -6,10 +6,6 @@
 
 import './polyfill.js';
 
-import assert from 'node:assert';
-import fs from 'node:fs';
-import path from 'node:path';
-
 import {McpServer} from '@modelcontextprotocol/sdk/server/mcp.js';
 import {StdioServerTransport} from '@modelcontextprotocol/sdk/server/stdio.js';
 import type {CallToolResult} from '@modelcontextprotocol/sdk/types.js';
@@ -33,33 +29,21 @@ import * as scriptTools from './tools/script.js';
 import * as snapshotTools from './tools/snapshot.js';
 import type {ToolDefinition} from './tools/ToolDefinition.js';
 
-function readPackageJson(): {version?: string} {
-  const currentDir = import.meta.dirname;
-  const packageJsonPath = path.join(currentDir, '..', '..', 'package.json');
-  if (!fs.existsSync(packageJsonPath)) {
-    return {};
-  }
-  try {
-    const json = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
-    assert.strict(json['name'], 'chrome-devtools-mcp');
-    return json;
-  } catch {
-    return {};
-  }
-}
-
-const version = readPackageJson().version ?? 'unknown';
+// If moved update release-please config
+// x-release-please-start-version
+const VERSION = '0.8.0';
+// x-release-please-end
 
-export const args = parseArguments(version);
+export const args = parseArguments(VERSION);
 
 const logFile = args.logFile ? saveLogsToFile(args.logFile) : undefined;
 
-logger(`Starting Chrome DevTools MCP Server v${version}`);
+logger(`Starting Chrome DevTools MCP Server v${VERSION}`);
 const server = new McpServer(
   {
     name: 'chrome_devtools',
     title: 'Chrome DevTools MCP server',
-    version,
+    version: VERSION,
   },
   {capabilities: {logging: {}}},
 );

From 854f71abe908937b6cc592415e2245d1852c83fe Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sun, 12 Oct 2025 15:55:07 +0200
Subject: [PATCH 38/44] chore(deps): bump the dependencies group across 1
 directory with 2 updates (#355)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Bumps the dependencies group with 2 updates in the / directory:
[@modelcontextprotocol/sdk](https://github.com/modelcontextprotocol/typescript-sdk)
and
[core-js](https://github.com/zloirock/core-js/tree/HEAD/packages/core-js).

Updates `@modelcontextprotocol/sdk` from 1.19.1 to 1.20.0
<details>
<summary>Release notes</summary>
<p><em>Sourced from <a
href="https://github.com/modelcontextprotocol/typescript-sdk/releases"><code>@​modelcontextprotocol/sdk</code>'s
releases</a>.</em></p>
<blockquote>
<h2>1.20.0</h2>
<h2>What's Changed</h2>
<ul>
<li>docs: improve main README with better quick start, include examples
of stateless HTTP, explain tools v resources v prompts by <a
href="https://github.com/domdomegg"><code>@​domdomegg</code></a> in <a
href="https://redirect.github.com/modelcontextprotocol/typescript-sdk/pull/980">modelcontextprotocol/typescript-sdk#980</a></li>
<li>chore: add lint:fix script by <a
href="https://github.com/mattzcarey"><code>@​mattzcarey</code></a> in <a
href="https://redirect.github.com/modelcontextprotocol/typescript-sdk/pull/1013">modelcontextprotocol/typescript-sdk#1013</a></li>
<li>Default to S256 code challenge if not specified in authorization
server metadata by <a
href="https://github.com/LucaButBoring"><code>@​LucaButBoring</code></a>
in <a
href="https://redirect.github.com/modelcontextprotocol/typescript-sdk/pull/992">modelcontextprotocol/typescript-sdk#992</a></li>
</ul>
<h2>New Contributors 🙏</h2>
<ul>
<li><a
href="https://github.com/mattzcarey"><code>@​mattzcarey</code></a> made
their first contribution in <a
href="https://redirect.github.com/modelcontextprotocol/typescript-sdk/pull/1013">modelcontextprotocol/typescript-sdk#1013</a></li>
</ul>
<p><strong>Full Changelog</strong>: <a
href="https://github.com/modelcontextprotocol/typescript-sdk/compare/1.19.0...1.20.0">https://github.com/modelcontextprotocol/typescript-sdk/compare/1.19.0...1.20.0</a></p>
</blockquote>
</details>
<details>
<summary>Commits</summary>
<ul>
<li>See full diff in <a
href="https://github.com/modelcontextprotocol/typescript-sdk/commits/1.20.0">compare
view</a></li>
</ul>
</details>
<br />

Updates `core-js` from 3.45.1 to 3.46.0
<details>
<summary>Changelog</summary>
<p><em>Sourced from <a
href="https://github.com/zloirock/core-js/blob/master/CHANGELOG.md">core-js's
changelog</a>.</em></p>
<blockquote>
<h3><a
href="https://github.com/zloirock/core-js/releases/tag/v3.46.0">3.46.0 -
2025.10.09</a></h3>
<ul>
<li>Changes <a
href="https://github.com/zloirock/core-js/compare/v3.45.1...v3.46.0">v3.45.1...v3.46.0</a>
(116 commits)</li>
<li><a href="https://github.com/tc39/proposal-upsert"><code>Map</code>
upsert stage 3 proposal</a>:
<ul>
<li>Fixed <a
href="https://bugzilla.mozilla.org/show_bug.cgi?id=1988369">a FF
<code>WeakMap.prototype.getOrInsertComputed</code> bug with callback
calling before validation a key</a></li>
</ul>
</li>
<li><a
href="https://github.com/tc39/proposal-iterator-chunking"><code>Iterator</code>
chunking proposal</a>:
<ul>
<li>Built-ins:
<ul>
<li><code>Iterator.prototype.chunks</code></li>
<li><code>Iterator.prototype.windows</code></li>
</ul>
</li>
<li>Moved to stage 2.7, <a
href="https://github.com/tc39/proposals/commit/08e583103c6c244c05a26d9fee518ef8145ba2f6">September
2025 TC39 meeting</a></li>
<li><code>Iterator.prototype.sliding</code> method replaced with an
extra parameter of <code>Iterator.prototype.windows</code> method,
[tc39/proposal-iterator-chunking/<a
href="https://github.com/zloirock/core-js/tree/HEAD/packages/core-js/issues/24">#24</a>](<a
href="https://redirect.github.com/tc39/proposal-iterator-chunking/pull/24">tc39/proposal-iterator-chunking#24</a>),
[tc39/proposal-iterator-chunking/<a
href="https://github.com/zloirock/core-js/tree/HEAD/packages/core-js/issues/26">#26</a>](<a
href="https://redirect.github.com/tc39/proposal-iterator-chunking/pull/26">tc39/proposal-iterator-chunking#26</a>)</li>
</ul>
</li>
<li>Fixed <a
href="https://github.com/tc39/proposal-joint-iteration"><code>Iterator.zip</code>
and <code>Iterator.zipKeyed</code></a> behavior with <code>mode:
'longest'</code> option, <a
href="https://redirect.github.com/zloirock/core-js/issues/1469">#1469</a>,
thanks <a
href="https://github.com/lionel-rowe"><strong><code>@​lionel-rowe</code></strong></a></li>
<li>Fixed work of <code>Object.groupBy</code> and <a
href="https://github.com/tc39/proposal-joint-iteration"><code>Iterator.zipKeyed</code></a>
together with <code>Symbol</code> polyfill - some cases of symbol keys
on result <code>null</code>-prototype object were able to leak out to
<code>for-in</code></li>
<li>Compat data improvements:
<ul>
<li><a href="https://github.com/tc39/proposal-upsert"><code>Map</code>
upsert proposal</a> features marked as shipped from FF144</li>
<li>Added <a
href="https://redirect.github.com/nodejs/node/pull/59896">Node 25.0</a>
compat data mapping</li>
<li>Added <a
href="https://github.com/denoland/deno/releases/tag/v2.5.0">Deno 2.5</a>
compat data mapping</li>
<li>Updated Electron 39 compat data mapping</li>
<li>Updated Opera 121+ compat data mapping</li>
<li>Added <a
href="https://forums.opera.com/topic/86530/opera-for-android-92">Opera
Android 92</a> compat data mapping</li>
<li>Added Oculus Quest Browser 40 compat data mapping</li>
</ul>
</li>
</ul>
</blockquote>
</details>
<details>
<summary>Commits</summary>
<ul>
<li><a
href="https://github.com/zloirock/core-js/commit/98d9dc499ffa8fe7543b8cb8f613351e5b3ab8de"><code>98d9dc4</code></a>
v3.46.0</li>
<li><a
href="https://github.com/zloirock/core-js/commit/38420bdad4bda36eea0c697bb5cecd62caa53911"><code>38420bd</code></a>
add <code>homepage</code> field to <code>package.json</code>s</li>
<li><a
href="https://github.com/zloirock/core-js/commit/a7aee4c58a7eec4fb5958fcb6ba4f07d14446f1d"><code>a7aee4c</code></a>
some fixes</li>
<li><a
href="https://github.com/zloirock/core-js/commit/12b441d64df944e45bc6d709b6a9e3c2c0ce72ea"><code>12b441d</code></a>
Fix <code>Iterator.zip</code> and <code>Iterator.zipKeyed</code>
behavior with <code>mode: 'longest'</code> op...</li>
<li><a
href="https://github.com/zloirock/core-js/commit/15d7a7da70c80bfa3e7fbc2a618acc8b07ce8034"><code>15d7a7d</code></a>
update copyright</li>
<li><a
href="https://github.com/zloirock/core-js/commit/9eaa6ad79a76c03703ea01bc16beca42ee44e054"><code>9eaa6ad</code></a>
Merge pull request <a
href="https://github.com/zloirock/core-js/tree/HEAD/packages/core-js/issues/1451">#1451</a>
from zloirock/iterator-chunking-stage-2-7</li>
<li><a
href="https://github.com/zloirock/core-js/commit/686808fb6ade734d86f5dc9443869550b5490759"><code>686808f</code></a>
clarify versions</li>
<li><a
href="https://github.com/zloirock/core-js/commit/a21ab8d81f8ee58e64e0ec5c9279725483315ed5"><code>a21ab8d</code></a>
FF <code>WeakMap.prototype.getOrInsertComputed</code> was fixed</li>
<li><a
href="https://github.com/zloirock/core-js/commit/747e64806ff04a09b5f3d7990dfcd80afcd91656"><code>747e648</code></a>
Fix object property creation for potential Symbol keys</li>
<li><a
href="https://github.com/zloirock/core-js/commit/6bfb3cde052a1ad9ec3666e47ddd97ef6dfcd430"><code>6bfb3cd</code></a>
move <code>Iterator</code> chunking proposal to stage 2.7</li>
<li>Additional commits viewable in <a
href="https://github.com/zloirock/core-js/commits/v3.46.0/packages/core-js">compare
view</a></li>
</ul>
</details>
<br />


Dependabot will resolve any conflicts with this PR as long as you don't
alter it yourself. You can also trigger a rebase manually by commenting
`@dependabot rebase`.

[//]: # (dependabot-automerge-start)
[//]: # (dependabot-automerge-end)

---

<details>
<summary>Dependabot commands and options</summary>
<br />

You can trigger Dependabot actions by commenting on this PR:
- `@dependabot rebase` will rebase this PR
- `@dependabot recreate` will recreate this PR, overwriting any edits
that have been made to it
- `@dependabot merge` will merge this PR after your CI passes on it
- `@dependabot squash and merge` will squash and merge this PR after
your CI passes on it
- `@dependabot cancel merge` will cancel a previously requested merge
and block automerging
- `@dependabot reopen` will reopen this PR if it is closed
- `@dependabot close` will close this PR and stop Dependabot recreating
it. You can achieve the same result by closing it manually
- `@dependabot show <dependency name> ignore conditions` will show all
of the ignore conditions of the specified dependency
- `@dependabot ignore <dependency name> major version` will close this
group update PR and stop Dependabot creating any more for the specific
dependency's major version (unless you unignore this specific
dependency's major version or upgrade to it yourself)
- `@dependabot ignore <dependency name> minor version` will close this
group update PR and stop Dependabot creating any more for the specific
dependency's minor version (unless you unignore this specific
dependency's minor version or upgrade to it yourself)
- `@dependabot ignore <dependency name>` will close this group update PR
and stop Dependabot creating any more for the specific dependency
(unless you unignore this specific dependency or upgrade to it yourself)
- `@dependabot unignore <dependency name>` will remove all of the ignore
conditions of the specified dependency
- `@dependabot unignore <dependency name> <ignore condition>` will
remove the ignore condition of the specified dependency and ignore
conditions


</details>

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 package-lock.json | 16 ++++++++--------
 package.json      |  4 ++--
 2 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index b83debe7..407c26e5 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -9,8 +9,8 @@
       "version": "0.8.0",
       "license": "Apache-2.0",
       "dependencies": {
-        "@modelcontextprotocol/sdk": "1.19.1",
-        "core-js": "3.45.1",
+        "@modelcontextprotocol/sdk": "1.20.0",
+        "core-js": "3.46.0",
         "debug": "4.4.3",
         "puppeteer-core": "^24.24.0",
         "yargs": "18.0.0",
@@ -372,9 +372,9 @@
       }
     },
     "node_modules/@modelcontextprotocol/sdk": {
-      "version": "1.19.1",
-      "resolved": "https://registry.npmjs.org/@modelcontextprotocol/sdk/-/sdk-1.19.1.tgz",
-      "integrity": "sha512-3Y2h3MZKjec1eAqSTBclATlX+AbC6n1LgfVzRMJLt3v6w0RCYgwLrjbxPDbhsYHt6Wdqc/aCceNJYgj448ELQQ==",
+      "version": "1.20.0",
+      "resolved": "https://registry.npmjs.org/@modelcontextprotocol/sdk/-/sdk-1.20.0.tgz",
+      "integrity": "sha512-kOQ4+fHuT4KbR2iq2IjeV32HiihueuOf1vJkq18z08CLZ1UQrTc8BXJpVfxZkq45+inLLD+D4xx4nBjUelJa4Q==",
       "license": "MIT",
       "dependencies": {
         "ajv": "^6.12.6",
@@ -1907,9 +1907,9 @@
       }
     },
     "node_modules/core-js": {
-      "version": "3.45.1",
-      "resolved": "https://registry.npmjs.org/core-js/-/core-js-3.45.1.tgz",
-      "integrity": "sha512-L4NPsJlCfZsPeXukyzHFlg/i7IIVwHSItR0wg0FLNqYClJ4MQYTYLbC7EkjKYRLZF2iof2MUgN0EGy7MdQFChg==",
+      "version": "3.46.0",
+      "resolved": "https://registry.npmjs.org/core-js/-/core-js-3.46.0.tgz",
+      "integrity": "sha512-vDMm9B0xnqqZ8uSBpZ8sNtRtOdmfShrvT6h2TuQGLs0Is+cR0DYbj/KWP6ALVNbWPpqA/qPLoOuppJN07humpA==",
       "hasInstallScript": true,
       "license": "MIT",
       "funding": {
diff --git a/package.json b/package.json
index 7c198264..57feb412 100644
--- a/package.json
+++ b/package.json
@@ -36,8 +36,8 @@
   "homepage": "https://github.com/ChromeDevTools/chrome-devtools-mcp#readme",
   "mcpName": "io.github.ChromeDevTools/chrome-devtools-mcp",
   "dependencies": {
-    "@modelcontextprotocol/sdk": "1.19.1",
-    "core-js": "3.45.1",
+    "@modelcontextprotocol/sdk": "1.20.0",
+    "core-js": "3.46.0",
     "debug": "4.4.3",
     "puppeteer-core": "^24.24.0",
     "yargs": "18.0.0",

From 7c0e47febbadfbf54463ac7298ccf59ec2908c81 Mon Sep 17 00:00:00 2001
From: Alex Rudenko <OrKoN@users.noreply.github.com>
Date: Sun, 12 Oct 2025 15:57:44 +0200
Subject: [PATCH 39/44] ci: extract devtools frontend to a separate group
 (#353)

---
 .github/dependabot.yml | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/.github/dependabot.yml b/.github/dependabot.yml
index 18e7d6a4..63c22745 100644
--- a/.github/dependabot.yml
+++ b/.github/dependabot.yml
@@ -12,6 +12,7 @@ updates:
         dependency-type: production
         exclude-patterns:
           - 'puppeteer*'
+          - 'chrome-devtools-frontend'
         patterns:
           - '*'
       dev-dependencies:
@@ -23,6 +24,9 @@ updates:
       puppeteer:
         patterns:
           - 'puppeteer*'
+      chrome-devtools-frontend:
+        patterns:
+          - 'chrome-devtools-frontend'
   - package-ecosystem: github-actions
     directory: /
     schedule:

From cce927ff6acf399304c1c05d65e542a62b8b85e0 Mon Sep 17 00:00:00 2001
From: Alex Rudenko <OrKoN@users.noreply.github.com>
Date: Sun, 12 Oct 2025 16:23:35 +0200
Subject: [PATCH 40/44] refactor: sort tools alphabetically (#346)

---
 src/main.ts | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/src/main.ts b/src/main.ts
index 3452620e..d35e1f14 100644
--- a/src/main.ts
+++ b/src/main.ts
@@ -151,9 +151,14 @@ const tools = [
   ...Object.values(screenshotTools),
   ...Object.values(scriptTools),
   ...Object.values(snapshotTools),
-];
+] as ToolDefinition[];
+
+tools.sort((a, b) => {
+  return a.name.localeCompare(b.name);
+});
+
 for (const tool of tools) {
-  registerTool(tool as unknown as ToolDefinition);
+  registerTool(tool);
 }
 
 const transport = new StdioServerTransport();

From 9624a6855a5771ed92320d9b178de0b53b41652b Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sun, 12 Oct 2025 16:36:23 +0200
Subject: [PATCH 41/44] chore(deps-dev): bump the dev-dependencies group across
 1 directory with 4 updates (#356)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Bumps the dev-dependencies group with 4 updates in the / directory:
[@types/node](https://github.com/DefinitelyTyped/DefinitelyTyped/tree/HEAD/types/node),
[@typescript-eslint/eslint-plugin](https://github.com/typescript-eslint/typescript-eslint/tree/HEAD/packages/eslint-plugin),
[@typescript-eslint/parser](https://github.com/typescript-eslint/typescript-eslint/tree/HEAD/packages/parser)
and
[typescript-eslint](https://github.com/typescript-eslint/typescript-eslint/tree/HEAD/packages/typescript-eslint).

Updates `@types/node` from 24.7.0 to 24.7.2
<details>
<summary>Commits</summary>
<ul>
<li>See full diff in <a
href="https://github.com/DefinitelyTyped/DefinitelyTyped/commits/HEAD/types/node">compare
view</a></li>
</ul>
</details>
<br />

Updates `@typescript-eslint/eslint-plugin` from 8.45.0 to 8.46.0
<details>
<summary>Release notes</summary>
<p><em>Sourced from <a
href="https://github.com/typescript-eslint/typescript-eslint/releases"><code>@​typescript-eslint/eslint-plugin</code>'s
releases</a>.</em></p>
<blockquote>
<h2>v8.46.0</h2>
<h2>8.46.0 (2025-10-06)</h2>
<h3>🚀 Features</h3>
<ul>
<li><strong>eslint-plugin:</strong> [no-unsafe-member-access] add
allowOptionalChaining option (<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/11659">#11659</a>)</li>
<li><strong>eslint-plugin-internal:</strong> [no-dynamic-tests] new
internal Lint rule to ban dynamic syntax in generating tests (<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/11323">#11323</a>)</li>
<li><strong>rule-schema-to-typescript-types:</strong> clean up and make
public (<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/11633">#11633</a>)</li>
<li><strong>typescript-eslint:</strong> export util types (<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/10848">#10848</a>,
<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/10849">#10849</a>)</li>
<li><strong>typescript-estree:</strong> mention file specifics in
project service allowDefaultProject error (<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/11635">#11635</a>)</li>
<li><strong>typescript-estree:</strong> private identifiers can only
appear on LHS of in expressions (<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/9232">#9232</a>)</li>
</ul>
<h3>🩹 Fixes</h3>
<ul>
<li><strong>eslint-plugin:</strong> [no-floating-promises] remove excess
parentheses in suggestions (<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/11487">#11487</a>)</li>
<li><strong>eslint-plugin:</strong> [unbound-method] improve wording
around <code>this: void</code> and binding (<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/11634">#11634</a>)</li>
<li><strong>eslint-plugin:</strong> [no-deprecated] ignore deprecated
<code>export import</code>s (<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/11603">#11603</a>)</li>
<li><strong>eslint-plugin:</strong> removed error type previously
deprecated (<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/11674">#11674</a>)</li>
<li><strong>eslint-plugin:</strong> [prefer-readonly-parameter-types]
ignore tagged primitives (<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/11660">#11660</a>)</li>
<li><strong>rule-tester:</strong> deprecate TestCaseError#type and
LintMessage#nodeType (<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/11628">#11628</a>)</li>
<li><strong>typescript-estree:</strong> forbid <code>abstract</code>
modifier in object methods (<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/11656">#11656</a>)</li>
<li><strong>typescript-estree:</strong> forbid abstract method and
accessor to have implementation (<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/11657">#11657</a>)</li>
</ul>
<h3>❤️ Thank You</h3>
<ul>
<li>fisker Cheung <a
href="https://github.com/fisker"><code>@​fisker</code></a></li>
<li>Josh Goldberg ✨</li>
<li>Joshua Chen</li>
<li>Kirk Waiblinger <a
href="https://github.com/kirkwaiblinger"><code>@​kirkwaiblinger</code></a></li>
<li>Mark de Dios <a
href="https://github.com/peanutenthusiast"><code>@​peanutenthusiast</code></a></li>
<li>Mister-Hope <a
href="https://github.com/Mister-Hope"><code>@​Mister-Hope</code></a></li>
<li>Richard Torres <a
href="https://github.com/richardtorres314"><code>@​richardtorres314</code></a></li>
<li>Victor Genaev <a
href="https://github.com/mainframev"><code>@​mainframev</code></a></li>
<li>Younsang Na <a
href="https://github.com/nayounsang"><code>@​nayounsang</code></a></li>
</ul>
<p>You can read about our <a
href="https://typescript-eslint.io/users/versioning">versioning
strategy</a> and <a
href="https://typescript-eslint.io/users/releases">releases</a> on our
website.</p>
</blockquote>
</details>
<details>
<summary>Changelog</summary>
<p><em>Sourced from <a
href="https://github.com/typescript-eslint/typescript-eslint/blob/main/packages/eslint-plugin/CHANGELOG.md"><code>@​typescript-eslint/eslint-plugin</code>'s
changelog</a>.</em></p>
<blockquote>
<h2>8.46.0 (2025-10-06)</h2>
<h3>🚀 Features</h3>
<ul>
<li><strong>eslint-plugin:</strong> [no-unsafe-member-access] add
allowOptionalChaining option (<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/11659">#11659</a>)</li>
<li><strong>rule-schema-to-typescript-types:</strong> clean up and make
public (<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/11633">#11633</a>)</li>
</ul>
<h3>🩹 Fixes</h3>
<ul>
<li><strong>eslint-plugin:</strong> [prefer-readonly-parameter-types]
ignore tagged primitives (<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/11660">#11660</a>)</li>
<li><strong>typescript-estree:</strong> forbid abstract method and
accessor to have implementation (<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/11657">#11657</a>)</li>
<li><strong>eslint-plugin:</strong> removed error type previously
deprecated (<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/11674">#11674</a>)</li>
<li><strong>eslint-plugin:</strong> [no-deprecated] ignore deprecated
<code>export import</code>s (<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/11603">#11603</a>)</li>
<li><strong>eslint-plugin:</strong> [unbound-method] improve wording
around <code>this: void</code> and binding (<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/11634">#11634</a>)</li>
<li><strong>rule-tester:</strong> deprecate TestCaseError#type and
LintMessage#nodeType (<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/11628">#11628</a>)</li>
<li><strong>eslint-plugin:</strong> [no-floating-promises] remove excess
parentheses in suggestions (<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/11487">#11487</a>)</li>
</ul>
<h3>❤️ Thank You</h3>
<ul>
<li>fisker Cheung <a
href="https://github.com/fisker"><code>@​fisker</code></a></li>
<li>Josh Goldberg ✨</li>
<li>Kirk Waiblinger <a
href="https://github.com/kirkwaiblinger"><code>@​kirkwaiblinger</code></a></li>
<li>Mark de Dios <a
href="https://github.com/peanutenthusiast"><code>@​peanutenthusiast</code></a></li>
<li>Richard Torres <a
href="https://github.com/richardtorres314"><code>@​richardtorres314</code></a></li>
<li>Victor Genaev <a
href="https://github.com/mainframev"><code>@​mainframev</code></a></li>
</ul>
<p>You can read about our <a
href="https://typescript-eslint.io/users/versioning">versioning
strategy</a> and <a
href="https://typescript-eslint.io/users/releases">releases</a> on our
website.</p>
</blockquote>
</details>
<details>
<summary>Commits</summary>
<ul>
<li><a
href="https://github.com/typescript-eslint/typescript-eslint/commit/aec785e33d63b248231c3e68c9aeb792caf21acc"><code>aec785e</code></a>
chore(release): publish 8.46.0</li>
<li><a
href="https://github.com/typescript-eslint/typescript-eslint/commit/a97419124f93aef7e7748e4d0d768d6e79c28e28"><code>a974191</code></a>
fix(eslint-plugin): [prefer-readonly-parameter-types] ignore tagged
primitive...</li>
<li><a
href="https://github.com/typescript-eslint/typescript-eslint/commit/02e02787425300e6b3e27903138fef4ead94c182"><code>02e0278</code></a>
fix(typescript-estree): forbid abstract method and accessor to have
implement...</li>
<li><a
href="https://github.com/typescript-eslint/typescript-eslint/commit/f0837984cb587a47bfa7737ed252fedf67346168"><code>f083798</code></a>
feat(eslint-plugin): [no-unsafe-member-access] add allowOptionalChaining
opti...</li>
<li><a
href="https://github.com/typescript-eslint/typescript-eslint/commit/a62f625521385447fd5e22bd02a3cbc3dbdf7f2c"><code>a62f625</code></a>
fix(eslint-plugin): removed error type previously deprecated (<a
href="https://github.com/typescript-eslint/typescript-eslint/tree/HEAD/packages/eslint-plugin/issues/11674">#11674</a>)</li>
<li><a
href="https://github.com/typescript-eslint/typescript-eslint/commit/7f5fed7922385479613f4d79a28615014174a556"><code>7f5fed7</code></a>
chore: remove unused batchedSingleLineTests test utility (<a
href="https://github.com/typescript-eslint/typescript-eslint/tree/HEAD/packages/eslint-plugin/issues/11675">#11675</a>)</li>
<li><a
href="https://github.com/typescript-eslint/typescript-eslint/commit/f8412ce22b6e7e12121759d34b306d5f4019f1e5"><code>f8412ce</code></a>
fix(eslint-plugin): [no-deprecated] ignore deprecated <code>export
import</code>s (<a
href="https://github.com/typescript-eslint/typescript-eslint/tree/HEAD/packages/eslint-plugin/issues/11603">#11603</a>)</li>
<li><a
href="https://github.com/typescript-eslint/typescript-eslint/commit/8de997ef305b3244238d85505f132410110e09c7"><code>8de997e</code></a>
feat(eslint-plugin): [no-unused-vars] support explicit resource
management wi...</li>
<li><a
href="https://github.com/typescript-eslint/typescript-eslint/commit/740a63fd3e0fe2d9c30ae5eff6a41b0941a3129b"><code>740a63f</code></a>
feat(rule-schema-to-typescript-types): clean up and make public (<a
href="https://github.com/typescript-eslint/typescript-eslint/tree/HEAD/packages/eslint-plugin/issues/11633">#11633</a>)</li>
<li><a
href="https://github.com/typescript-eslint/typescript-eslint/commit/692d4eeeca905fe1c4e11808a4b73f6bfdcc34d8"><code>692d4ee</code></a>
docs(eslint-plugin): [prefer-for-of] mention DOM elements and lib:
dom.iterab...</li>
<li>Additional commits viewable in <a
href="https://github.com/typescript-eslint/typescript-eslint/commits/v8.46.0/packages/eslint-plugin">compare
view</a></li>
</ul>
</details>
<br />

Updates `@typescript-eslint/parser` from 8.45.0 to 8.46.0
<details>
<summary>Release notes</summary>
<p><em>Sourced from <a
href="https://github.com/typescript-eslint/typescript-eslint/releases"><code>@​typescript-eslint/parser</code>'s
releases</a>.</em></p>
<blockquote>
<h2>v8.46.0</h2>
<h2>8.46.0 (2025-10-06)</h2>
<h3>🚀 Features</h3>
<ul>
<li><strong>eslint-plugin:</strong> [no-unsafe-member-access] add
allowOptionalChaining option (<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/11659">#11659</a>)</li>
<li><strong>eslint-plugin-internal:</strong> [no-dynamic-tests] new
internal Lint rule to ban dynamic syntax in generating tests (<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/11323">#11323</a>)</li>
<li><strong>rule-schema-to-typescript-types:</strong> clean up and make
public (<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/11633">#11633</a>)</li>
<li><strong>typescript-eslint:</strong> export util types (<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/10848">#10848</a>,
<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/10849">#10849</a>)</li>
<li><strong>typescript-estree:</strong> mention file specifics in
project service allowDefaultProject error (<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/11635">#11635</a>)</li>
<li><strong>typescript-estree:</strong> private identifiers can only
appear on LHS of in expressions (<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/9232">#9232</a>)</li>
</ul>
<h3>🩹 Fixes</h3>
<ul>
<li><strong>eslint-plugin:</strong> [no-floating-promises] remove excess
parentheses in suggestions (<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/11487">#11487</a>)</li>
<li><strong>eslint-plugin:</strong> [unbound-method] improve wording
around <code>this: void</code> and binding (<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/11634">#11634</a>)</li>
<li><strong>eslint-plugin:</strong> [no-deprecated] ignore deprecated
<code>export import</code>s (<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/11603">#11603</a>)</li>
<li><strong>eslint-plugin:</strong> removed error type previously
deprecated (<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/11674">#11674</a>)</li>
<li><strong>eslint-plugin:</strong> [prefer-readonly-parameter-types]
ignore tagged primitives (<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/11660">#11660</a>)</li>
<li><strong>rule-tester:</strong> deprecate TestCaseError#type and
LintMessage#nodeType (<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/11628">#11628</a>)</li>
<li><strong>typescript-estree:</strong> forbid <code>abstract</code>
modifier in object methods (<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/11656">#11656</a>)</li>
<li><strong>typescript-estree:</strong> forbid abstract method and
accessor to have implementation (<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/11657">#11657</a>)</li>
</ul>
<h3>❤️ Thank You</h3>
<ul>
<li>fisker Cheung <a
href="https://github.com/fisker"><code>@​fisker</code></a></li>
<li>Josh Goldberg ✨</li>
<li>Joshua Chen</li>
<li>Kirk Waiblinger <a
href="https://github.com/kirkwaiblinger"><code>@​kirkwaiblinger</code></a></li>
<li>Mark de Dios <a
href="https://github.com/peanutenthusiast"><code>@​peanutenthusiast</code></a></li>
<li>Mister-Hope <a
href="https://github.com/Mister-Hope"><code>@​Mister-Hope</code></a></li>
<li>Richard Torres <a
href="https://github.com/richardtorres314"><code>@​richardtorres314</code></a></li>
<li>Victor Genaev <a
href="https://github.com/mainframev"><code>@​mainframev</code></a></li>
<li>Younsang Na <a
href="https://github.com/nayounsang"><code>@​nayounsang</code></a></li>
</ul>
<p>You can read about our <a
href="https://typescript-eslint.io/users/versioning">versioning
strategy</a> and <a
href="https://typescript-eslint.io/users/releases">releases</a> on our
website.</p>
</blockquote>
</details>
<details>
<summary>Changelog</summary>
<p><em>Sourced from <a
href="https://github.com/typescript-eslint/typescript-eslint/blob/main/packages/parser/CHANGELOG.md"><code>@​typescript-eslint/parser</code>'s
changelog</a>.</em></p>
<blockquote>
<h2>8.46.0 (2025-10-06)</h2>
<p>This was a version bump only for parser to align it with other
projects, there were no code changes.</p>
<p>You can read about our <a
href="https://typescript-eslint.io/users/versioning">versioning
strategy</a> and <a
href="https://typescript-eslint.io/users/releases">releases</a> on our
website.</p>
</blockquote>
</details>
<details>
<summary>Commits</summary>
<ul>
<li><a
href="https://github.com/typescript-eslint/typescript-eslint/commit/aec785e33d63b248231c3e68c9aeb792caf21acc"><code>aec785e</code></a>
chore(release): publish 8.46.0</li>
<li>See full diff in <a
href="https://github.com/typescript-eslint/typescript-eslint/commits/v8.46.0/packages/parser">compare
view</a></li>
</ul>
</details>
<br />

Updates `typescript-eslint` from 8.45.0 to 8.46.0
<details>
<summary>Release notes</summary>
<p><em>Sourced from <a
href="https://github.com/typescript-eslint/typescript-eslint/releases">typescript-eslint's
releases</a>.</em></p>
<blockquote>
<h2>v8.46.0</h2>
<h2>8.46.0 (2025-10-06)</h2>
<h3>🚀 Features</h3>
<ul>
<li><strong>eslint-plugin:</strong> [no-unsafe-member-access] add
allowOptionalChaining option (<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/11659">#11659</a>)</li>
<li><strong>eslint-plugin-internal:</strong> [no-dynamic-tests] new
internal Lint rule to ban dynamic syntax in generating tests (<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/11323">#11323</a>)</li>
<li><strong>rule-schema-to-typescript-types:</strong> clean up and make
public (<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/11633">#11633</a>)</li>
<li><strong>typescript-eslint:</strong> export util types (<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/10848">#10848</a>,
<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/10849">#10849</a>)</li>
<li><strong>typescript-estree:</strong> mention file specifics in
project service allowDefaultProject error (<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/11635">#11635</a>)</li>
<li><strong>typescript-estree:</strong> private identifiers can only
appear on LHS of in expressions (<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/9232">#9232</a>)</li>
</ul>
<h3>🩹 Fixes</h3>
<ul>
<li><strong>eslint-plugin:</strong> [no-floating-promises] remove excess
parentheses in suggestions (<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/11487">#11487</a>)</li>
<li><strong>eslint-plugin:</strong> [unbound-method] improve wording
around <code>this: void</code> and binding (<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/11634">#11634</a>)</li>
<li><strong>eslint-plugin:</strong> [no-deprecated] ignore deprecated
<code>export import</code>s (<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/11603">#11603</a>)</li>
<li><strong>eslint-plugin:</strong> removed error type previously
deprecated (<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/11674">#11674</a>)</li>
<li><strong>eslint-plugin:</strong> [prefer-readonly-parameter-types]
ignore tagged primitives (<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/11660">#11660</a>)</li>
<li><strong>rule-tester:</strong> deprecate TestCaseError#type and
LintMessage#nodeType (<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/11628">#11628</a>)</li>
<li><strong>typescript-estree:</strong> forbid <code>abstract</code>
modifier in object methods (<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/11656">#11656</a>)</li>
<li><strong>typescript-estree:</strong> forbid abstract method and
accessor to have implementation (<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/11657">#11657</a>)</li>
</ul>
<h3>❤️ Thank You</h3>
<ul>
<li>fisker Cheung <a
href="https://github.com/fisker"><code>@​fisker</code></a></li>
<li>Josh Goldberg ✨</li>
<li>Joshua Chen</li>
<li>Kirk Waiblinger <a
href="https://github.com/kirkwaiblinger"><code>@​kirkwaiblinger</code></a></li>
<li>Mark de Dios <a
href="https://github.com/peanutenthusiast"><code>@​peanutenthusiast</code></a></li>
<li>Mister-Hope <a
href="https://github.com/Mister-Hope"><code>@​Mister-Hope</code></a></li>
<li>Richard Torres <a
href="https://github.com/richardtorres314"><code>@​richardtorres314</code></a></li>
<li>Victor Genaev <a
href="https://github.com/mainframev"><code>@​mainframev</code></a></li>
<li>Younsang Na <a
href="https://github.com/nayounsang"><code>@​nayounsang</code></a></li>
</ul>
<p>You can read about our <a
href="https://typescript-eslint.io/users/versioning">versioning
strategy</a> and <a
href="https://typescript-eslint.io/users/releases">releases</a> on our
website.</p>
</blockquote>
</details>
<details>
<summary>Changelog</summary>
<p><em>Sourced from <a
href="https://github.com/typescript-eslint/typescript-eslint/blob/main/packages/typescript-eslint/CHANGELOG.md">typescript-eslint's
changelog</a>.</em></p>
<blockquote>
<h2>8.46.0 (2025-10-06)</h2>
<h3>🚀 Features</h3>
<ul>
<li><strong>typescript-eslint:</strong> export util types (<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/10848">#10848</a>,
<a
href="https://redirect.github.com/typescript-eslint/typescript-eslint/pull/10849">#10849</a>)</li>
</ul>
<h3>❤️ Thank You</h3>
<ul>
<li>Mister-Hope <a
href="https://github.com/Mister-Hope"><code>@​Mister-Hope</code></a></li>
</ul>
<p>You can read about our <a
href="https://typescript-eslint.io/users/versioning">versioning
strategy</a> and <a
href="https://typescript-eslint.io/users/releases">releases</a> on our
website.</p>
</blockquote>
</details>
<details>
<summary>Commits</summary>
<ul>
<li><a
href="https://github.com/typescript-eslint/typescript-eslint/commit/aec785e33d63b248231c3e68c9aeb792caf21acc"><code>aec785e</code></a>
chore(release): publish 8.46.0</li>
<li><a
href="https://github.com/typescript-eslint/typescript-eslint/commit/5c1a1592ccb21868ddff8543988125af0219f831"><code>5c1a159</code></a>
feat(typescript-eslint): export util types (close <a
href="https://github.com/typescript-eslint/typescript-eslint/tree/HEAD/packages/typescript-eslint/issues/10848">#10848</a>)
(<a
href="https://github.com/typescript-eslint/typescript-eslint/tree/HEAD/packages/typescript-eslint/issues/10849">#10849</a>)</li>
<li>See full diff in <a
href="https://github.com/typescript-eslint/typescript-eslint/commits/v8.46.0/packages/typescript-eslint">compare
view</a></li>
</ul>
</details>
<br />


Dependabot will resolve any conflicts with this PR as long as you don't
alter it yourself. You can also trigger a rebase manually by commenting
`@dependabot rebase`.

[//]: # (dependabot-automerge-start)
[//]: # (dependabot-automerge-end)

---

<details>
<summary>Dependabot commands and options</summary>
<br />

You can trigger Dependabot actions by commenting on this PR:
- `@dependabot rebase` will rebase this PR
- `@dependabot recreate` will recreate this PR, overwriting any edits
that have been made to it
- `@dependabot merge` will merge this PR after your CI passes on it
- `@dependabot squash and merge` will squash and merge this PR after
your CI passes on it
- `@dependabot cancel merge` will cancel a previously requested merge
and block automerging
- `@dependabot reopen` will reopen this PR if it is closed
- `@dependabot close` will close this PR and stop Dependabot recreating
it. You can achieve the same result by closing it manually
- `@dependabot show <dependency name> ignore conditions` will show all
of the ignore conditions of the specified dependency
- `@dependabot ignore <dependency name> major version` will close this
group update PR and stop Dependabot creating any more for the specific
dependency's major version (unless you unignore this specific
dependency's major version or upgrade to it yourself)
- `@dependabot ignore <dependency name> minor version` will close this
group update PR and stop Dependabot creating any more for the specific
dependency's minor version (unless you unignore this specific
dependency's minor version or upgrade to it yourself)
- `@dependabot ignore <dependency name>` will close this group update PR
and stop Dependabot creating any more for the specific dependency
(unless you unignore this specific dependency or upgrade to it yourself)
- `@dependabot unignore <dependency name>` will remove all of the ignore
conditions of the specified dependency
- `@dependabot unignore <dependency name> <ignore condition>` will
remove the ignore condition of the specified dependency and ignore
conditions


</details>

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 package-lock.json | 126 +++++++++++++++++++++++-----------------------
 1 file changed, 63 insertions(+), 63 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 407c26e5..5eb6888e 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -692,9 +692,9 @@
       "license": "MIT"
     },
     "node_modules/@types/node": {
-      "version": "24.7.0",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-24.7.0.tgz",
-      "integrity": "sha512-IbKooQVqUBrlzWTi79E8Fw78l8k1RNtlDDNWsFZs7XonuQSJ8oNYfEeclhprUldXISRMLzBpILuKgPlIxm+/Yw==",
+      "version": "24.7.2",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-24.7.2.tgz",
+      "integrity": "sha512-/NbVmcGTP+lj5oa4yiYxxeBjRivKQ5Ns1eSZeB99ExsEQ6rX5XYU1Zy/gGxY/ilqtD4Etx9mKyrPxZRetiahhA==",
       "devOptional": true,
       "license": "MIT",
       "dependencies": {
@@ -746,17 +746,17 @@
       }
     },
     "node_modules/@typescript-eslint/eslint-plugin": {
-      "version": "8.45.0",
-      "resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-8.45.0.tgz",
-      "integrity": "sha512-HC3y9CVuevvWCl/oyZuI47dOeDF9ztdMEfMH8/DW/Mhwa9cCLnK1oD7JoTVGW/u7kFzNZUKUoyJEqkaJh5y3Wg==",
+      "version": "8.46.0",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-8.46.0.tgz",
+      "integrity": "sha512-hA8gxBq4ukonVXPy0OKhiaUh/68D0E88GSmtC1iAEnGaieuDi38LhS7jdCHRLi6ErJBNDGCzvh5EnzdPwUc0DA==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
         "@eslint-community/regexpp": "^4.10.0",
-        "@typescript-eslint/scope-manager": "8.45.0",
-        "@typescript-eslint/type-utils": "8.45.0",
-        "@typescript-eslint/utils": "8.45.0",
-        "@typescript-eslint/visitor-keys": "8.45.0",
+        "@typescript-eslint/scope-manager": "8.46.0",
+        "@typescript-eslint/type-utils": "8.46.0",
+        "@typescript-eslint/utils": "8.46.0",
+        "@typescript-eslint/visitor-keys": "8.46.0",
         "graphemer": "^1.4.0",
         "ignore": "^7.0.0",
         "natural-compare": "^1.4.0",
@@ -776,16 +776,16 @@
       }
     },
     "node_modules/@typescript-eslint/parser": {
-      "version": "8.45.0",
-      "resolved": "https://registry.npmjs.org/@typescript-eslint/parser/-/parser-8.45.0.tgz",
-      "integrity": "sha512-TGf22kon8KW+DeKaUmOibKWktRY8b2NSAZNdtWh798COm1NWx8+xJ6iFBtk3IvLdv6+LGLJLRlyhrhEDZWargQ==",
+      "version": "8.46.0",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/parser/-/parser-8.46.0.tgz",
+      "integrity": "sha512-n1H6IcDhmmUEG7TNVSspGmiHHutt7iVKtZwRppD7e04wha5MrkV1h3pti9xQLcCMt6YWsncpoT0HMjkH1FNwWQ==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@typescript-eslint/scope-manager": "8.45.0",
-        "@typescript-eslint/types": "8.45.0",
-        "@typescript-eslint/typescript-estree": "8.45.0",
-        "@typescript-eslint/visitor-keys": "8.45.0",
+        "@typescript-eslint/scope-manager": "8.46.0",
+        "@typescript-eslint/types": "8.46.0",
+        "@typescript-eslint/typescript-estree": "8.46.0",
+        "@typescript-eslint/visitor-keys": "8.46.0",
         "debug": "^4.3.4"
       },
       "engines": {
@@ -801,14 +801,14 @@
       }
     },
     "node_modules/@typescript-eslint/project-service": {
-      "version": "8.45.0",
-      "resolved": "https://registry.npmjs.org/@typescript-eslint/project-service/-/project-service-8.45.0.tgz",
-      "integrity": "sha512-3pcVHwMG/iA8afdGLMuTibGR7pDsn9RjDev6CCB+naRsSYs2pns5QbinF4Xqw6YC/Sj3lMrm/Im0eMfaa61WUg==",
+      "version": "8.46.0",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/project-service/-/project-service-8.46.0.tgz",
+      "integrity": "sha512-OEhec0mH+U5Je2NZOeK1AbVCdm0ChyapAyTeXVIYTPXDJ3F07+cu87PPXcGoYqZ7M9YJVvFnfpGg1UmCIqM+QQ==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@typescript-eslint/tsconfig-utils": "^8.45.0",
-        "@typescript-eslint/types": "^8.45.0",
+        "@typescript-eslint/tsconfig-utils": "^8.46.0",
+        "@typescript-eslint/types": "^8.46.0",
         "debug": "^4.3.4"
       },
       "engines": {
@@ -823,14 +823,14 @@
       }
     },
     "node_modules/@typescript-eslint/scope-manager": {
-      "version": "8.45.0",
-      "resolved": "https://registry.npmjs.org/@typescript-eslint/scope-manager/-/scope-manager-8.45.0.tgz",
-      "integrity": "sha512-clmm8XSNj/1dGvJeO6VGH7EUSeA0FMs+5au/u3lrA3KfG8iJ4u8ym9/j2tTEoacAffdW1TVUzXO30W1JTJS7dA==",
+      "version": "8.46.0",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/scope-manager/-/scope-manager-8.46.0.tgz",
+      "integrity": "sha512-lWETPa9XGcBes4jqAMYD9fW0j4n6hrPtTJwWDmtqgFO/4HF4jmdH/Q6wggTw5qIT5TXjKzbt7GsZUBnWoO3dqw==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@typescript-eslint/types": "8.45.0",
-        "@typescript-eslint/visitor-keys": "8.45.0"
+        "@typescript-eslint/types": "8.46.0",
+        "@typescript-eslint/visitor-keys": "8.46.0"
       },
       "engines": {
         "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
@@ -841,9 +841,9 @@
       }
     },
     "node_modules/@typescript-eslint/tsconfig-utils": {
-      "version": "8.45.0",
-      "resolved": "https://registry.npmjs.org/@typescript-eslint/tsconfig-utils/-/tsconfig-utils-8.45.0.tgz",
-      "integrity": "sha512-aFdr+c37sc+jqNMGhH+ajxPXwjv9UtFZk79k8pLoJ6p4y0snmYpPA52GuWHgt2ZF4gRRW6odsEj41uZLojDt5w==",
+      "version": "8.46.0",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/tsconfig-utils/-/tsconfig-utils-8.46.0.tgz",
+      "integrity": "sha512-WrYXKGAHY836/N7zoK/kzi6p8tXFhasHh8ocFL9VZSAkvH956gfeRfcnhs3xzRy8qQ/dq3q44v1jvQieMFg2cw==",
       "dev": true,
       "license": "MIT",
       "engines": {
@@ -858,15 +858,15 @@
       }
     },
     "node_modules/@typescript-eslint/type-utils": {
-      "version": "8.45.0",
-      "resolved": "https://registry.npmjs.org/@typescript-eslint/type-utils/-/type-utils-8.45.0.tgz",
-      "integrity": "sha512-bpjepLlHceKgyMEPglAeULX1vixJDgaKocp0RVJ5u4wLJIMNuKtUXIczpJCPcn2waII0yuvks/5m5/h3ZQKs0A==",
+      "version": "8.46.0",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/type-utils/-/type-utils-8.46.0.tgz",
+      "integrity": "sha512-hy+lvYV1lZpVs2jRaEYvgCblZxUoJiPyCemwbQZ+NGulWkQRy0HRPYAoef/CNSzaLt+MLvMptZsHXHlkEilaeg==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@typescript-eslint/types": "8.45.0",
-        "@typescript-eslint/typescript-estree": "8.45.0",
-        "@typescript-eslint/utils": "8.45.0",
+        "@typescript-eslint/types": "8.46.0",
+        "@typescript-eslint/typescript-estree": "8.46.0",
+        "@typescript-eslint/utils": "8.46.0",
         "debug": "^4.3.4",
         "ts-api-utils": "^2.1.0"
       },
@@ -883,9 +883,9 @@
       }
     },
     "node_modules/@typescript-eslint/types": {
-      "version": "8.45.0",
-      "resolved": "https://registry.npmjs.org/@typescript-eslint/types/-/types-8.45.0.tgz",
-      "integrity": "sha512-WugXLuOIq67BMgQInIxxnsSyRLFxdkJEJu8r4ngLR56q/4Q5LrbfkFRH27vMTjxEK8Pyz7QfzuZe/G15qQnVRA==",
+      "version": "8.46.0",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/types/-/types-8.46.0.tgz",
+      "integrity": "sha512-bHGGJyVjSE4dJJIO5yyEWt/cHyNwga/zXGJbJJ8TiO01aVREK6gCTu3L+5wrkb1FbDkQ+TKjMNe9R/QQQP9+rA==",
       "dev": true,
       "license": "MIT",
       "engines": {
@@ -897,16 +897,16 @@
       }
     },
     "node_modules/@typescript-eslint/typescript-estree": {
-      "version": "8.45.0",
-      "resolved": "https://registry.npmjs.org/@typescript-eslint/typescript-estree/-/typescript-estree-8.45.0.tgz",
-      "integrity": "sha512-GfE1NfVbLam6XQ0LcERKwdTTPlLvHvXXhOeUGC1OXi4eQBoyy1iVsW+uzJ/J9jtCz6/7GCQ9MtrQ0fml/jWCnA==",
+      "version": "8.46.0",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/typescript-estree/-/typescript-estree-8.46.0.tgz",
+      "integrity": "sha512-ekDCUfVpAKWJbRfm8T1YRrCot1KFxZn21oV76v5Fj4tr7ELyk84OS+ouvYdcDAwZL89WpEkEj2DKQ+qg//+ucg==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@typescript-eslint/project-service": "8.45.0",
-        "@typescript-eslint/tsconfig-utils": "8.45.0",
-        "@typescript-eslint/types": "8.45.0",
-        "@typescript-eslint/visitor-keys": "8.45.0",
+        "@typescript-eslint/project-service": "8.46.0",
+        "@typescript-eslint/tsconfig-utils": "8.46.0",
+        "@typescript-eslint/types": "8.46.0",
+        "@typescript-eslint/visitor-keys": "8.46.0",
         "debug": "^4.3.4",
         "fast-glob": "^3.3.2",
         "is-glob": "^4.0.3",
@@ -926,16 +926,16 @@
       }
     },
     "node_modules/@typescript-eslint/utils": {
-      "version": "8.45.0",
-      "resolved": "https://registry.npmjs.org/@typescript-eslint/utils/-/utils-8.45.0.tgz",
-      "integrity": "sha512-bxi1ht+tLYg4+XV2knz/F7RVhU0k6VrSMc9sb8DQ6fyCTrGQLHfo7lDtN0QJjZjKkLA2ThrKuCdHEvLReqtIGg==",
+      "version": "8.46.0",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/utils/-/utils-8.46.0.tgz",
+      "integrity": "sha512-nD6yGWPj1xiOm4Gk0k6hLSZz2XkNXhuYmyIrOWcHoPuAhjT9i5bAG+xbWPgFeNR8HPHHtpNKdYUXJl/D3x7f5g==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
         "@eslint-community/eslint-utils": "^4.7.0",
-        "@typescript-eslint/scope-manager": "8.45.0",
-        "@typescript-eslint/types": "8.45.0",
-        "@typescript-eslint/typescript-estree": "8.45.0"
+        "@typescript-eslint/scope-manager": "8.46.0",
+        "@typescript-eslint/types": "8.46.0",
+        "@typescript-eslint/typescript-estree": "8.46.0"
       },
       "engines": {
         "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
@@ -950,13 +950,13 @@
       }
     },
     "node_modules/@typescript-eslint/visitor-keys": {
-      "version": "8.45.0",
-      "resolved": "https://registry.npmjs.org/@typescript-eslint/visitor-keys/-/visitor-keys-8.45.0.tgz",
-      "integrity": "sha512-qsaFBA3e09MIDAGFUrTk+dzqtfv1XPVz8t8d1f0ybTzrCY7BKiMC5cjrl1O/P7UmHsNyW90EYSkU/ZWpmXelag==",
+      "version": "8.46.0",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/visitor-keys/-/visitor-keys-8.46.0.tgz",
+      "integrity": "sha512-FrvMpAK+hTbFy7vH5j1+tMYHMSKLE6RzluFJlkFNKD0p9YsUT75JlBSmr5so3QRzvMwU5/bIEdeNrxm8du8l3Q==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@typescript-eslint/types": "8.45.0",
+        "@typescript-eslint/types": "8.46.0",
         "eslint-visitor-keys": "^4.2.1"
       },
       "engines": {
@@ -5757,16 +5757,16 @@
       }
     },
     "node_modules/typescript-eslint": {
-      "version": "8.45.0",
-      "resolved": "https://registry.npmjs.org/typescript-eslint/-/typescript-eslint-8.45.0.tgz",
-      "integrity": "sha512-qzDmZw/Z5beNLUrXfd0HIW6MzIaAV5WNDxmMs9/3ojGOpYavofgNAAD/nC6tGV2PczIi0iw8vot2eAe/sBn7zg==",
+      "version": "8.46.0",
+      "resolved": "https://registry.npmjs.org/typescript-eslint/-/typescript-eslint-8.46.0.tgz",
+      "integrity": "sha512-6+ZrB6y2bT2DX3K+Qd9vn7OFOJR+xSLDj+Aw/N3zBwUt27uTw2sw2TE2+UcY1RiyBZkaGbTkVg9SSdPNUG6aUw==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@typescript-eslint/eslint-plugin": "8.45.0",
-        "@typescript-eslint/parser": "8.45.0",
-        "@typescript-eslint/typescript-estree": "8.45.0",
-        "@typescript-eslint/utils": "8.45.0"
+        "@typescript-eslint/eslint-plugin": "8.46.0",
+        "@typescript-eslint/parser": "8.46.0",
+        "@typescript-eslint/typescript-estree": "8.46.0",
+        "@typescript-eslint/utils": "8.46.0"
       },
       "engines": {
         "node": "^18.18.0 || ^20.9.0 || >=21.1.0"

From d97c6462b40f1481e6c08808ae85ab287cf8ec0f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Kie=C5=82bowicz?= <github@kielbowi.cz>
Date: Sun, 12 Oct 2025 16:49:03 +0200
Subject: [PATCH 42/44] docs: add Amp configuration to MCP client setup docs
 (#343)

Tool's website: https://ampcode.com

---------

Co-authored-by: Alex <alexei.rudenko@gmail.com>
---
 README.md | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/README.md b/README.md
index 07f1b7e4..0745ebb0 100644
--- a/README.md
+++ b/README.md
@@ -53,6 +53,16 @@ Add the following config to your MCP client:
 
 ### MCP Client configuration
 
+<details>
+  <summary>Amp</summary>
+  Follow https://ampcode.com/manual#mcp and use the config provided above. You can also install the Chrome DevTools MCP server using the CLI:
+
+```bash
+amp mcp add chrome-devtools -- npx chrome-devtools-mcp@latest
+```
+
+</details>
+
 <details>
   <summary>Claude Code</summary>
     Use the Claude Code CLI to add the Chrome DevTools MCP server (<a href="https://docs.anthropic.com/en/docs/claude-code/mcp">guide</a>):

From 0e5f914dea3125cb5f52c7fc146da15055d673fe Mon Sep 17 00:00:00 2001
From: siegerts <stephen.siegert@gmail.com>
Date: Sun, 12 Oct 2025 11:44:21 -0400
Subject: [PATCH 43/44] docs: add instructions for Kiro (#347)

Adds instructions on how to add Chrome DevTools MCP to
[Kiro](https://kiro.dev).

<img width="706" height="449" alt="image"
src="https://github.com/user-attachments/assets/dab524b9-e684-4726-8f80-bffdfb3197cf"
/>
---
 README.md | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/README.md b/README.md
index 0745ebb0..8d9af355 100644
--- a/README.md
+++ b/README.md
@@ -187,6 +187,15 @@ The same way chrome-devtools-mcp can be configured for JetBrains Junie in `Setti
 
 </details>
 
+<details>
+  <summary>Kiro</summary>
+
+In **Kiro Settings**, go to `Configure MCP` > `Open Workspace or User MCP Config` > Use the configuration snippet provided above.
+
+Or, from the IDE **Activity Bar** > `Kiro` > `MCP Servers` > `Click Open MCP Config`. Use the configuration snippet provided above.
+
+</details>
+
 <details>
   <summary>Visual Studio</summary>
   

From 8034a29aa1392e68c7d5195d12c716ccfffd6b22 Mon Sep 17 00:00:00 2001
From: alinavarkki <alinavarkki@google.com>
Date: Mon, 13 Oct 2025 08:09:38 +0200
Subject: [PATCH 44/44] review changes

---
 src/tools/input.ts | 57 +++++++++++++++++++++++++++++++---------------
 1 file changed, 39 insertions(+), 18 deletions(-)

diff --git a/src/tools/input.ts b/src/tools/input.ts
index 1d595d0f..02bb8a0f 100644
--- a/src/tools/input.ts
+++ b/src/tools/input.ts
@@ -7,7 +7,7 @@
 import type {ElementHandle} from 'puppeteer-core';
 import z from 'zod';
 
-import type {McpContext} from '../McpContext.js';
+import type {McpContext, TextSnapshotNode} from '../McpContext.js';
 
 import {ToolCategories} from './categories.js';
 import {defineTool} from './ToolDefinition.js';
@@ -80,32 +80,53 @@ export const hover = defineTool({
   },
 });
 
-async function fillFormElement(
-  uid: string,
+// The AXNode for an option doesn't contain its `value`. We set text content of the option as value.
+// If the form is a combobox, we need to find the correct option by its text value.
+// To do that, loop through the children while checking which child's text matches the requested value (requested value is actually the text content).
+// When the correct option is found, use the element handle to get the real value.
+async function selectOption(
+  handle: ElementHandle,
+  aXNode: TextSnapshotNode,
   value: string,
-  context: McpContext,
 ) {
-  const handle = await context.getElementByUid(uid);
-  try {
-    // The AXNode for an option doesn't contain its `value`. We set text content of the option as value.
-    // If the form is a combobox, we need to find the correct option by its text value.
-    // To do that, loop through the children while checking which child's text matches the requested value (requested value is actually the text content).
-    // When the correct option is found, use the element handle to get the real value.
-    const aXNode = context.getAXNodeByUid(uid);
-    if (aXNode && aXNode.role === 'combobox' && aXNode.children) {
-      for (const child of aXNode.children) {
-        if (child.role === 'option' && child.name === value && child.value) {
-          const childHandle = await child.elementHandle();
-          if (childHandle) {
-            const childValueHandle = await childHandle.getProperty('value');
+  let optionFound = false;
+  for (const child of aXNode.children) {
+    if (child.role === 'option' && child.name === value && child.value) {
+      optionFound = true;
+      const childHandle = await child.elementHandle();
+      if (childHandle) {
+        try {
+          const childValueHandle = await childHandle.getProperty('value');
+          try {
             const childValue = await childValueHandle.jsonValue();
             if (childValue) {
               await handle.asLocator().fill(childValue.toString());
             }
-            break;
+          } finally {
+            void childValueHandle.dispose();
           }
+          break;
+        } finally {
+          void childHandle.dispose();
         }
       }
+    }
+  }
+  if (!optionFound) {
+    throw new Error(`Could not find option with text "${value}"`);
+  }
+}
+
+async function fillFormElement(
+  uid: string,
+  value: string,
+  context: McpContext,
+) {
+  const handle = await context.getElementByUid(uid);
+  try {
+    const aXNode = context.getAXNodeByUid(uid);
+    if (aXNode && aXNode.role === 'combobox') {
+      await selectOption(handle, aXNode, value);
     } else {
       await handle.asLocator().fill(value);
     }