Skip to content
CircleCI MCP logo

AI-powered pipeline analysis and automated remediation

From $15/mo (free plan available)Visit Website
Tracked since2026

The Bottom Line

Price
From $15/mo (free plan available). Compare plans

Key facts

  • Official CircleCI MCP for AI clients. Hosted at mcp.circleci.com (OAuth or personal API token) or local via the CircleCI CLI.
  • Reads failure logs, pipeline status, test results, and flaky tests. Can rerun a workflow or trigger a pipeline.
  • The MCP layer is free. You pay the CircleCI plan and credits you already run. Hosted and CLI MCP are in preview.

Pros

  • Official server, not a hobby wrapper. Tool names match CircleCI objects: pipelines, workflows, jobs, artifacts.
  • Two supported paths: hosted HTTPS MCP (nothing to install) and CLI MCP (circleci mcp cursor|vscode|claude enable).
  • Read path is useful on day one: failure logs, test timings, flaky-test history, config.yml validation before push.
  • Write ops are explicit (rerun, trigger, rollback) instead of a silent mutate-everything token.

Cons

  • Hosted and CLI MCP are in preview. Tool names and scope can change. The old npx @circleci/mcp-server-circleci package is deprecated.
  • A classic personal API token in an agent config is too wide. Prefer OAuth on the hosted server, or a scoped token in a secret store.
  • It does not see GitHub PRs or Sentry errors. Pair it with GitHub MCP Server and Sentry MCP.

What is CircleCI MCP?

Editorial review
The CircleCI MCP server gives an AI client direct access to build data so it can explain a red pipeline instead of speculating. get_build_failure_logs returns failure logs with step by step execution detail, get_latest_pipeline_status reports workflow status, duration and timestamps, and get_job_test_results returns test metadata, results and timings. find_flaky_tests analyzes execution history to identify tests that pass and fail without code changes. config_helper validates a .circleci/config.yml for syntax and semantic errors before it is pushed. list_followed_projects, list_artifacts and list_component_versions cover project discovery, build artifacts with download URLs, and deployed component versions with commit information. Write operations are limited and explicit: run_pipeline triggers a pipeline, rerun_workflow reruns a workflow from the start or from the failed job, and run_rollback_pipeline executes a rollback across environments. Cost and capacity work is covered by download_usage_api_data, which exports usage metrics as CSV, and find_underused_resource_classes, which reads that export to flag jobs whose average or peak CPU and memory sit below a threshold and could run on a smaller resource class. Two access paths exist side by side. A hosted server accepts OAuth or a personal API token with no local install, and the CircleCI CLI ships an MCP mode that reuses existing CLI authentication and exposes the wider CLI surface, including config authoring and org management. It is aimed at developers and platform engineers debugging CI from a coding assistant.

Preview

Key Features

  • Retrieve build failure logs with step level execution detail
  • Read test results, timings and identify flaky tests from execution history
  • Validate .circleci/config.yml for syntax and semantic errors
  • Trigger pipelines, rerun failed workflows and run rollback pipelines
  • List followed projects, build artifacts and deployed component versions
  • Export usage data and flag jobs running on oversized resource classes

Pricing Plans

Pricing checked Sep 29, 2026

CircleCI MCP plans and prices, checked September 2026
PlanPriceDetails
Free

$0 / mo

  • Up to 6,000 build minutes (small Docker resource class)
  • Up to 5 active users/month
  • Docker, Windows, Linux, Arm, macOS, self-hosted runners
+2 more
  • 30x concurrency
  • Community support
Performance

Starting at $15/mo

  • 30,000 credits included free
  • 5 active users (add additional users for $15/month)
  • Larger resources
+3 more
  • 80x concurrency
  • Optional 8x5 support add-on
  • Ticket-based global support
Scale

Contact us

  • Customizable plans
  • Enterprise controls
  • Largest resource classes
+3 more
  • All environments, even GPU
  • Optional 24/7 support add-on
  • Billed annually

Is CircleCI MCP worth the price?

Good value

CircleCI's pricing is fair for teams already invested in its ecosystem, with a generous Free tier offering 6,000 build minutes and 30x concurrency at $0/mo.

The Performance tier at $15/mo is competitive for small teams, but the Scale tier's hidden pricing and annual-only billing may feel expensive for larger organizations. Best for startups and mid-size teams needing robust CI/CD without upfront enterprise costs.

Hidden Costs & Gotchas

Overage fees for extra build minutes

Additional users cost $15/month each

Support add-ons cost extra

Reviews

Improve Your Thinking Patterns Using ChatGPT cover
$99Free with your review

Review CircleCI MCP, get a free AI guide

Share your experience and we will send you Improve Your Thinking Patterns Using ChatGPT, free.

Write a review

Best CircleCI MCP Alternatives

Top alternatives based on features, pricing, and user needs.

Most buyers shortlist 2 or 3 tools before committing. Pull a side-by-side comparison or browse the full alternatives shortlist below.

Explore More

CircleCI MCP FAQ

How does CircleCI MCP help debug a failed pipeline?

CircleCI MCP retrieves failure logs step by step with get_build_failure_logs, reports workflow status and timestamps via get_latest_pipeline_status, and returns test metadata with results and timings from get_job_test_results. This gives an AI client direct access to build data so it can explain a red pipeline instead of speculating.

How does CircleCI MCP compare to GitHub Actions?

CircleCI MCP is an official MCP server specific to CircleCI, providing AI-powered pipeline analysis and automated remediation with tool names that match CircleCI objects like pipelines, workflows, and jobs. GitHub Actions is a separate CI/CD platform; CircleCI MCP is designed for teams already using CircleCI who want to debug CI directly from a coding assistant.

What are the main limitations of CircleCI MCP?

CircleCI MCP is currently in preview, so tool names and scope can change, and the old npx package is deprecated. It does not see GitHub PRs or Sentry errors, so it should be paired with the GitHub MCP Server and Sentry MCP for full context.

Which teams benefit most from using CircleCI MCP?

Developers and platform engineers who debug CI from a coding assistant are the primary audience. The tool gives them direct access to build failure logs, test timings, flaky-test history, and config validation without leaving their editor.

How is CircleCI MCP priced?

CircleCI MCP is available on a free tier, with paid plans for more usage and features. The pricing model supports both casual use and teams that need higher capacity or additional capabilities.

Can CircleCI MCP validate configuration files before pushing?

Yes, the config_helper tool validates a .circleci/config.yml for syntax and semantic errors before it is pushed. This helps catch configuration mistakes early in the development workflow.

Does CircleCI MCP support write operations like triggering pipelines?

Yes, CircleCI MCP includes explicit write operations: run_pipeline triggers a pipeline, rerun_workflow reruns a workflow from the start or from the failed job, and run_rollback_pipeline executes a rollback across environments. These actions are deliberate rather than a silent mutate-everything token.

How does CircleCI MCP help identify flaky tests?

The find_flaky_tests tool analyzes execution history to identify tests that pass and fail without code changes. This helps teams focus on tests that are unreliable rather than chasing random failures.

Source: circleci.com

Guides & Articles