UI Verify — Claude Code MCP server: what it does, how to install
Hosted visual regression testing service for coding agents. Helps triage UI screenshot diffs and accept updated baselines during code review.
claude mcp add --transport http uiverify https://uiverify.ai/mcpWhat UI Verify does
This MCP server links your coding agent to a cloud visual regression engine. It compares rendered component states against default branch baselines. The system processes Storybook bundles, Playwright and Vitest browser DOM archives, or directories of raw PNG snapshots from mobile test runs.
The agent interacts with builds via tools like get_build, render_diff_image, and accept_build. This lets it filter out visual noise, inspect pixel diffs, and approve baselines directly in the session. Mid-edit checks via uiverify check allow testing specific stories against cloud baselines without triggering CI checks.
Running checks requires a valid UIVERIFY_API_KEY from uiverify.ai. Without access to https://uiverify.ai/mcp, the agent cannot fetch render states or accept build baselines.
What it helps with
- triage pull request visual diffs directly from an agent
- test component rendering against baselines before pushing code
- verify raw mobile app screenshot directories against baselines
- accept approved snapshot updates without opening the web dashboard
Example prompts for the agent
- Inspect the visual regression diffs for this PR using UI Verify.
- Run uiverify check on the button stories and summarize layout changes.
- Approve the new visual baseline for the profile screen using accept_build.
How to install UI Verify
Platform CLI: remote server
claude mcp add --transport http uiverify https://uiverify.ai/mcpPlatform CLI: remote server
codex mcp add ui-verify --url https://uiverify.ai/mcpConfig file
{
"mcpServers": {
"ui-verify": {
"url": "https://uiverify.ai/mcp"
}
}
}Config file
{
"servers": {
"ui-verify": {
"type": "http",
"url": "https://uiverify.ai/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http ui-verify https://uiverify.ai/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about UI Verify
How to install UI Verify in Claude Code?
Run claude mcp add --transport http uiverify https://uiverify.ai/mcp in your terminal. You will also need to configure the UIVERIFY_API_KEY environment variable.
What does UI Verify do?
It gives your coding agent tools to retrieve build diffs, render visual comparison images, and approve new visual baselines straight from the command line.
What test runners and inputs are supported?
The service accepts Storybook static builds, Playwright and Vitest test archives using dedicated SDK packages, and folders with finished PNG images.
