Puppeteer MCP Server

✅ Server is running
🔐 Authentication Required
This API requires an API key for access.

About

This is a Model Context Protocol (MCP) server that provides browser automation capabilities through Puppeteer.

📧 API Key Access
To request an API key for this service, please contact:
bartosz.dariusz.majewski@gmail.com

API Endpoint

POST requests to: https://puppeteer.mcp.majewscy.tech/

🔑 Required HTTP Headers

For MCP authentication:

x-api-key

Your server authentication key (contact us for access)

🧪 Test Your Connection

1. List Available Tools

curl -X POST https://puppeteer.mcp.majewscy.tech/ \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_SERVER_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/list",
    "id": 1
  }'

2. Navigate to a URL

curl -X POST https://puppeteer.mcp.majewscy.tech/ \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_SERVER_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "navigate_to",
      "arguments": {
        "url": "https://example.com"
      }
    },
    "id": 2
  }'

3. Take a Screenshot

curl -X POST https://puppeteer.mcp.majewscy.tech/ \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_SERVER_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "screenshot",
      "arguments": {
        "fullPage": true
      }
    },
    "id": 3
  }'

🔧 Configuration Examples

Claude Code (.mcp.json)

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

Available Tools

🌐 Navigation & Page Control

  • navigate_to - Navigate to a URL
  • go_back - Navigate back in history
  • go_forward - Navigate forward in history
  • reload - Reload the current page
  • wait - Wait for specified time

📸 Screen Capture

  • screenshot - Take a screenshot
  • screenshot_element - Screenshot specific element

🖱️ Interaction

  • click - Click on an element
  • type - Type text into an element
  • select - Select from dropdown
  • hover - Hover over element
  • scroll - Scroll the page

📝 Content Extraction

  • get_content - Get page text content
  • get_html - Get page HTML
  • evaluate - Execute JavaScript
  • get_cookies - Get browser cookies

❌ Common Errors

Invalid API Key

{"jsonrpc":"2.0","id":1,"error":{"code":-32001,"message":"Invalid API Key"}}

Solution: Check your x-api-key header value

Navigation Timeout

{"jsonrpc":"2.0","id":1,"error":{"code":-32603,"message":"Navigation timeout"}}

Solution: The page took too long to load. Try increasing timeout or check the URL.

Health Check

GET /health - Returns server status (no authentication required)