Browserbase MCP Server

Instructions

Implementation Reference

• src/tools/navigate.ts:19-56 (handler)

  The handler function that executes the tool logic: retrieves stagehand and active page, navigates to the URL, and returns a confirmation message.

  async function handleNavigate(
    context: Context,
    params: NavigateInput,
  ): Promise<ToolResult> {
    const action = async (): Promise<ToolActionResult> => {
      try {
        const stagehand = await context.getStagehand();
        const page = await context.getActivePage();
  
        if (!page) {
          throw new Error("No active page available");
        }
        await page.goto(params.url, { waitUntil: "domcontentloaded" });
  
        const sessionId = stagehand.browserbaseSessionId;
        if (!sessionId) {
          throw new Error("No Browserbase session ID available");
        }
  
        return {
          content: [
            {
              type: "text",
              text: `Navigated to: ${params.url}`,
            },
          ],
        };
      } catch (error) {
        const errorMsg = error instanceof Error ? error.message : String(error);
        throw new Error(`Failed to navigate: ${errorMsg}`);
      }
    };
  
    return {
      action,
      waitForNetwork: false,
    };
  }

• src/tools/navigate.ts:12-17 (schema)

  Tool schema defining the name 'browserbase_stagehand_navigate', description, and input schema (URL). Note: Input schema defined earlier at lines 6-8.

  const navigateSchema: ToolSchema<typeof NavigateInputSchema> = {
    name: "browserbase_stagehand_navigate",
    description: `Navigate to a URL in the browser. Only use this tool with URLs you're confident will work and be up to date. 
      Otherwise, use https://google.com as the starting point`,
    inputSchema: NavigateInputSchema,
  };

• src/tools/navigate.ts:58-64 (registration)

  Creates and exports the navigateTool object, registering the schema and handler.

  const navigateTool: Tool<typeof NavigateInputSchema> = {
    capability: "core",
    schema: navigateSchema,
    handle: handleNavigate,
  };
  
  export default navigateTool;

• src/tools/index.ts:19-27 (registration)

  Includes the navigateTool in the central TOOLS array for overall tool registration.

  export const TOOLS = [
    ...sessionTools,
    navigateTool,
    actTool,
    extractTool,
    observeTool,
    screenshotTool,
    getUrlTool,
  ];

• src/tools/index.ts:1-1 (registration)

  Imports the navigateTool for inclusion in the tools registry.

  import navigateTool from "./navigate.js";