How to Use the Cypress Cloud MCP in Claude Code

Q: How do I add the Cypress Cloud MCP Server to Claude Code?

Run claude mcp add --transport http cypress-cloud in your terminal. You can verify the installation by running claude mcp list to see the newly registered MCP tools.

Q: Can I pipe Cypress Cloud flake reports to other CLI tools using Claude Code?

Yes, you can ask Claude Code to run reportflaky and format the output as JSON or CSV. From there, you can pipe the terminal output directly into grep, jq, or custom shell scripts.

Q: How does Claude Code fetch specific spec failures from Cypress Cloud?

Claude Code uses getinstance to retrieve the spec name, failure status, and error logs. It then displays the terminal-friendly output, complete with links to the recorded execution video.

Pipe Cypress Cloud test runs and flake reports directly into your terminal workflows using Claude Code.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Cypress Cloud MCP to Claude Code

Create your Vinkius account to connect Cypress Cloud to Claude Code and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Cypress Cloud with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Pipe test data into terminal scripts

This MCP Server turns Claude Code into a command-line interface for your QA pipelines. SREs can query `get_runs` directly from the shell to check the status of the latest CI build. You can pipe the JSON output of `get_instances` into other command-line tools or save it as a local log file for quick terminal debugging.

Automate flake monitoring via CLI

Keep an eye on suite stability by running `report_flaky` straight from your terminal prompt. Claude Code parses the returned flake rates and warns you if any crucial tests are degrading. SREs can integrate this check into pre-release scripts, blocking deploys if the flake rate on main exceeds acceptable thresholds.

Run Cypress Cloud MCP Server reports from your terminal

Pull executive reports without opening a browser. Claude Code uses `report_runs` with a start date argument to generate a clean text summary of your team's testing velocity. It can combine this with `report_tests` to output a list of failed tests, giving you a quick terminal diagnostic before you head into a standup.

Setup guide

Set up Cypress Cloud MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see cypress-cloud-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest Cypress Cloud transactions." It will automatically discover and invoke the available Cypress Cloud tools.

Terminal

claude mcp add --transport http cypress-cloud-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the Cypress Cloud MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "cypress-cloud-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Cypress. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Cypress Cloud now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Cypress Cloud MCP in Claude Code

Run `claude mcp add --transport http cypress-cloud ` in your terminal. You can verify the installation by running `claude mcp list` to see the newly registered MCP tools.

Yes, you can ask Claude Code to run `report_flaky` and format the output as JSON or CSV. From there, you can pipe the terminal output directly into grep, jq, or custom shell scripts.

Claude Code uses `get_instance` to retrieve the spec name, failure status, and error logs. It then displays the terminal-friendly output, complete with links to the recorded execution video.

Yes, Claude Code operates entirely in the terminal, making it perfect for headless environments. You can run `report_runs` with a start date to fetch aggregated BI data without any GUI dependencies.

Absolutely. Your enterprise run summaries, slow test metrics, and error logs are transmitted through a secure, single-endpoint token managed by Vinkius. The data is processed ephemerally in memory and never stored or used to train public models.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript