# e2e

Launches live web and mobile app sessions to inspect UI and test locators. Handy when writing or debugging automated end-to-end tests driven by agents.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 11912
- Author: tester-army
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/tester-army/e2e/tree/HEAD/packages/e2e
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/e2e

## What it does

The server connects the e2e testing framework to coding agents. It lets an assistant launch active web and mobile app sessions, inspect UI screens, and test locators. Inside tests, developers describe goals in natural language so an agent drives the UI, combined with strict locator assertions in the same file.

Once an assertion confirms an agent action, the framework caches the steps. Subsequent test runs replay that recorded flow without calling any AI model, saving tokens until the UI changes. Web testing relies on Playwright across Chromium, Firefox, and WebKit, while mobile suites drive iOS simulators and Android emulators.

The framework is still approaching version 1.0, so minor releases may alter APIs and configurations. You must provide your own API key, account, or local model. By default, the CLI gathers anonymous crash and usage telemetry, which stops via `E2E_TELEMETRY_DISABLED=1` or `npx e2e telemetry disable`.

## Requirements
- Needs: Node.js (commands run via npx)
- Works with: Playwright

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add e2e -- npx -y e2e
```

### Codex

**Platform CLI**
```bash
codex mcp add e2e -- npx -y e2e
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "e2e": {
            "command": "npx",
            "args": [
                "-y",
                "e2e"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "e2e": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "e2e"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add e2e npx -y e2e
```

## When to use it
- inspect live web or mobile UI to verify element locators
- execute natural language test steps on iOS simulators and Android emulators
- record verified agent actions to replay tests without model requests
- bootstrap test suite configuration with `npx e2e init`

## Example prompts
- Open a live web session and find the locator for the Pro plan upgrade button.
- Run the mobile test on an iOS simulator and inspect the invoice preview screen.
- Write an e2e test where the agent navigates to `/settings/billing` and asserts the workspace status.

## Similar
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74559
- [Keploy](https://affpapa.org/en/nevibecode/mcp/keploy.md) — MCP server · ★ 18727
- [SeleniumBase MCP](https://affpapa.org/en/nevibecode/mcp/seleniumbase-mcp.md) — MCP server · ★ 13169
- [mobile-mcp](https://affpapa.org/en/nevibecode/mcp/mobile-mcp.md) — MCP server · ★ 9946
- [mockserver](https://affpapa.org/en/nevibecode/mcp/mockserver.md) — MCP server · ★ 4996
- [XcodeBuildMCP](https://affpapa.org/en/nevibecode/mcp/xcodebuildmcp.md) — MCP server · ★ 6505

From the same set: [tester-army/e2e](https://affpapa.org/en/nevibecode/by/tester-army/e2e.md) — 3 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md