LogoSTMCP
Download
mcp-server-circleci

CircleCI MCP Server

CircleCI MCP Server enables natural language interaction with CircleCI through Model Context Protocol, allowing developers to manage pipelines, analyze builds, and debug failures using AI assistants like Cursor, Claude, and VS Code.

Tools

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.

Open Graph image for CircleCI MCP Server

JSON Config

{
  "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"
      }
    }
  }
}

Useful Links

Information