How to Use the Cypress Cloud MCP in Windsurf

Q: How does Windsurf use the Cypress Cloud MCP Server to debug a broken build?

Cascade runs a multi-step routine starting with getruns to find the latest failed execution. It then drills down with getinstances and pulls the specific error message, letting you fix the code in one motion.

Q: Can I run Cypress Cloud reports directly inside Windsurf?

Yes, you can ask Cascade to run commands like reportslow or reportflaky. It parses the JSON payload and presents a clean markdown summary right in your chat panel.

Q: How do I configure this tool inside the Windsurf editor?

Add the server configuration to your /.codeium/windsurf/mcpconfig.json file under the mcpServers block. Once saved, Cascade immediately discovers the Cypress MCP tools and makes them available.

Let Cascade autonomously hunt down flaky specs and analyze Cypress Cloud test failures right inside Windsurf.

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 Windsurf

Create your Vinkius account to connect Cypress Cloud to Windsurf 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 Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Autonomously trace failures in Windsurf

When a build fails, Cascade doesn't just show you the error. It uses `get_runs` to grab the failing CI build and then calls `get_instances` to pinpoint the exact spec file that broke. You don't have to trigger each step manually. This MCP Server lets the agent pull down the exact failure details using `get_instance`, extracting the screenshot and video URLs so you can fix the code immediately.

Isolate flaky tests without leaving the editor

Stop digging through web dashboards to find out why your pipeline is green one minute and red the next. Ask Cascade to pull the `report_flaky` data directly into your workspace via this MCP Server. The agent checks the flake rate and last flake dates, then cross-references them with `get_tests` to find the exact assertions causing pain in your local branch.

Generate enterprise-wide test summaries

Preparing for a team sync is easier when your editor compiles the metrics for you. Cascade calls `report_runs` with your target start date to aggregate recent build performance. It pairs that high-level data with `report_slow` to flag the longest-running specs, giving you a clear list of optimization targets in seconds.

Setup guide

Set up Cypress Cloud MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
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

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Cypress Cloud payment history." If connected, Cascade will call the Cypress Cloud tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "cypress-cloud-mcp": {
      "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 Windsurf

Cascade runs a multi-step routine starting with `get_runs` to find the latest failed execution. It then drills down with `get_instances` and pulls the specific error message, letting you fix the code in one motion.

Yes, you can ask Cascade to run commands like `report_slow` or `report_flaky`. It parses the JSON payload and presents a clean markdown summary right in your chat panel.

No, this server communicates directly with the Cypress Cloud Enterprise API. You only need your project ID, which Cascade can fetch using `list_projects`.

Add the server configuration to your `~/.codeium/windsurf/mcp_config.json` file under the `mcpServers` block. Once saved, Cascade immediately discovers the Cypress MCP tools and makes them available.

Absolutely. Your test run metadata, error messages, and screenshot URLs are handled locally within Vinkius's secure sandboxed environment. Windsurf only receives the specific API responses required to answer your prompt, and your Cypress credentials never touch external LLM training loops.

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