Puppeteer MCP Server

Instructions

Implementation Reference

• index.ts:170-180 (handler)

  Handler implementation for the puppeteer_navigate tool, which navigates the Puppeteer page to the specified URL and returns a success message.

  case "puppeteer_navigate":
    await page.goto(args.url);
    return {
      content: [
        {
          type: "text",
          text: `Navigated to ${args.url}`,
        },
      ],
      isError: false,
    };

• index.ts:19-29 (schema)

  Tool schema definition including name, description, and input schema requiring a 'url' string.

  {
    name: "puppeteer_navigate",
    description: "Navigate to a URL",
    inputSchema: {
      type: "object",
      properties: {
        url: { type: "string" },
      },
      required: ["url"],
    },
  },

• index.ts:459-461 (registration)

  Registration of all tools, including puppeteer_navigate, via the TOOLS array in the ListToolsRequestSchema handler.

  server.setRequestHandler(ListToolsRequestSchema, async () => ({
    tools: TOOLS,
  }));

• index.ts:463-465 (registration)

  Registration of the CallToolRequestSchema handler, which dispatches to the specific tool handler via handleToolCall switch statement.

  server.setRequestHandler(CallToolRequestSchema, async (request) =>
    handleToolCall(request.params.name, request.params.arguments ?? {})
  );