CircleCI MCP Server
Official CircleCI-Public MCP server for build-failure triage, flaky-test detection, and pipeline operations. 17-tool surface, npm + Docker distribution, self-hosted remote MCP option for on-prem CircleCI. Two open Claude Code bugs at time of review (#109, #110) flagged in weaknesses.
“The official CircleCI-Public MCP server. 17-tool surface for build-failure triage, flaky-test detection, and pipeline operations. Active development (10 commits on main in the last 30 days) and two open bugs that affect Claude Code specifically: tool-name slash bug (#109) breaks Claude Code, and Anthropic tool-name regex mismatch (#110) blocks tool registration. Both still in queue at time of review. Recommended for shops using CircleCI as the primary CI, with awareness that Claude Code support is current-state-buggy. The 17-tool surface is purpose-built for CI workflows: get build failure logs, find flaky tests, find underused resource classes (cost optimisation), trigger reruns, run pipelines, run rollback pipelines.”
INSTALL THIS SERVER
{
"mcpServers": {
"circleci": {
"command": "npx",
"args": [
"-y",
"@circleci/mcp-server-circleci@latest"
],
"env": {
"CIRCLECI_TOKEN": "<your-circleci-personal-api-token>",
"CIRCLECI_BASE_URL": "https://circleci.com",
"MAX_MCP_OUTPUT_LENGTH": "50000"
}
}
}
}
{
"mcpServers": {
"circleci": {
"command": "npx",
"args": [
"-y",
"@circleci/mcp-server-circleci@latest"
],
"env": {
"CIRCLECI_TOKEN": "<your-circleci-personal-api-token>",
"CIRCLECI_BASE_URL": "https://circleci.com",
"MAX_MCP_OUTPUT_LENGTH": "50000"
}
}
}
}
{
"mcpServers": {
"circleci": {
"command": "npx",
"args": [
"-y",
"@circleci/mcp-server-circleci@latest"
],
"env": {
"CIRCLECI_TOKEN": "<your-circleci-personal-api-token>",
"CIRCLECI_BASE_URL": "https://circleci.com",
"MAX_MCP_OUTPUT_LENGTH": "50000"
}
}
}
}
{
"mcpServers": {
"circleci": {
"command": "npx",
"args": [
"-y",
"@circleci/mcp-server-circleci@latest"
],
"env": {
"CIRCLECI_TOKEN": "<your-circleci-personal-api-token>",
"CIRCLECI_BASE_URL": "https://circleci.com",
"MAX_MCP_OUTPUT_LENGTH": "50000"
}
}
}
}
{
"mcpServers": {
"circleci": {
"command": "npx",
"args": [
"-y",
"@circleci/mcp-server-circleci@latest"
],
"env": {
"CIRCLECI_TOKEN": "<your-circleci-personal-api-token>",
"CIRCLECI_BASE_URL": "https://circleci.com",
"MAX_MCP_OUTPUT_LENGTH": "50000"
}
}
}
}
8 TOOLS AVAILABLE
OUR ASSESSMENT
- Official CircleCI-Public org publication with vendor governance and roadmap alignment.
- Compact 17-tool surface designed around specific developer-loop tasks.
- Active maintenance: 10 commits on main in the last 30 days.
- Apache-2.0 licence (LICENSE file confirms).
- Strong CI-cycle utility: find_flaky_tests, find_underused_resource_classes, download_usage_api_data (rare in CI MCP servers).
- NPM and Docker distribution, plus self-hosted remote MCP option for on-prem.
- MAX_MCP_OUTPUT_LENGTH setting prevents agent context blowup on large logs.
- Strong fork-to-star ratio (57 forks on 84 stars) signals active integration work.
- Two open Claude Code bugs at time of review: #109 (slash in tool name breaks Claude Code) and #110 (Anthropic regex mismatch on tool name pattern). Both still in queue.
- 84 stars; modest community traction so far.
- Zero tagged GitHub releases; versioning lives on npm only.
- Parameter parsing error reported in pre-release tooling (#126).
- Cursor Marketplace listing pending (PR #149 active).
Uses a CircleCI Personal API token via CIRCLECI_TOKEN. Prefer a service-account-style token with project-level scope over a user-level token; rotate on schedule. CIRCLECI_BASE_URL supports on-prem CircleCI. The self-hosted remote-MCP-server pattern is recommended for shared team usage so individual operator tokens stay on the operator host.
Engineering teams using CircleCI as primary CI who want AI assistants to investigate failed builds, cost optimisation workflows (right-sizing resource classes), and teams comfortable with the current Claude Code bugs (or running primarily on Cursor or VS Code).
TECHNICAL DETAILS
ADOPTION METRICS
// Reading this84 stars; the editorial weight is the official CircleCI-Public org publication and the active commit cadence on main.
// Reading thisEighth-ranked in infrastructure. Pair with GitHub Actions runs for full CI-MCP coverage; revisit when bugs #109 and #110 land.
SOURCES & VERIFICATION
We don't take any single directory's word for it. Before scoring, we cross-reference 5 public MCP sources, install the server ourselves against the clients we cover, and record when we last re-verified.
The same server, 5 different lenses. We reconcile these signals into our editorial score, which is why our number sometimes diverges from a directory-aggregate star count.
| Source | Their rating | Their star count | Their downloads | Last synced |
|---|---|---|---|---|
| AutomationSwitch This page | 3.7editorial | 84 | — | MAY 1, 2026 |
| PulseMCP | — unrated | unavailable | unavailable | MAY 1, 2026 |
| MCP.so | — unrated | unavailable | unavailable | MAY 1, 2026 |
| Glama | — unrated | unavailable | unavailable | MAY 1, 2026 |
| Smithery | — unrated | unavailable | unavailable | MAY 1, 2026 |
| Official MCP Registry | — unrated | unavailable | unavailable | MAY 1, 2026 |
// Counts are directory-reported; we don't adjust them. Discrepancies usually come from different snapshot times or star-caching.
OTHER INFRASTRUCTURE MCP SERVERS
Kubernetes MCP Server
Native Go MCP server for Kubernetes and OpenShift from the containers/ org. Talks directly to the Kubernetes API server, supports Helm and Tekton, ships with OpenTelemetry observability built in. Distributed as a single native binary plus npm and PyPI packages.
Sentry MCP Server
Sentry's official MCP service. Runs as remote infrastructure at mcp.sentry.dev and ships a Claude Code plugin that auto-delegates Sentry questions. Designed for human-in-the-loop coding agents working through Sentry errors, traces, and performance data.
Azure AKS MCP
Official Microsoft Azure MCP server for Azure Kubernetes Service. Workload Identity with federated tokens, three access-level guardrails (readonly, readwrite, admin), and a unified two-tool surface (call_az + call_kubectl). Top commit cadence in this batch (10 commits on main in the last 30 days).
mcp-server-kubernetes (Flux159)
Community-favourite TypeScript Kubernetes MCP. Uses local kubectl plus Helm v3, distributed via npm, and ships as an mcpb extension for one-click Claude Desktop install. Mature 3.x release stream with consistent monthly cadence.
Argo CD MCP
Argoproj-Labs-blessed Argo CD MCP server, originally donated by Akuity. Both stdio and HTTP-stream transports out of the box, MCP_READ_ONLY mode for production safety, and a tool surface covering the full Argo CD application lifecycle (list/get/sync/delete plus resource-tree traversal and workload logs).
kubectl MCP Server
CNCF Landscape-listed community kubectl MCP server. 253 tools spanning kubectl, Helm, RBAC audit, cost optimisation, network diagnostics, and a 3D cluster topology UI. Multi-distribution via npm, PyPI, Docker Hub, and GHCR.
DISCUSS YOUR
MCP REQUIREMENTS.
Evaluating a server, scoping an internal deployment, or working out whether MCP is the right fit at all. Start the conversation and we will point you at the right piece of the ecosystem.