Playwright MCP Server
by tomscoppock
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PORT | No | Port the server listens on | 8000 |
| HEADLESS | No | Set to false to show the browser window (local dev only) | true |
| MCP_API_KEY | Yes | Secret key for x-api-key header authentication. The server will return 500 on all requests if this is not set. | |
| SSL_KEYFILE | No | Path to TLS private key file. Only used when ENABLE_HTTPS=true. | /app/certs/server.key |
| ENABLE_HTTPS | No | Set to true to serve over HTTPS using a self-signed certificate (baked into the Docker image). | false |
| MAX_SESSIONS | No | Maximum number of concurrent browser sessions. When the limit is reached, the oldest idle session is evicted to make room. | 10 |
| SSL_CERTFILE | No | Path to TLS certificate file. Only used when ENABLE_HTTPS=true. | /app/certs/server.crt |
| UVICORN_WORKERS | No | Number of uvicorn workers. Keep at 1 (Playwright state is in-process). Scale horizontally with container replicas. | 1 |
| DOCKER_HOST_PORT | No | Host port used by scripts/start-docker.ps1 for the Docker port mapping. | 3010 |
| ACTION_TIMEOUT_MS | No | Maximum time (ms) to wait for element actions (click, fill, etc.). | 10000 |
| OTEL_SERVICE_NAME | No | Service name shown in trace backends (Splunk APM, Jaeger, etc.). | playwright-mcp |
| NAVIGATION_TIMEOUT_MS | No | Maximum time (ms) to wait for page navigation (e.g. page.goto). Increase for slow sites. | 30000 |
| SESSION_IDLE_TIMEOUT_S | No | Seconds a session can sit idle before automatic eviction (default 10 minutes). | 600 |
| OTEL_RESOURCE_ATTRIBUTES | No | Extra resource attributes as key=value,key=value (e.g. deployment.environment=dev). | |
| OTEL_EXPORTER_OTLP_ENDPOINT | No | OTLP/HTTP endpoint for the OTel Collector (e.g. http://localhost:4318). When set, traces are exported via OTLP. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Server capabilities have not been inspected yet.
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
No tools | |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo issues