# Playwright E2E MCP

> Playwright E2E MCP is an open-source MCP server for browser automation. Finds why Playwright tests fail, proposes fixes and verifies them before keeping the edit. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, macOS, Windows, Linux
- **Repository:** https://github.com/xsignon-secure/e2e
- **MCP Registry name:** io.github.xsignon-secure/E2E
- **Categories:** browser automation, developer tools
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add e2e -- npx -y playwright-e2e-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "e2e": {
      "command": "npx",
      "args": [
        "-y",
        "playwright-e2e-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "e2e": {
      "command": "npx",
      "args": [
        "-y",
        "playwright-e2e-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "e2e": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "playwright-e2e-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "e2e": {
      "command": "npx",
      "args": [
        "-y",
        "playwright-e2e-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "e2e": {
      "command": "npx",
      "args": [
        "-y",
        "playwright-e2e-mcp"
      ]
    }
  }
}
```

## Tools

- `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.

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Browser Use](https://ai-powered.com/mcp/browser-use): Browser Use is a freemium MCP server for browser automation.
- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/playwright-e2e-mcp
