# TestivAI

TestivAI gives coding agents structured visual-regression evidence, including verdicts and diff images. Use it when UI changes need review beyond the DOM.

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

## What it does

TestivAI reads visual test output from `visual-report/results.json` and exposes it to coding agents through MCP. It can summarize snapshot verdicts, group related changes, show the report location, and return baseline, current, and diff images. Snapshot explanations include pixel regions, DOM and computed-style signals, capture environment, and asset-loading health.

The server provides tools such as `get_visual_results`, `explain_snapshot`, `get_report`, `get_diff`, `list_baselines`, `approve_snapshot`, and `approve_all`. It also includes the `review-visual-changes` and `triage-visual-diff` prompts. Setup uses `npx`, and no API key is required. A person must confirm an approval before a capture becomes a committed baseline, because an agent approving its own change could preserve a regression.

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

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mcp -- npx -y @testivai/mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add mcp -- npx -y @testivai/mcp
```

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add mcp npx -y @testivai/mcp
```

## When to use it
- review UI changes after a code edit
- separate rendering drift from a real visual change
- inspect a snapshot with readable diff crops
- trace a failed stylesheet or web-font capture
- promote a reviewed capture to the baseline

## Example prompts
- Run `review-visual-changes` on the visual test results and give me a recommendation for each snapshot.
- Use `triage-visual-diff` to classify every diff and missing baseline, then state the next action.
- Show the images and explain the snapshot where the DOM stayed the same but the visual result changed.

## Similar
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74569
- [Keploy](https://affpapa.org/en/nevibecode/mcp/keploy.md) — MCP server · ★ 18779
- [SeleniumBase MCP](https://affpapa.org/en/nevibecode/mcp/seleniumbase-mcp.md) — MCP server · ★ 13181
- [mobile-mcp](https://affpapa.org/en/nevibecode/mcp/mobile-mcp.md) — MCP server · ★ 10025
- [e2e](https://affpapa.org/en/nevibecode/mcp/e2e.md) — MCP server · ★ 11962
- [mockserver](https://affpapa.org/en/nevibecode/mcp/mockserver.md) — MCP server · ★ 4999

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