[!IMPORTANT] This repository is deprecated. The CircleCI MCP server is now built into the CircleCI CLI. Visit cli.circleci.com to get started.
CircleCI MCP Server
Model Context Protocol (MCP) is a new, standardized protocol for managing context between large language models (LLMs) and external systems. In this repository, we provide an MCP Server for CircleCI.
Use Cursor, Windsurf, Copilot, Claude, or any MCP-compatible client to interact with CircleCI using natural language — without leaving your IDE.
Tools
| Tool | Description |
|---|---|
analyze_diff |
Analyze git diffs against cursor rules for violations |
config_helper |
Validate and get guidance for your CircleCI configuration |
create_prompt_template |
Generate structured prompt templates for AI applications |
download_usage_api_data |
Download usage data from the CircleCI Usage API |
find_flaky_tests |
Identify flaky tests by analyzing test execution history |
find_underused_resource_classes |
Find jobs with underused compute resources |
get_build_failure_logs |
Retrieve detailed failure logs from CircleCI builds |
get_job_test_results |
Retrieve test metadata and results for CircleCI jobs |
get_latest_pipeline_status |
Get the status of the latest pipeline for a branch |
list_artifacts |
List artifacts produced by a CircleCI job |
list_component_versions |
List all versions for a CircleCI component |
list_followed_projects |
List all CircleCI projects you're following |
recommend_prompt_template_tests |
Generate test cases for prompt templates |
rerun_workflow |
Rerun a workflow from start or from the failed job |
run_evaluation_tests |
Run evaluation tests on a CircleCI pipeline |
run_pipeline |
Trigger a pipeline to run |
run_rollback_pipeline |
Trigger a rollback for a project |
