
Playwright E2E MCP
Finds why Playwright tests fail, proposes fixes and verifies them before keeping the edit
- Pricing
- Open source
- Platforms
- CLI, self-hosted, macOS
- Runs
- Locally
- Version
- 0.16.2
- Listing updated
- 2 days ago
About Playwright E2E MCP
Playwright E2E MCP is an open-source MCP server for browser automation. It runs locally on your machine and is started by your AI client.
Playwright E2E MCP is built for the moment a test goes red and an agent would otherwise guess a new selector. It runs tests or loads a CI report, reads the page as it was at failure from the trace, suggests a fix, applies it, reruns the test and reverts the edit if it is still failing. When the element is really gone, it reports an application bug instead of patching the test, and a heal guard blocks fixes that go green by asserting less.
It supports TypeScript and Python (pytest-playwright) suites, locally and in CI, and works with Claude Code, Cursor, VS Code, Codex, Gemini and others. A core-only mode trims the tool set to seven tools to cut context cost. A hosted Streamable HTTP bridge exists for remote-only clients, with page tools only.
The README says it is free, MIT licensed and needs no account, with Node.js 22 or newer and a Playwright project.
Install
Run in a terminal
claude mcp add e2e -- npx -y playwright-e2e-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"e2e": {
"command": "npx",
"args": [
"-y",
"playwright-e2e-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"e2e": {
"command": "npx",
"args": [
"-y",
"playwright-e2e-mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"e2e": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"playwright-e2e-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"e2e": {
"command": "npx",
"args": [
"-y",
"playwright-e2e-mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"e2e": {
"command": "npx",
"args": [
"-y",
"playwright-e2e-mcp"
]
}
}
}Tools this server provides (5)
Taken from the project documentation; the running server may differ.
- run-test
- Runs a Playwright test.
- load-report
- Loads a CI report.
- get-failure
- Returns the DOM, requests and console at the point of failure.
- suggest-fix
- Proposes a locator proven on the page.
- check-test-change
- Blocks fixes that check less.
What it does
- Trace-based diagnosis
- Reads the DOM, requests and console from the failure moment.
- Verified fixes
- Applies a fix, reruns, and reverts if it still fails.
- Heal guard
- Blocks fixes that pass by checking less.
- Flaky verdicts
- Reports on flaky tests alongside failures.
- TypeScript and Python
- Works with Playwright Test and pytest-playwright.
- One-command setup
- npx playwright-e2e-mcp init configures detected clients.
Good for
- Fix a failing checkout test after a UI change
- Triage a CI report full of failures
- Tell a real app bug from a stale selector
- Stop an agent weakening assertions to get green
Pricing
Open source
MIT licence
Playwright E2E MCP FAQ
What does it need?
Node.js 22 or newer and a project with @playwright/test or pytest-playwright and a browser.
Is it free?
The README states it is free, MIT licensed, with no account.
Can it use remote-only clients like ChatGPT?
A hosted HTTP bridge can be deployed on Vercel, but running your own tests needs the local install.
How do I reduce token use?
Install with --tools=core for the seven-tool fix loop.
Is Playwright E2E MCP free?
Yes. Playwright E2E MCP is open source, so you can use and self-host it for free.
How do I add Playwright E2E MCP to Claude Code?
Run this command in your terminal: claude mcp add e2e -- npx -y playwright-e2e-mcp
What are the best alternatives to Playwright E2E MCP?
The closest alternatives to Playwright E2E MCP are REA, Browser Use, Scrapling MCP Server, Codebase Memory and GitHub.
Alternatives to Playwright E2E MCP

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Browser Use
MCP serverBrowser agents and cloud browsers for AI, with an MCP server for web tasks
- 7 tools
- Remote
- Freemium
- 121K GitHub stars
- Browser automation

Scrapling MCP Server
MCP serverMCP server for AI clients to scrape sites with HTTP and stealth browser sessions
Runs locally- 17 tools
- Open source
- 104K GitHub stars
- Web search and scraping

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools