Cycle MCP

Cycle ships with an MCP (Model Context Protocol) server built into cycle-cli.exe. MCP is a widely accepted protocol that lets AI coding agents discover and call external tools through a common interface. Cycle MCP uses it to expose the tools, resources, prompts, and specialized agents needed to author, run, and debug Cycle tests, and to set up the test data those tests depend on.

Cycle MCP is compatible with AI coding agents that integrate with MCP servers, such as Claude Code, Cursor, and GitHub Copilot. Once you wire your agent up to the Cycle MCP Server, you can describe a test in plain language. For example, you can prompt the agent like this:

"Search the staging storefront for a product, add the top result to the cart, and verify the cart count goes from 0 to 1."

The agent will:

• Read Cycle's step catalog to find the right step definitions
• Open a real browser, navigate the application, and capture live element locators
• Generate the corresponding .feature file (delegating to a specialized authoring agent)
• Validate the file's syntax
• Execute the test with cycle-cli and read structured error details if it fails

The agent does the typing; you review and iterate.

Getting started

Start with the setup guide to connect the Cycle MCP Server with the agent of your choice. Add Rules so the agent prefers Cycle tools, prompts less often, and writes only under approved paths. To understand what is possible using Cycle MCP, review the Tools and Resources that Cycle provides to agents. For a guided on-ramp, the Prompts page covers the fill-in-the-blank requests the server provides, and the Agents page explains the specialized subagents the main agent delegates to. Once you are ready to try it, the Workflows page provides typical patterns for writing, debugging, and exploring tests with an agent. If you come across any issues, the Troubleshooting section lists common errors and how to recover from them.

Prerequisites

• Cycle installed (the installer places cycle-cli.exe, which serves as both the test runner and the MCP server)
• A supported AI coding agent like Claude Code
• A signed-in Cycle account (the same one you use for the Cycle Desktop IDE). The MCP server requires you to be signed in, and the agent authenticates through the same flow as the desktop client.

Supported Coding Agents

Presently, Claude Code is the only coding agent officially supported and tested with Cycle MCP. Other coding agents like Cursor and GitHub Copilot in VS Code will work with Cycle MCP as well, but they have not been thoroughly tested.

How it fits

The Cycle MCP Server is a companion to the Cycle editors and cycle-cli, not a replacement. The desktop client and CLI continue to be the primary surfaces for running tests. The MCP server is the path for agent-driven test authoring and exploration.

Cycle MCP can be adopted incrementally: first to draft a tricky locator or a new Feature File, later to maintain regression suites alongside the desktop client.