Playwright MCP

Instructions

Implementation Reference

• src/tools/tabs.ts:69-74 (handler)

  Handler function for the 'browser_tab_new' tool. Creates a new tab using context.newTab() and optionally navigates to the provided URL using tab.navigate(), then includes snapshot in response.

  handle: async (context, params, response) => {
    const tab = await context.newTab();
    if (params.url)
      await tab.navigate(params.url);
    response.setIncludeSnapshot();
  },

• src/tools/tabs.ts:59-67 (schema)

  Schema definition for the 'browser_tab_new' tool, specifying name, title, description, optional url input schema, and readOnly type.

  schema: {
    name: 'browser_tab_new',
    title: 'Open a new tab',
    description: 'Open a new tab',
    inputSchema: z.object({
      url: z.string().optional().describe('The URL to navigate to in the new tab. If not provided, the new tab will be blank.'),
    }),
    type: 'readOnly',
  },

• src/tools/tabs.ts:96-101 (registration)

  Registration of the 'browser_tab_new' tool (as newTab) in the exported array of tab tools, which is later included in the central tools list.

  export default [
    listTabs,
    newTab,
    selectTab,
    closeTab,
  ];

• src/tools.ts:36-52 (registration)

  Central registration where tabs tools (including browser_tab_new) are spread into the allTools array.

  export const allTools: Tool<any>[] = [
    ...common,
    ...console,
    ...dialogs,
    ...evaluate,
    ...files,
    ...install,
    ...keyboard,
    ...navigate,
    ...network,
    ...mouse,
    ...pdf,
    ...screenshot,
    ...snapshot,
    ...tabs,
    ...wait,
  ];