Playwright MCP

Instructions

Implementation Reference

• src/playwright_mcp/server.py:228-235 (handler)

  The handler logic for the 'navigate' tool within the handle_call_tool function. It retrieves the URL from arguments, gets the active page, navigates to the URL using page.goto, and returns a success message.
  if name == "navigate": url = arguments.get("url") if not url: raise ValueError("URL is required") page = get_active_page(arguments.get("page_id")) await page.goto(url) return [types.TextContent(type="text", text=f"Navigated to {url}")]
• src/playwright_mcp/server.py:85-96 (registration)

  Registration of the 'navigate' tool in the list_tools handler, including its name, description, and input schema.
  types.Tool( name="navigate", description="Navigate to a URL", inputSchema={ "type": "object", "properties": { "url": {"type": "string"}, "page_id": {"type": "string"}, }, "required": ["url"], }, ),
• src/playwright_mcp/server.py:200-210 (helper)

  Helper function used by the 'navigate' handler to retrieve the active browser page based on page_id or current default.
  def get_active_page(page_id: Optional[str] = None) -> Page: """Get the active page based on page_id or current default.""" global current_page_id if page_id is None: page_id = current_page_id if page_id not in pages: raise ValueError(f"Page not found: {page_id}") return pages[page_id]