feat: add disconnect_browser tool

Author: Yevhenii Hyzyla

src/McpContext.ts

@@ -9,6 +9,7 @@ import os from 'node:os';
 import path from 'node:path';
 import {fileURLToPath, pathToFileURL} from 'node:url';
 
+import {disconnectBrowser} from './browser.js';
 import type {TargetUniverse} from './DevtoolsUtils.js';
 import {UniverseManager} from './DevtoolsUtils.js';
 import {HeapSnapshotManager} from './HeapSnapshotManager.js';
@@ -146,6 +147,11 @@ export class McpContext implements Context {
     this.#isolatedContexts.clear();
   }
 
+  async disconnect(): Promise<void> {
+    this.dispose();
+    await disconnectBrowser();
+  }
+
   static async from(
     browser: Browser,
     logger: Debugger,

src/browser.ts

@@ -270,4 +270,16 @@ export async function ensureBrowserLaunched(
   return browser;
 }
 
+export async function disconnectBrowser(): Promise<void> {
+  const current = browser;
+  browser = undefined;
+  if (current?.connected) {
+    try {
+      await current.disconnect();
+    } catch (err) {
+      logger('Error while disconnecting browser', err);
+    }
+  }
+}
+
 export type Channel = 'stable' | 'canary' | 'beta' | 'dev';

src/tools/ToolDefinition.ts

@@ -179,6 +179,7 @@ export type Context = Readonly<{
   isCruxEnabled(): boolean;
   recordedTraces(): TraceResult[];
   storeTraceRecording(result: TraceResult): void;
+  disconnect(): Promise<void>;
   getPageById(pageId: number): ContextPage;
   newPage(
     background?: boolean,

src/tools/connection.ts

@@ -0,0 +1,29 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import {ToolCategory} from './categories.js';
+import {defineTool} from './ToolDefinition.js';
+
+export const disconnectBrowser = defineTool({
+  name: 'disconnect_browser',
+  description:
+    'Release the current connection to Chrome without exiting the MCP server. ' +
+    'The next tool call will reconnect using the original startup options ' +
+    '(autoConnect, --browserUrl, --wsEndpoint, or launch). ' +
+    'Useful for revoking remote-debugging permission cleanly or resetting MCP state.',
+  annotations: {
+    category: ToolCategory.NAVIGATION,
+    readOnlyHint: false,
+  },
+  schema: {},
+  blockedByDialog: false,
+  handler: async (_request, response, context) => {
+    await context.disconnect();
+    response.appendResponseLine(
+      'Browser connection released. The next tool call will reconnect.',
+    );
+  },
+});

src/tools/tools.ts

@@ -6,6 +6,7 @@
 
 import type {ParsedArguments} from '../bin/chrome-devtools-mcp-cli-options.js';
 
+import * as connectionTools from './connection.js';
 import * as consoleTools from './console.js';
 import * as emulationTools from './emulation.js';
 import * as extensionTools from './extensions.js';
@@ -28,6 +29,7 @@ export const createTools = (args: ParsedArguments) => {
   const rawTools = args.slim
     ? Object.values(slimTools)
     : [
+        ...Object.values(connectionTools),
         ...Object.values(consoleTools),
         ...Object.values(emulationTools),
         ...Object.values(extensionTools),