playwright_navigate

Navigate to a specified URL in a browser with configurable viewport settings, timeout, and wait conditions for web automation tasks.

Instructions

Navigate to a URL

Input Schema

TableJSON Schema

Name	Required	Description
`url`	Yes
`width`	No	Viewport width in pixels (default: 1920)
`height`	No	Viewport height in pixels (default: 1080)
`timeout`	No	Navigation timeout in milliseconds
`waitUntil`	No	Navigation wait condition

Implementation Reference

src/toolsHandler.ts:86-107 (handler)

Handler function for the playwright_navigate tool, performs page navigation using Playwright's goto method.

case "playwright_navigate":
  try {
    await page!.goto(args.url, {
      timeout: args.timeout || 30000,
      waitUntil: args.waitUntil || "load"
    });
    return {
      content: [{
        type: "text",
        text: `Navigated to ${args.url}`,
      }],
      isError: false,
    };
  } catch (error) {
    return {
      content: [{
        type: "text",
        text: `Navigation failed: ${(error as Error).message}`,
      }],
      isError: true,
    };
  }

src/tools.ts:5-19 (schema)

Input schema definition for the playwright_navigate tool, specifying parameters like url, viewport size, timeout, and waitUntil.

{
  name: "playwright_navigate",
  description: "Navigate to a URL",
  inputSchema: {
    type: "object",
    properties: {
      url: { type: "string" },
      width: { type: "number", description: "Viewport width in pixels (default: 1920)" },
      height: { type: "number", description: "Viewport height in pixels (default: 1080)" },
      timeout: { type: "number", description: "Navigation timeout in milliseconds" },
      waitUntil: { type: "string", description: "Navigation wait condition" }
    },
    required: ["url"],
  },
},

src/requestHandler.ts:60-62 (registration)
Registers the list tools request handler, which returns the array of tool definitions including playwright_navigate.
```
server.setRequestHandler(ListToolsRequestSchema, async () => ({
  tools: tools,
}));
```
src/requestHandler.ts:65-67 (registration)
Registers the call tool request handler, which dispatches to the specific tool handler based on name, including playwright_navigate.
```
server.setRequestHandler(CallToolRequestSchema, async (request) =>
  handleToolCall(request.params.name, request.params.arguments ?? {}, server)
);
```

src/tools.ts:156-164 (helper)

Helper array listing browser-requiring tools, including playwright_navigate, used to conditionally launch the browser.

export const BROWSER_TOOLS = [
  "playwright_navigate",
  "playwright_screenshot",
  "playwright_click",
  "playwright_fill",
  "playwright_select",
  "playwright_hover",
  "playwright_evaluate"
];

MCP Playwright CDP