Playwright MCP

Instructions

Implementation Reference

• src/playwright_mcp/server.py:291-303 (handler)

  Handler for the 'new_page' tool. Validates the provided page_id, creates a new Playwright page using the browser context, stores it in the global pages dictionary, sets it as the current page, and returns a confirmation message.

  elif name == "new_page":
      page_id = arguments.get("page_id")
      if not page_id:
          raise ValueError("Page ID is required")
          
      if page_id in pages:
          raise ValueError(f"Page ID '{page_id}' already exists")
          
      new_page = await context.new_page()
      pages[page_id] = new_page
      current_page_id = page_id
      
      return [types.TextContent(type="text", text=f"Created new page with ID: {page_id}")]

• src/playwright_mcp/server.py:155-165 (registration)

  Registration of the 'new_page' tool in the list_tools handler, including its schema definition which requires a 'page_id' string.

  types.Tool(
      name="new_page",
      description="Create a new browser page",
      inputSchema={
          "type": "object",
          "properties": {
              "page_id": {"type": "string"},
          },
          "required": ["page_id"],
      },
  ),