Skip to content
Vinkius

Percy Connector for AI agents.

10 live capabilities

Manage visual regression testing and UI snapshots across your web projects.

Live agent request Percy / Connector

Waiting for input…

AI Agent

Why people use Percy

Percy for Visual Regression Testing

This Connector changes that. You can stay in your chat interface and ask your agent to find the specific snapshots with the highest diff percentages. It pulls the data for you, so you only look at the things that actually need your attention.

  • Claude
  • ChatGPT
  • Gemini
  • Cursor
  • Visual Studio Code
  • Windsurf

What Vinkius changes

You can manage your entire visual regression pipeline through simple text commands.

Use it from Claude, ChatGPT, Cursor or another AI client you already have.

One account · 5,900+ Connectors

  1. Real-world use case 01

    Finding a mobile header bug

    A frontend dev pushed a change that broke the header on mobile.

  2. Real-world use case 02

    Checking nightly build status

    A QA lead needs to know the status of the nightly build.

  3. Real-world use case 03

    Updating the production baseline

    A team just finished a UI overhaul and needs to set a new baseline.

Complete set · 10capabilities

The complete Percy capability set.

These are the exact actions your AI can choose when you ask it to work with Percy.

Capability set01 / 03

01—04

4 capabilities in this set.

Part of 10 available through Percy.

  1. 01 Capability

    List snapshots

    The list_snapshots capability shows snapshots within a specific Percy build. It returns names, review states, and diff percentages.

  2. 02 Capability

    List projects

    The list_projects capability lists all projects on Percy. It provides the names, slugs, and browser configurations for your projects.

  3. 03 Capability

    Get project details

    Use get_project_details to see the specific details of a Percy project. This includes the default branch and auto-approve settings.

  4. 04 Capability

    List builds

    Use list_builds to see all builds for a Percy project. It shows you the IDs, states, branch names, and how many snapshots are in each run.

Capability set02 / 03

05—07

3 capabilities in this set.

Part of 10 available through Percy.

  1. 05 Capability

    Get build details

    Use get_build_details to see the full status of a specific Percy build. You get info on approved snapshots, branch names, and timestamps.

  2. 06 Capability

    Approve build

    The approve_build capability marks an entire Percy build as visually approved. This moves your test suite to green for deployment.

  3. 07 Capability

    Get snapshot details

    Use get_snapshot_details to see the full details of a single Percy snapshot. This includes the fingerprint, widths, and comparison counts.

Capability set03 / 03

08—10

3 capabilities in this set.

Part of 10 available through Percy.

  1. 08 Capability

    Approve snapshot

    The approve_snapshot capability marks a single Percy snapshot as visually correct. It updates the baseline for future comparisons.

  2. 09 Capability

    List comparisons

    The list_comparisons capability shows visual diffs for a Percy snapshot. It returns the differences between the baseline and the head.

  3. 10 Capability

    List browsers

    The list_browsers capability lists all supported browser families on Percy. This helps you check available browser and OS combinations.

Set up in minutes

One URL. Then ask Percy to work.

Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Percy from the conversation.

Choose your client

Live preview
Advanced clients IDE · CLI

Claude · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP
https://edge.vinkius.com/vk_preview_6LH0zsvN8J0nY7uPYJ5ybHRW80VU7JdDwEgote5I/mcp
  1. Step 01

    Open Connectors

    In Claude Web or Claude Desktop, open Settings and choose Connectors.

  2. Step 02

    Add the URL

    Choose Add custom connector, name it Percy, and paste the URL above.

  3. Step 03

    Turn it on in chat

    Select +, open Connectors, and enable Percy for the conversation.

Where the request belongs

Work Percy can move forward.

Built around the request

This is for the QA engineer who is tired of digging through dozens of browser snapshots to find one broken button. It is for the frontend developer who wants to see if their CSS change broke the layout on Safari without manually checking every single page.

01

QA Engineer

Checks failed assertions and tracks rendering regressions across multiple builds.

02

Frontend Developer

Resolves visual bugs by inspecting diff percentages and snapshot details.

03

DevOps Administrator

Monitors CI pipeline health and tracks unreviewed visual tests globally.

Bring your own AI

Change the model, client or framework. Keep Percy connected.

  • Claude
  • ChatGPT
  • Gemini
  • Cursor
  • VS Code
  • Windsurf
  • ZCode
  • Cline
  • Zed
  • Continue
  • Kiro
  • Roo Code
  • Zencoder
  • Goose
  • Void
  • Augment Code
  • Amp
  • Qodo
  • Tabnine
  • Pieces
  • Sourcegraph Cody
  • JetBrains
  • Warp
  • Amazon Q
  • Antigravity
  • BoltAI
  • Raycast
  • Jan
  • LM Studio
  • AnythingLLM
  • Open WebUI
  • Msty
  • Cherry Studio
  • LibreChat
  • TypingMind
  • Chorus
  • 5ire
  • n8n
  • LangChain
  • LlamaIndex
  • CrewAI
  • Vercel AI SDK

Before you connect

Questions about Percy.

The practical details behind the request, access and result.

How does Percy MCP help with UI testing?

Percy MCP connects your visual regression testing to your AI client. It lets you query build statuses and snapshot diffs using plain text, so you can identify UI bugs without leaving your chat interface.

Can I use Percy MCP to approve snapshots quickly?

Yes. You can ask your agent to approve an entire build or specific snapshots. This updates your visual baseline instantly and helps you clear your test queue faster.

Does Percy MCP work with my existing CI pipeline?

Percy MCP works alongside your existing pipeline by interacting with the Percy API. It allows your agent to check the results of the tests your CI just finished running.

How do I see the diff percentages for my web app?

You can ask your agent to list comparisons for a specific snapshot. It will return the exact diff percentages and details for different browser configurations.

Can Percy MCP manage multiple projects at once?

Yes. You can use it to list and retrieve details for all projects on Percy. This makes it easy to monitor multiple web apps or products in one conversation.

What happens when I approve a build in Percy MCP?

When you approve a build, the Connector updates the visual baseline in Percy. This marks the current UI as correct, so future tests will compare against this new version.

How can Percy MCP help me find UI bugs faster?

It helps you skip the manual work of looking at every screenshot. Your agent can filter for the highest diff percentages, so you only spend time on the most significant regressions.

Can the AI automatically approve an entire Percy build limit safely via constraints natively?

Absolutely strictly explicitly natively. The integration encapsulates the approve_build action dynamically structurally executing the final endpoint verification marking bounds explicitly matching visual approvals effortlessly saving limits.

How explicitly strict are the parameter bounds when extracting image comparisons logistically?

Invoking Explicit bounding via list_comparisons tracks native image differences safely cleanly bounding metrics returning explicit difference percentages mapping base width loops directly over testing node grids explicitly gracefully natively.

Where structurally globally do I find my Explicit Percy integration token accurately gracefully?

Navigate explicit bounds inside your native Percy workspace parameters explicitly mapping 'Project Settings > Integrations/Tokens'. Globally limit testing node arrays explicitly generating Token strings seamlessly securely correctly internally securely elegantly here.

One connection away

Give your agent a direct line to Percy.

Connect Percy once. Keep it beside 5,900+ managed Connectors when the next task needs more.

Explore every Connector No credit card required · Free tier available