Percy Connector for AI agents.
10 live capabilities
Manage visual regression testing and UI snapshots across your web projects.
Waiting for input…
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.
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
- Real-world use case 01
Finding a mobile header bug
A frontend dev pushed a change that broke the header on mobile.
- Real-world use case 02
Checking nightly build status
A QA lead needs to know the status of the nightly build.
- 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.
01—04
4 capabilities in this set.
Part of 10 available through Percy.
- 01 Capability
List snapshots
The list_snapshots capability shows snapshots within a specific Percy build. It returns names, review states, and diff percentages.
- 02 Capability
List projects
The list_projects capability lists all projects on Percy. It provides the names, slugs, and browser configurations for your projects.
- 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.
- 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.
05—07
3 capabilities in this set.
Part of 10 available through Percy.
- 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.
- 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.
- 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.
08—10
3 capabilities in this set.
Part of 10 available through Percy.
- 08 Capability
Approve snapshot
The approve_snapshot capability marks a single Percy snapshot as visually correct. It updates the baseline for future comparisons.
- 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.
- 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 previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_6LH0zsvN8J0nY7uPYJ5ybHRW80VU7JdDwEgote5I/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it Percy, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable Percy for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_6LH0zsvN8J0nY7uPYJ5ybHRW80VU7JdDwEgote5I/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Percy URL.
- Step 03
Save and start
Save the connection and enable Percy in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"percy": {
"url": "https://edge.vinkius.com/vk_preview_6LH0zsvN8J0nY7uPYJ5ybHRW80VU7JdDwEgote5I/mcp"
}
}
} - Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using Percy
Open Agent mode in chat and ask: "Using Percy, help me...". 10 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"percy": {
"url": "https://edge.vinkius.com/vk_preview_6LH0zsvN8J0nY7uPYJ5ybHRW80VU7JdDwEgote5I/mcp"
}
}
} - Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using Percy
Ask Copilot: "Using Percy, help me...". 10 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"percy": {
"url": "https://edge.vinkius.com/vk_preview_6LH0zsvN8J0nY7uPYJ5ybHRW80VU7JdDwEgote5I/mcp"
}
}
} - Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using Percy
Open Cascade and ask: "Using Percy, help me...". 10 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"percy": {
"url": "https://edge.vinkius.com/vk_preview_6LH0zsvN8J0nY7uPYJ5ybHRW80VU7JdDwEgote5I/mcp"
}
}
} - Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using Percy
Ask Cline: "Using Percy, help me...". 10 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add percy --transport http "https://edge.vinkius.com/vk_preview_6LH0zsvN8J0nY7uPYJ5ybHRW80VU7JdDwEgote5I/mcp" - Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using Percy
Ask Claude: "Using Percy, show me...". 10 tools are ready
Where the request belongs
Work Percy can move forward.
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.
QA Engineer
Checks failed assertions and tracks rendering regressions across multiple builds.
Frontend Developer
Resolves visual bugs by inspecting diff percentages and snapshot details.
DevOps Administrator
Monitors CI pipeline health and tracks unreviewed visual tests globally.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsApplitools
Bring AI-powered visual testing to your AI agent. inspect test batches, review UI diffs, and manage your visual baselines naturally.
Sauce Labs
Monitor and manage UI/E2E test automation at scale via AI. stop failing jobs, inspect video logs, and check pipeline concurrency metrics.
Cypress Cloud
Audit E2E testing via Cypress. monitor test runs, inspect spec instances, track flaky tests, and generate enterprise reports directly from any AI agent.
TestMu AI (formerly LambdaTest)
Manage cross-browser testing via TestMu AI. audit automation builds, inspect test sessions, and retrieve visual logs.
Mabl (AI-Powered Test Automation)
Manage E2E testing via Mabl. trigger test plans, monitor execution results, and perform AI-driven failure analysis.
BrowserStack
Automate testing via BrowserStack. manage projects, track test builds, fetch session logs, and monitor execution pipelines from any AI agent.
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