Playwright MCP

Instructions

Implementation Reference

• src/tools/navigate.ts:33-39 (handler)

  Handler function that ensures a tab exists, navigates to the provided URL, includes a snapshot in the response, and adds the equivalent Playwright code snippet.

  handle: async (context, params, response) => {
    const tab = await context.ensureTab();
    await tab.navigate(params.url);
  
    response.setIncludeSnapshot();
    response.addCode(`await page.goto('${params.url}');`);
  },

• src/tools/navigate.ts:23-31 (schema)

  Tool schema defining the name 'browser_navigate', input with 'url' string parameter, marked as destructive.

  schema: {
    name: 'browser_navigate',
    title: 'Navigate to a URL',
    description: 'Navigate to a URL',
    inputSchema: z.object({
      url: z.string().describe('The URL to navigate to'),
    }),
    type: 'destructive',
  },

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

  Registration of all tools in allTools array by importing and spreading modules including navigate.ts which defines browser_navigate.

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

• src/browserServerBackend.ts:50-50 (registration)

  BrowserServerBackend constructor loads the filtered list of tools from tools.ts, registering browser_navigate among others for the MCP server.

  this._tools = filteredTools(config);