Skip to content
MCP server

Playwright E2E MCP

Finds why Playwright tests fail, proposes fixes and verifies them before keeping the edit

Runs locallyStatus and history
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-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "e2e": {
      "command": "npx",
      "args": [
        "-y",
        "playwright-e2e-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "e2e": {
      "command": "npx",
      "args": [
        "-y",
        "playwright-e2e-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Browser Use

    MCP server

    Browser agents and cloud browsers for AI, with an MCP server for web tasks

    • 7 tools
    • Remote
    • Freemium
    • 121K GitHub stars
    • Browser automation
  3. MCP 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
  4. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  5. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  6. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools