Use Percy with your AI.
Connect your account once and let the AI you already use work with it, without building another integration. Execute visual regression tests via Percy. track visual diffs natively, inspect snapshot limits, approve builds, and verify UI components using AI.
Developed, maintained, and hosted by Vinkius.
MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED
Waiting for input…
Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.
Complete set · 10 capabilities
The complete Percy capability set.
These are the exact actions your AI can choose when you ask it to work with Percy.
01-04
4 capabilities in this set.
Part of 10 available through Percy.
- 01
List projects
List all projects on Percy (BrowserStack). Percy is the leading visual regression testing platform that captures snapshots and detects pixel-level UI differences across builds. Uses JSON:API format. Returns project names, slugs, and browser configs
- 02
Get build details
Get full details of a Percy build including state, total/unreviewed snapshot counts, approved/rejected snapshots, branch, commit SHA, and finalized timestamp
- 03
Approve build
/approve` moving the test suite to green. Approve all unreviewed snapshots in a Percy build. Marks the entire build as visually approved for deployment
- 04
Approve snapshot
Approve a single Percy snapshot. Marks it as visually correct, updating the baseline for future comparisons
05-07
3 capabilities in this set.
Part of 10 available through Percy.
- 05
Get project details
Get full details of a Percy project including name, slug, default branch, auto-approve enabled, browser targets, and build count
- 06
Get snapshot details
Get full details of a Percy snapshot including name, review state, widths, fingerprint, and comparison count
- 07
List browsers
List all supported browser families on Percy. Returns browser names, versions, and OS combinations for cross-browser visual testing
08-10
3 capabilities in this set.
Part of 10 available through Percy.
- 08
List builds
List builds for a Percy project. Each build contains snapshots from a test run. Returns build IDs, states (processing/finished/failed), branch names, commit SHAs, and snapshot counts
- 09
List comparisons
List visual comparisons for a Percy snapshot. Each comparison shows the diff between baseline and head at a specific width/browser. Returns diff images, diff percentages, and browser info
- 10
List snapshots
List snapshots in a Percy build. Each snapshot is a captured page/component at specific widths and browsers. Returns snapshot names, review states (unreviewed/approved/rejected), and diff percentages
Observed, not estimated
845ms average. Fast in production.
Percy is checked daily against the live service.
- Fastest day
- 693ms
- Slowest day
- 1044ms
- 14-day trend
- Slowing+38%
Connect your client
One URL. Every client.
Activate the Connector, copy your link, and paste it into the client you already use. 10 capabilities arrive ready to run.
Preview access · not provider authentication
The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of Percy, so you can see the experience inside your AI.
It does not authenticate your account with Percy. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.
Percy Connector
You're all set. Choose your MCP client and follow the setup instructions.
https://edge.vinkius.com/vk_preview_6LH0zsvN8J0nY7uPYJ5ybHRW80VU7JdDwEgote5I/mcpClaude Desktop
Follow the steps below to connect in seconds.
- 1In Claude Desktop, open Settings → Connectors.
- 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
- 3Click Add and start a new chat — Percy capabilities are ready to use.
{
"mcpServers": {
"percy-mcp": {
"url": "https://edge.vinkius.com/vk_preview_6LH0zsvN8J0nY7uPYJ5ybHRW80VU7JdDwEgote5I/mcp"
}
}
}
Claude
ChatGPT
Cursor
VS Code
Windsurf
Claude Code
JetBrains
Cline
Step-by-step instructions for each client are in the guide. How to connect
FAQ
Questions Percy owners ask.
- 01
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.
- 02
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.
- 03
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.
Explore
More in Ship It
Applitools AI Connector
Bring AI-powered visual testing to your AI agent — inspect test batches, review UI diffs, and manage your visu
ViewzipBoard AI Connector
Automate visual feedback and bug tracking via zipBoard — manage projects, files, and tasks with AI.
ViewVercel AI Connector
Bring your Vercel deployment infrastructure into chat. Control project domains, trigger manual builds, and ins
ViewVercel AI Connector
Manage Vercel deployments, projects and domains via API — inspect builds, track deployments, manage env vars a
View
Suggestions
Vercel AI Connector
Deploy frontend applications instantly with a platform optimized for Next.js, serverless functions, and edge c
ViewWebVizio AI Connector
Review and annotate live websites with visual feedback tools that let teams comment directly on pages during d
ViewPeerbie AI Connector
Orchestrate your entire team's workspace, from Kanban boards to calendar events, completely driven by AI.
ViewProofHub AI Connector
Empower your AI agent to manage your ProofHub projects — list tasks, create to-dos, read discussions, and trac
View
