Browser Agent MCP

Instructions

Implementation Reference

• src/executor.ts:248-274 (handler)

  Executes the browser navigation by calling page.goto with the provided URL, timeout, and waitUntil options. Returns success or error message.

  async function handleBrowserNavigate(page: Page, args: any): Promise<{ toolResult: CallToolResult }> {
    try {
      await page.goto(args.url, {
        timeout: args.timeout || 30000,
        waitUntil: args.waitUntil || "load"
      });
      return {
        toolResult: {
          content: [{
            type: "text",
            text: `Navigated to ${args.url}`,
          }],
          isError: false,
        },
      };
    } catch (error) {
      return {
        toolResult: {
          content: [{
            type: "text",
            text: `Navigation failed: ${(error as Error).message}`,
          }],
          isError: true,
        },
      };
    }
  }

• src/tools.ts:37-53 (schema)

  Defines the tool name, description, and input schema requiring 'url' with optional 'timeout' and 'waitUntil' parameters.

  {
    name: "browser_navigate",
    description: "Navigate to a specific URL",
    inputSchema: {
      type: "object",
      properties: {
        url: { type: "string", description: "URL to navigate to" },
        timeout: { type: "number", description: "Navigation timeout in milliseconds" },
        waitUntil: { 
          type: "string", 
          description: "Navigation wait criteria",
          enum: ["load", "domcontentloaded", "networkidle", "commit"]
        }
      },
      required: ["url"]
    }
  },

• src/executor.ts:188-189 (registration)

  Registers the dispatch for 'browser_navigate' tool calls to the specific handler function within the main executeToolCall switch statement.

  case "browser_navigate":
    return await handleBrowserNavigate(activePage!, args);