🎭 Playwright MCP Server

A Model Context Protocol (MCP) server that provides browser automation capabilities through Playwright.

⚠️ Authentication Required: All requests must include the x-api-key header with your API key.

🚀 Quick Start

Configuration for Claude Code

Add to your .mcp.json file:

Option 1: Direct API Key (Recommended)

{
  "mcpServers": {
    "playwright": {
      "type": "http",
      "url": "https://playwright.mcp.majewscy.tech/",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}

Option 2: OAuth-style Authentication

{
  "mcpServers": {
    "playwright": {
      "type": "http",
      "url": "https://playwright.mcp.majewscy.tech/"
    }
  }
}

With OAuth-style, the server will use dynamic client registration.

🛠️ Available Tools

navigate_to

Navigate to a URL in the browser

Parameters:

url (string, required) - The URL to navigate to
waitUntil (string, optional) - When to consider navigation succeeded. Options: "load", "domcontentloaded", "networkidle"

Example:

{
  "url": "https://example.com",
  "waitUntil": "networkidle"
}

click

Click on an element

Parameters:

selector (string, required) - CSS selector or text selector for the element
button (string, optional) - Mouse button to use: "left", "right", "middle"
clickCount (number, optional) - Number of clicks

Example:

{
  "selector": "button[type='submit']",
  "button": "left",
  "clickCount": 1
}

type_text

Type text into an input field

Parameters:

selector (string, required) - CSS selector for the input element
text (string, required) - Text to type
delay (number, optional) - Delay between key presses in milliseconds

Example:

{
  "selector": "input[name='username']",
  "text": "john.doe@example.com",
  "delay": 50
}

screenshot

Take a screenshot of the current page

Parameters:

fullPage (boolean, optional) - Capture full scrollable page
selector (string, optional) - Capture specific element

Example:

{
  "fullPage": true
}

get_text

Extract text content from elements

Parameters:

selector (string, required) - CSS selector for elements

Example:

{
  "selector": "h1, .content p"
}

wait_for_selector

Wait for an element to appear

Parameters:

selector (string, required) - CSS selector to wait for
state (string, optional) - State to wait for: "attached", "detached", "visible", "hidden"
timeout (number, optional) - Maximum time to wait in milliseconds

Example:

{
  "selector": ".loading-complete",
  "state": "visible",
  "timeout": 30000
}

evaluate

Execute JavaScript in the page context

Parameters:

expression (string, required) - JavaScript expression to evaluate

Example:

{
  "expression": "document.title"
}

new_page

Create a new browser page/tab

Parameters:

url (string, optional) - Initial URL to navigate to

Example:

{
  "url": "https://example.com"
}

close_page

Close the current page

Parameters: None

🧪 Testing the Server

Test with curl:

curl -X POST https://playwright.mcp.majewscy.tech/ \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "method": "list_tools",
    "params": {},
    "id": 1
  }'

❗ Common Errors

401 Unauthorized: Invalid or missing API key
400 Bad Request: Invalid JSON format
500 Internal Server Error: Server error, check logs

✅ Server Status: Running and ready to accept requests