• UPDATED
  • STABLE
  • HUMAN
  • SYNCED

How to approve visual regression builds with your AI

Connect Percy to your agent to manage visual testing without leaving your chat window. You can review changes and update baselines through simple text commands.

Ask AI about this page

Short answer

Can I approve Percy builds using my AI?

Yes. You can list snapshots, check build details, and approve individual snapshots or entire builds through your agent. This lets you manage visual regression results without switching back to the Percy dashboard.

Where every change lands.

The outcomes of your review

Your agent handles the technical execution while you make the visual calls.

UPDATED

New visual baselines

When you approve a snapshot, your agent updates the baseline. This ensures future tests compare against your latest intended design.

STABLE

Clean build history

Approving builds keeps your Percy dashboard organized. Your agent clears out pending reviews so your CI/CD pipeline stays green.

HUMAN

Manual visual checks

The AI cannot see the pixels. You still need to look at the visual diffs in Percy before telling your agent to approve them.

SYNCED

Real-time status

Your agent pulls the latest build data. You always work with the most recent snapshot information available in Percy.

The workflow

What your AI does when a build arrives.

The agent acts as your interface to the Percy API to move builds through your pipeline.

  1. Fetch build data

    Your agent pulls the specific details of a pending visual test to see what changed.

    get_build_details

  2. Identify changes

    The agent looks through the available snapshots in a build to find the specific diffs.

    list_snapshots

  3. Approve snapshots

    Once you confirm a change looks right, the agent marks that specific snapshot as approved.

    approve_snapshot

  4. Finalize the build

    After you review the set, the agent approves the entire build to update your baselines.

    approve_build

Try it

Copy these to start.

Use these prompts to kick off your review process.

Starting points

These are opening lines. Replace the specific build IDs or project names with your actual Percy data.

Percy Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_6LH0zsvN8J0nY7uPYJ5ybHRW80VU7JdDwEgote5I/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Percy capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "percy-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_6LH0zsvN8J0nY7uPYJ5ybHRW80VU7JdDwEgote5I/mcp"
    }
  }
}
Copy into chat04

  • Show me the details for Percy build 12345.

  • List all the snapshots in the current build for my web-app project.

  • Approve snapshot snap_98765 in the latest build.

  • Approve the entire build for the production branch.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Percy once, then ask.

One click connects your Percy account to your agent. Your credentials stay encrypted and secure on our side.

Connect Percy to your AI

FAQ

How the Percy Connector behaves

  • 01

    Can the AI approve builds automatically?

    No. The AI only performs the approval action after you explicitly tell it to do so in chat.

  • 02

    Can the AI fix CSS issues?

    No. The AI can only approve or reject snapshots in Percy. It cannot modify your source code or CSS files.

  • 03

    Does the AI see the visual diffs?

    No. The AI interacts with the Percy API to manage build states, but it does not 'see' the images. You must view the diffs in Percy yourself.

  • 04

    Can I undo an approval?

    No. The tools provided only allow for approving snapshots and builds. There is no tool to revert an approval once it is sent.

  • 05

    How do I find which builds are pending?

    You can ask your agent to list the details of recent builds or snapshots to identify what needs your attention.

  • More questions about Percy? See everything the Percy Connector can do

Connect Percy to Claude, Cursor, ChatGPT & more