CircleCI MCP Server

1. get_build_failure_logs

Retrieves detailed failure logs from CircleCI builds using project slug and branch, CircleCI URLs, or local project context.

2. find_flaky_tests

Identifies flaky tests in your CircleCI project by analyzing test execution history using project slug, CircleCI project URL, or local project context.

3. get_latest_pipeline_status

Retrieves the status of the latest pipeline for a given branch using project slug and branch, CircleCI project URL, or local project context.

4. get_job_test_results

Retrieves test metadata for CircleCI jobs using project slug and branch, CircleCI URL, or local project context.

5. config_helper

Assists with CircleCI configuration tasks by providing guidance and validation for CircleCI config files.

6. create_prompt_template

Helps generate structured prompt templates for AI-enabled applications based on feature requirements.

7. recommend_prompt_template_tests

Generates test cases for prompt templates to ensure they produce expected results.

8. list_followed_projects

Lists all projects that the user is following on CircleCI with project names and projectSlugs.

9. run_pipeline

Triggers a pipeline to run using project slug and branch, CircleCI URL, or local project context.

10. run_rollback_pipeline

Triggers a rollback for a project by either executing a rollback pipeline or rerunning a previous workflow.

11. rerun_workflow

Reruns a workflow from its start or from the failed job and returns the ID of the newly-created workflow.

12. analyze_diff

Analyzes git diffs against cursor rules to identify rule violations in staged or unstaged changes.

13. list_component_versions

Lists all versions for a specific CircleCI component in an environment with deployment status and commit information.

14. download_usage_api_data

Downloads usage data from the CircleCI Usage API for a given organization using flexible date input.

15. find_underused_resource_classes

Analyzes CircleCI usage data CSV files to find jobs/resource classes with average or max CPU/RAM usage below a given threshold.

{
  "mcpServers": {
    "circleci-mcp-server": {
      "command": "npx",
      "args": ["-y", "@circleci/mcp-server-circleci@latest"],
      "env": {
        "CIRCLECI_TOKEN": "your-circleci-token",
        "CIRCLECI_BASE_URL": "https://circleci.com"
      }
    }
  }
}