Setup
Playwright MCP is self-hosted. You run the server yourself and point Proliferate to it.- Start the Playwright MCP server:
- In Proliferate, go to Integrations and find Playwright
- Click Connect and enter your server URL (e.g.,
http://your-host:8931) - Click Save — Proliferate will test the connection automatically
By default the server runs headed (visible browser). Use
--headless for server environments. Use --browser chrome|firefox|webkit to select a browser engine.Available tools
| Tool | Description |
|---|---|
browser_navigate | Navigate to a URL |
browser_navigate_back | Go back in browser history |
browser_click | Click an element (by accessibility ref) |
browser_type | Type text into an element |
browser_fill_form | Fill multiple form fields at once |
browser_select_option | Select a dropdown option |
browser_hover | Hover over an element |
browser_drag | Drag and drop |
browser_press_key | Press a keyboard key |
browser_file_upload | Upload files |
browser_handle_dialog | Handle JavaScript alert/confirm/prompt dialogs |
browser_evaluate | Execute arbitrary JavaScript in the page |
browser_snapshot | Get the accessibility tree of the page |
browser_take_screenshot | Capture a screenshot |
browser_console_messages | Get browser console logs |
browser_network_requests | Get network request logs |
browser_tabs | List and manage browser tabs |
browser_resize | Resize the browser window |
browser_wait_for | Wait for conditions (element, text, URL) |
browser_close | Close the browser |
--caps flags: browser_pdf_save (pdf), coordinate-based mouse tools (vision), browser_generate_locator and assertion tools (testing).
Use cases
- Run E2E smoke tests after deployments — navigate the app, fill forms, and verify key pages
- Verify preview URLs after PR deploys by navigating to them and checking the page renders
- Automate interactions with third-party dashboards that lack APIs
- Take screenshots of pages for visual regression checks
The tools listed above may not be exhaustive and can change as Playwright updates their MCP server. See Playwright MCP on GitHub for the latest.