playwrightselectorguard-mcp — Claude Code MCP server setup
Evaluates Playwright selector risks, provides automated healing recommendations, and tracks approval receipts. Helpful for stabilizing flaky browser tests.
claude mcp add --transport http playwrightselectorguard-mcp https://playwrightselectorguard.clauxel.com/mcpWhat playwrightselectorguard-mcp does
This MCP server links an assistant to an external service dedicated to Playwright selector inspection. It exposes tools including check_selector_risk to spot fragile locators and suggest_selector_healing to formulate safer replacements.
Workflow management includes request_human_approval for operator sign-offs, record_action_receipt to log execution confirmations, and export_selector_failure for debugging broken locators. The endpoint operates over HTTP using Streamable HTTP transport.
Access requires a paid account. Production calls fail with an authorization error unless sent with an API bearer token generated from the product website.
What it helps with
- detect fragile Playwright locators before test execution
- generate resilient replacement selectors for broken elements
- request human operator approval prior to browser actions
- export diagnostics for failed selector evaluations
Example prompts for the agent
- Inspect selectors in
tests/checkout.spec.tsusingcheck_selector_risk - Find a replacement for the broken locator
div > button.primary - Export details for the failed element using
export_selector_failure
How to install playwrightselectorguard-mcp
Platform CLI: remote server
claude mcp add --transport http playwrightselectorguard-mcp https://playwrightselectorguard.clauxel.com/mcpPlatform CLI: remote server
codex mcp add playwrightselectorguard-mcp --url https://playwrightselectorguard.clauxel.com/mcpConfig file
{
"mcpServers": {
"playwrightselectorguard-mcp": {
"url": "https://playwrightselectorguard.clauxel.com/mcp"
}
}
}Config file
{
"servers": {
"playwrightselectorguard-mcp": {
"type": "http",
"url": "https://playwrightselectorguard.clauxel.com/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http playwrightselectorguard-mcp https://playwrightselectorguard.clauxel.com/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about playwrightselectorguard-mcp
How to install playwrightselectorguard-mcp in Claude Code?
Run claude mcp add --transport http playwrightselectorguard-mcp https://playwrightselectorguard.clauxel.com/mcp. You must also configure the bearer token header for production calls.
What does playwrightselectorguard-mcp do?
It audits Playwright selectors for stability risks, suggests fixes, exports failure details, and manages human approval prompts.
Does playwrightselectorguard-mcp require an API token?
Yes, it is a paid hosted endpoint. Any request sent without a valid Authorization: Bearer <token> header returns a JSON error response.
