Playwright Web MCP

General-purpose web automation MCP server built on FastMCP v3 and @playwright/mcp.

Gives Claude browser automation capabilities over HTTP — navigate websites, fill forms, extract data, and interact with any web application.

Architecture

Claude.ai / Cowork Plugin
    │  Streamable HTTP
    ▼
FastMCP v3 (Python)
    │
    ├── 70+ playwright_* tools (proxied via subprocess)
    ├── 19 web_* orchestration tools
    ├── 1 browser_wait_for wrapper
    └── Skills (MCP resources)

Tools

Web Automation (custom orchestration)

Tool	Purpose
web_login	Navigate to login page, discover form fields (auto_fill option)
web_check_auth_state	Check if user is authenticated
web_navigate_and_wait	Navigate + SPA-aware content waiting
web_wait_for_ready	Wait for page content after any action
web_discover_navigation	Identify menus, tabs, pagination
web_extract_table	Extract table data (rows/csv/markdown, DOM mode)
web_extract_page_data	Extract targeted page content
web_extract_links	Extract links via DOM (structured data)
web_discover_form	Identify form fields, types, refs
web_fill_form	Batch-fill form fields
web_search	Search Google/DuckDuckGo with filters
web_search_and_extract	Search + multi-page content extraction
web_extract_article	Clean article text via DOM parsing
web_extract_metadata	Page metadata (OG, JSON-LD, meta tags)
web_save_pdf	Save page as PDF
web_save_session	Save browser session state
web_load_session	Restore saved session
web_execute_js	Run JavaScript with error handling
web_extract_structured_data	CSS selector-based data extraction

Playwright Primitives (proxied)

All 70+ @playwright/mcp tools are available with a playwright_ prefix: playwright_browser_navigate, playwright_browser_snapshot, playwright_browser_click, playwright_browser_type, playwright_browser_take_screenshot, and more.

Utility

Tool	Purpose
browser_wait_for	Type-safe wrapper for playwright_browser_wait_for

Deployment

Railway (production)

The server deploys to Railway via Dockerfile. Set these environment variables:

Variable	Required	Default	Description
PORT	No	Set by Railway	HTTP port
HOST	No	0.0.0.0	Bind address
OAUTH_CLIENT_ID	No	—	OAuth client ID (omit to disable auth)
OAUTH_CLIENT_SECRET	No	—	OAuth client secret
OAUTH_AUTHORIZATION_ENDPOINT	No	Google OIDC	Authorization endpoint
OAUTH_TOKEN_ENDPOINT	No	Google OIDC	Token endpoint
BASE_URL	No	http://127.0.0.1:8000	Server public URL (for OAuth redirects)

Local development

# Install dependencies
uv sync

# Start server
uv run python src/server.py
# → http://localhost:8000/health

Docker

docker build -t playwright-web-mcp .
docker run -p 8000:8000 playwright-web-mcp

Usage

Claude.ai Custom Connector

Add as a Custom Connector in Claude.ai Project settings:

• URL: https://<your-app>.railway.app/mcp
• Auth: OAuth 2.1 (if configured)

Cowork Plugin

Reference the MCP endpoint in your plugin's .mcp.json:

{
  "mcpServers": {
    "web": {
      "url": "https://<your-app>.railway.app/mcp"
    }
  }
}

Development

# Run tests
uv run pytest

# Lint
uv run ruff check src/

# Type check
uv run ruff format --check src/

License

Internal use — Fourth Enterprises.