Playwright Vision MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PORT | No | HTTP server port | 4201 |
| BROWSER_TYPE | No | Browser engine to use (chromium, firefox, webkit) | chromium |
| MCP_AUTH_TOKEN | No | Authentication token for HTTP server (optional) | |
| OPENAI_API_KEY | No | OpenAI API key (required for analyze_image tool) | |
| SCREENSHOT_DIR | No | Directory for saving screenshots | ./screenshots |
| OPENAI_BASE_URL | No | Optional custom base URL for OpenAI-compatible APIs | https://api.openai.com/v1 |
| OPENAI_VISION_MODEL | No | Vision model for analyze_image tool | gpt-4.1-mini |
| PLAYWRIGHT_HEADLESS | No | Run browser in headless mode (true/false) | true |
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
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| navigate_urlC | Navigate to a URL using a server-managed session and analyze sections and internal links |
| click_elementB | Click on elements using the server-managed session |
| get_contentB | Extract content from the page using the server-managed session |
| close_sessionA | Close all browser sessions managed by the server and clear current session |
| run_playwrightA | Execute custom async Playwright code using the server-managed session |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 5 tools
Each tool has a distinct role—navigate, click, extract content, close session, and run custom code. The run_playwright tool is a flexible escape hatch but clearly marked as executing arbitrary Playwright code, so it does not create confusion with the other specific tools.
All tool names follow a consistent verb_noun pattern in snake_case: navigate_url, click_element, get_content, close_session, run_playwright. This makes the API predictable and easy to navigate.
With 5 tools, the server is well-scoped for browser automation. It covers navigation, interaction, content extraction, session management, and a custom code option without unnecessary bloat.
The surface covers core operations like navigation, clicking, and content extraction, but misses common browser actions such as typing text, waiting for elements, or taking screenshots. The run_playwright tool can fill these gaps, but that requires custom code instead of dedicated tools.