BrowserCat MCP Server

Instructions

Implementation Reference

• index.ts:171-179 (handler)

  Executes the browsercat_navigate tool by navigating the Puppeteer page to the provided URL and returning a success text message.

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

• index.ts:29-39 (schema)

  Defines the tool schema for browsercat_navigate, including name, description, and input schema requiring a 'url' string property.

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

• index.ts:421-423 (registration)

  Registers the list of available tools, including browsercat_navigate, for the ListToolsRequestSchema.

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

• index.ts:425-427 (registration)

  Registers the general tool call handler that dispatches to specific tool implementations based on the tool name.

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