Playwright MCP
Path: .cursor/skills/playwright-mcp/SKILL.md
Category: Browser and Automation
Triggers: testing the Fastlane Portal, verifying UI changes, form filling, carrier portal automation, taking screenshots, browser debugging
What It Does
Teaches the agent to use the Playwright MCP server (user-playwright-mcp) for browser interactions. Covers session reuse, snapshot-before-interact patterns, local dev URLs, and tool usage for both the Fastlane Portal and Progressive carrier portal.
This is distinct from the Playwright sub-agent (which writes E2E test code) — this skill is about using Playwright as a browser automation tool during development.
Key Patterns
Snapshot Before Interact
Always take a snapshot before any interaction to get fresh element refs. Refs go stale after navigation or DOM changes.
browser_snapshot → get element refs → browser_click / browser_type / browser_select_option
Tool Usage
| Tool | Purpose |
|---|---|
browser_navigate | Initial page load |
browser_snapshot | Capture current page state and element refs |
browser_click | Click an element by ref |
browser_type | Type into a text input |
browser_select_option | Select from a dropdown |
browser_run_code | Execute arbitrary JavaScript for complex multi-step inspections |
Local Dev URLs
| App | URL |
|---|---|
| Fastlane Portal | http://localhost:4200 |
| DA (Digital Agency) | http://localhost:3000 |
| API Gateway | http://localhost:3333 |
MCP Server
All browser operations use CallMcpTool with server: "user-playwright-mcp". Do not confuse with cursor-ide-browser, which is Cursor's built-in browser MCP — a separate instance.