CircleCI MCP

Name: CircleCI MCP
Author: CircleCI

by CircleCI

Let AI agents fix your CI builds — official CircleCI MCP server for pipeline management

devops Node.js Intermediate Self-hostable Verified

⭐ 150 stars 📅 Updated: 1mo ago

View on GitHub View package

Description

Official CircleCI MCP server that enables AI agents to interact with your CI/CD pipelines directly. Monitor pipeline status, analyze test results, debug build failures, and trigger new workflows — all from your AI assistant. When a build breaks, the AI can pull failure logs, identify the root cause, and suggest fixes without you leaving your editor. Designed for teams that want to reduce the feedback loop between code changes and CI results, bringing continuous integration data into the conversational AI workflow.

✅ Best for

Development teams using CircleCI who want AI-assisted CI/CD debugging and pipeline management

⏭️ Skip if

You use a different CI provider like GitHub Actions or Jenkins

💡 Use cases

Automatically diagnosing and fixing CI build failures from your AI assistant
Monitoring pipeline status across multiple projects without switching to the CI dashboard
Analyzing test results and flaky test patterns to improve test suite reliability
Triggering and managing CI/CD workflows directly from conversational AI tools

👍 Pros

✓ Official CircleCI integration maintained by the CircleCI team
✓ Reduces context-switching between editor and CI dashboard
✓ AI can correlate code changes with build failures for faster debugging
✓ Simple npx install with API token authentication

👎 Cons

✗ Requires CircleCI API token with appropriate permissions
✗ Limited to CircleCI — not compatible with other CI providers
✗ Pipeline complexity may produce verbose output that consumes AI context

🔧 Exposed tools (5 tools)

Tool	Category	Description
analyze_failure	debugging	Analyze a build failure and extract error details
trigger_pipeline	management	Trigger a new pipeline run for a project
get_pipeline_status	monitoring	Get the current status of a CircleCI pipeline
list_builds	monitoring	List recent builds for a project or pipeline
get_test_results	testing	Retrieve test results from a completed build

⚡ Installation

Prerequisites:

• Node.js v18+
• CircleCI API token
• API key required

Check Claude Code documentation to configure this MCP server.

💡 Tips & tricks

Set your CIRCLECI_TOKEN environment variable before starting. For best results, grant the token read access to all projects you want to monitor. Use get_test_results after a failure to quickly identify which tests broke.

🔄 Alternatives

buildkite-mcp-server

MCP server — editorial content pending

Similar functionality

actions-pulse