• STATUS
  • METRICS
  • DETAILS
  • HUMAN

How to monitor Percy build status with your AI

Connect Percy to your agent once. From then on, you can pull build updates and snapshot counts without opening a browser.

Ask AI about this page

Short answer

Can I check Percy build status with my AI?

Yes. Your AI uses Percy tools to fetch build lists, project details, and snapshot counts. You'll get a clear view of your pipeline health through your chat interface.

The outcomes

What you can track

Your AI pulls data from Percy to give you these specific insights.

STATUS

Build health updates

The AI checks recent builds to see if they passed or failed. You get a quick summary of your current pipeline state.

METRICS

Snapshot totals

Ask for snapshot counts across your projects. Your AI pulls these numbers so you don't have to hunt through the dashboard.

DETAILS

Specific build info

Get the exact processing state for any build. The AI retrieves the metadata you need to understand why a build is stuck or finished.

HUMAN

Manual fixes

The AI only reads data. You'll still need to log in to Percy if you want to manually trigger builds or change project settings.

The workflow

What your AI does when the status changes.

Your agent acts as a direct link to your Percy data.

  1. Locate projects

    The AI finds the specific Percy projects you want to check.

    list_projects

  2. Fetch build history

    It pulls a list of recent activity to show what has been running.

    list_builds

  3. Get build data

    The AI pulls granular details for a specific build to show its exact state.

    get_build_details

  4. Report status

    The AI summarizes the build results and snapshot counts in your chat.

    list_builds

Try it

Copy these to start.

Paste these into your chat to begin.

Starting points

These are just starting points. Swap out the project names or build IDs with your actual Percy names.

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

  • What is the status of the latest build in my 'Frontend-App' project?

  • List the most recent builds for the 'Design-System' project.

  • How many snapshots are currently in my 'Mobile-UI' project?

  • Give me the details for the last failed build in 'Web-Dashboard'.

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

Start here

Connect Percy once, then ask.

One click connects the MCP to your client. Your login stays encrypted on our side, and you can start asking questions immediately.

Connect Percy to your AI

FAQ

How the Percy Connector behaves

  • 01

    Can my AI trigger a new build in Percy?

    No. The AI can only read build lists, project lists, and build details.

  • 02

    Can the AI delete snapshots or projects?

    No. The AI has no permission to delete or modify anything in Percy.

  • 03

    Does the AI see my Percy password?

    No. Vinkius manages the connection securely so your agent never sees your credentials.

  • 04

    Can I ask about build errors?

    Yes. If the build details contain error info, your AI can read and explain it to you.

  • 05

    Can the AI change my project settings?

    No. The AI is limited to reading data via the provided tools.

  • More questions about Percy? The Connector page answers them. See everything the Percy Connector can do

Connect Percy to Claude, Cursor, ChatGPT & more