refactor: rename --experimental-page-id-routing to --page-id-routing

Per reviewer feedback: drop the experimental prefix, remove hidden: true,
set default to true so pageId routing is on by default. Users can opt out
with --no-page-id-routing. Flag is kept as an opt-out toggle in case
token overhead is unacceptable or routing does not work as expected.

Author: bcfmtolgahan

docs/tool-reference.md

@@ -352,7 +352,6 @@ so returned values have to be JSON-serializable.
 }`
 
 - **args** (array) _(optional)_: An optional list of arguments to pass to the function.
-- **pageId** (number) _(optional)_: Targets a specific page by ID. Use [`list_pages`](#list_pages) to get available page IDs. If omitted, operates on the most recently selected page.
 
 ---
 

src/bin/chrome-devtools-mcp-cli-options.ts

@@ -147,11 +147,11 @@ export const cliOptions = {
     type: 'boolean',
     description: `If enabled, ignores errors relative to self-signed and expired certificates. Use with caution.`,
   },
-  experimentalPageIdRouting: {
+  pageIdRouting: {
     type: 'boolean',
     describe:
-      '(Deprecated, now always enabled) pageId is always exposed on page-scoped tools.',
-    hidden: true,
+      'Expose pageId on page-scoped tools and route requests by page ID. Use --no-page-id-routing to disable.',
+    default: true,
   },
   experimentalDevtools: {
     type: 'boolean',

src/bin/chrome-devtools.ts

@@ -44,7 +44,6 @@ delete startCliOptions.autoConnect;
 delete startCliOptions.viewport;
 // CLI is generated based on the default tool definitions. To enable conditional
 // tools, they need to be enabled during CLI generation.
-delete startCliOptions.experimentalPageIdRouting;
 delete startCliOptions.experimentalVision;
 delete startCliOptions.experimentalInteropTools;
 delete startCliOptions.experimentalScreencast;

src/index.ts

@@ -165,7 +165,10 @@ export async function createMcpServer(
       return;
     }
     const schema =
-      'pageScoped' in tool && tool.pageScoped && !serverArgs.slim
+      'pageScoped' in tool &&
+      tool.pageScoped &&
+      serverArgs.pageIdRouting &&
+      !serverArgs.slim
         ? {...tool.schema, ...pageIdSchema}
         : tool.schema;
 
@@ -190,7 +193,7 @@ export async function createMcpServer(
             : new McpResponse(serverArgs);
           if ('pageScoped' in tool && tool.pageScoped) {
             const page =
-              params.pageId && !serverArgs.slim
+              serverArgs.pageIdRouting && params.pageId && !serverArgs.slim
                 ? context.getPageById(params.pageId)
                 : context.getSelectedMcpPage();
             response.setPage(page);

src/tools/script.ts

@@ -46,7 +46,7 @@ Example with arguments: \`(el) => {
         )
         .optional()
         .describe(`An optional list of arguments to pass to the function.`),
-      ...pageIdSchema,
+      ...(cliArgs?.pageIdRouting ? pageIdSchema : {}),
       ...(cliArgs?.categoryExtensions
         ? {
             serviceWorkerId: zod
@@ -81,7 +81,7 @@ Example with arguments: \`(el) => {
         return;
       }
 
-      const mcpPage = request.params.pageId
+      const mcpPage = cliArgs?.pageIdRouting
         ? context.getPageById(request.params.pageId)
         : context.getSelectedMcpPage();
       const page: Page = mcpPage.pptrPage;