
Connect Cypress Cloud to ChatGPT, Claude and Gemini
Set it up once and it works in ChatGPT, Claude, Cursor, and any other client you love. It all runs safely in the background, so you can relax and focus on what really matters. Audit test runs and debug failures through natural conversation.
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.
Your AI does the work. We keep it safe and sound.
No other AI tool gives you this. Your workflow runs in the client you already love, your account stays protected, and you decide what the agent can and cannot do. It is the whole reason to make the switch.
Each Connector lives inside our infrastructure, the same place where your workflow runs. The three things below are already part of it, working quietly in the background so you never have to think about them. Nothing to add, nothing to set up, nothing to worry about.

Each Connector runs inside its own sealed environment.
Each Connector runs inside its own sealed V8 runtime — no access to your files, your system, or other servers. A Connector never sees past its own request.
One switch stops every agent. Instantly.
One action deactivates every Connector, revokes every token, and ends every session at once. AI Governance keeps the record.
Spending limits that pause instead of surprise.
Every user keeps their own connections and credentials, isolated from everyone else. Anything that would cross your spending limit is held for your approval, not billed.
Three controls, built into the layer your AI connects through.
Curated set · 10 capabilities
We ship only the actions that matter.
01-04
4 capabilities in this set.
Part of 10 available through Cypress.
- 01
Get instance
Retrieves full details for a specific Cypress spec instance. It provides the spec name, status, error messages, and links to screenshots and videos.
- 02
Report flaky
Generates a report of flaky tests from your Cypress Cloud account. It identifies intermittent failures and returns flake rates and last flake dates.
- 03
Get instances
Lists all spec instances within a specific Cypress run. Use this to see instance IDs, names, statuses, and how long each took to run.
- 04
Get tests
Lists individual tests inside a spec instance. It returns test titles, their current state, duration, and any error messages.
05-07
3 capabilities in this set.
Part of 10 available through Cypress.
- 05
Report runs
Creates an enterprise run summary report based on a start date. This provides aggregated data suitable for BI dashboards.
- 06
Report tests
Fetches enterprise test results at the individual test level. It provides statuses and error messages for specific tests.
- 07
Get runs
Lists recent test runs for a project. It returns run IDs, branch info, commit details, and CI build IDs.
08-10
3 capabilities in this set.
Part of 10 available through Cypress.
- 08
List projects
Lists all projects in your Cypress Cloud organization. This is the easiest way to find the project IDs needed for other capabilities.
- 09
Get run
Retrieves complete details for a single Cypress Cloud run. It includes total test counts, pass/fail stats, and parallelization data.
- 10
Report slow
Generates a report identifying your slowest tests. It provides average, p95, and maximum durations for each test.
Real work
What teams actually run
Rapid Debugging
When a CI build fails, ask your agent to show the error and video for the specific failed spec.
Flakiness Audits
Request a report of all tests with high flake rates to prioritize stability fixes.
Performance Monitoring
Ask for a report on slow tests to find which specs are dragging down your pipeline speed.
Project Overview
Get a summary of recent test runs and pass/fail counts for a specific project or branch.
Automate a task
Put Cypress to work on one thing.
Step-by-step automations your AI runs through this Connector: the workflow, the prompts to start with, and the exact capabilities behind each move.
One connector, every AI
Cypress works with the most popular AI clients.
These are the most popular clients, each with a step-by-step guide: one link, set up once, with governance and visibility built in. And because everything runs on the MCP standard, the same connection also works in any other compatible client — nothing to rebuild.
Claude
ChatGPT
Gemini
Perplexity
Grok
Microsoft Copilot
Cursor
VS Code
Windsurf
JetBrains
Cline
LangChain
Vercel AI SDK
Lovable
Z.ai
Raycast
Qwen Code
Kimi Code
Le ChatBuilding your own app? The connector is yours to use.
You don't need a client to put Cypress to work: the same hosted connection plugs into your own applications and agent code, with the same governance on every request. Build with it, chat with it — one connection for both.
Observed, not estimated
920ms average. Fast in production.
Cypress is checked daily against the live service.
- Fastest day
- 737ms
- Slowest day
- 1073ms
- 14-day trend
- Slowing+24%
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 Cypress, so you can see the experience inside your AI.
It does not authenticate your account with Cypress. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.
Cypress Connector
You're all set. Choose your MCP client and follow the setup instructions.
https://edge.vinkius.com/vk_preview_IKhVCeL6avFJPY6iQ838105q3zZBtwMa7WMfyaRI/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 — Cypress capabilities are ready to use.
{
"mcpServers": {
"cypress-cloud-mcp": {
"url": "https://edge.vinkius.com/vk_preview_IKhVCeL6avFJPY6iQ838105q3zZBtwMa7WMfyaRI/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
Guided setup for Claude? Set up Cypress in Claude and other AIs
Who it's for
Built for the work Cypress owners hand off.
This MCP is built for engineering teams who rely on Cypress for their E2E testing and need faster feedback loops.
- 01
QA Engineers
They use the agent to monitor test statuses and find the root cause of failures using natural language.
- 02
DevOps Teams
They use the agent to audit pipeline performance and track flaky tests to keep CI reliable.
- 03
Software Developers
They use the agent to pull test results and error logs directly within their IDE.
- 04
Engineering Managers
They use the agent to pull enterprise reports on project quality and maintainability.
FAQ
Questions Cypress owners ask.
- 01
What do I need to use this MCP?
You need a Cypress Cloud Enterprise account, your Enterprise API Key, and a Project ID.
- 02
Which AI clients can I use with this?
You can use any MCP-compatible client, including Claude, Cursor, Windsurf, and VS Code.
- 03
Can I see screenshots of failed tests?
Yes, the get_instance capability retrieves screenshots and video URLs for failed spec executions.
- 04
How do I find my Project ID?
You can use the list_projects capability to see all projects in your organization and find the required 6-character IDs.
- 05
Does this work with standard Cypress accounts?
This MCP is designed for Cypress Cloud Enterprise accounts to access the Enterprise Data Extract API.
- 06
Can my agent help me debug a failed Cypress test?
Yes. Use the 'get_instance' capability with the instance ID. The agent will retrieve explicit error messages and can provide you with direct links to failure screenshots and video recordings stored in Cypress Cloud.
- 07
How do I identify which tests are flaky in my project?
Provide a start date to the 'report_flaky' capability. Your agent will analyze the historical data from Cypress Cloud and identify tests that intermittently pass and fail, helping you improve your CI reliability.
- 08
Can I use the agent to monitor the duration of my test runs?
Absolutely. The 'report_slow' capability retrieves high-precision duration metrics. The agent can surface the slowest tests by average or p95 duration, allowing you to optimize your test suite's execution time.
Explore
More in Loved By Devs
Katalon TestOps (AI Test Management) AI Connector
Manage test orchestration via Katalon TestOps — rerun test runs, monitor execution results, and audit software
ViewSauce Labs AI Connector
Monitor and manage UI/E2E test automation at scale via AI — stop failing jobs, inspect video logs, and check p
ViewMabl (AI-Powered Test Automation) AI Connector
Manage E2E testing via Mabl — trigger test plans, monitor execution results, and perform AI-driven failure ana
ViewGrafana k6 Cloud (Load Testing) AI Connector
Manage load tests via k6 Cloud — run tests, monitor performance metrics, and audit thresholds.
View
Suggestions
Testim AI Connector
Trigger automated AI tests, inspect execution logs, and manage branches natively via your AI agent.
ViewTestRail AI Connector
Browse TestRail suites, parse manual test specs, and monitor active runs seamlessly native within your convers
ViewTestLink AI Connector
Navigate your self-hosted TestLink instance to inspect test plans, suites, cases, and builds natively via your
ViewBrowserStack AI Connector
Automate testing via BrowserStack — manage projects, track test builds, fetch session logs, and monitor execut
View
Connect Cypress to Claude, Cursor, ChatGPT & more
