• TRENDS
  • CONTEXT
  • SUMMARY
  • HUMAN

How to audit test run history with your AI

Connect Cypress Cloud to your AI client once. After that, you can ask questions about your test results and stability trends using natural language.

Ask AI about this page

Short answer

How can I audit my Cypress test runs with AI?

Your AI uses the Cypress Cloud MCP to pull run summaries, branch data, and commit details. You get a clear view of stability trends and execution patterns without digging through dashboards. This breakdown shows how your agent handles the data.

The outcomes.

Where your data lands.

The AI processes raw test data into these specific outcomes.

TRENDS

Stability monitoring

The AI aggregates run data to show if your project is getting more or less stable over time.

CONTEXT

Commit and branch mapping

It links specific test failures to the exact branch or commit that caused them.

SUMMARY

Aggregated run reports

Instead of clicking through dozens of runs, you get a single summary of recent execution history.

HUMAN

Manual triage

The AI identifies patterns, but you decide which flaky tests need a code fix or a retry.

The workflow

What your AI does when the data arrives.

The AI acts as a bridge between your Cypress Cloud history and your chat interface.

  1. Gathering run data

    The AI fetches a list of recent test executions to establish a baseline for your project.

    get_runs

  2. Inspecting specific runs

    It looks into individual test executions to find specific failure details or metadata.

    get_run

  3. Reporting findings

    The AI organizes the gathered data into a structured summary for your review.

    report_runs

  4. Analyzing trends

    It compares multiple runs to spot regressions or changes in branch stability.

    get_runs

Try it

Copy these to start.

Use these prompts to begin your audit.

Starting points

These are starting points. Swap out the project names or branch names for your own.

Cypress Connector

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

Connector linkhttps://edge.vinkius.com/vk_preview_IKhVCeL6avFJPY6iQ838105q3zZBtwMa7WMfyaRI/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 — Cypress capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "cypress-cloud-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_IKhVCeL6avFJPY6iQ838105q3zZBtwMa7WMfyaRI/mcp"
    }
  }
}
Copy into chat04

  • Show me a summary of the last 10 runs for the 'frontend-main' branch.

  • Which commit caused the most failures in the 'auth-service' project recently?

  • Compare the stability of the 'staging' branch against the 'production' branch.

  • Summarize the execution trends for the 'api-gateway' project over the last week.

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

Start here

Connect Cypress Cloud once, then ask.

Follow the link to connect your account. Your credentials stay encrypted, and you can immediately start asking questions in your preferred AI client.

Connect Cypress Cloud to your AI

FAQ

How this task behaves

  • 01

    Can the AI fix my broken tests?

    No. The AI can identify which tests failed and which commits caused the issues, but you have to write and push the code fixes.

  • 02

    Can the AI delete old test runs?

    No. The tools only allow the AI to read and report on existing run data.

  • 03

    Does the AI see my source code?

    No. It only accesses the test execution data and metadata provided by Cypress Cloud.

  • 04

    Can I use this with Cursor?

    Yes. Any MCP-compatible client like Cursor, Claude, or Windsurf works once you connect the MCP.

  • 05

    How often does the AI update the run history?

    The AI pulls fresh data from Cypress Cloud every time you ask a question about your runs.

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

Connect Cypress to Claude, Cursor, ChatGPT & more