🔧

CircleCI MCP Server

Updated June 2026✓ OfficialTrust grade A98/100

CircleCI's official MCP server exists to close one specific loop: a build fails, and the person who has to fix it is already in an editor with an AI assistant open, not in the CircleCI web UI reading logs. Built by CircleCI, it is officially maintained and best for DevOps & CI/CD.

by CircleCI

About

CircleCI's official MCP server exists to close one specific loop: a build fails, and the person who has to fix it is already in an editor with an AI assistant open, not in the CircleCI web UI reading logs. get_build_failure_logs pulls the actual failure output for a branch or pipeline into the conversation, which is enough for an assistant to propose a patch against the real error rather than a guessed one. get_latest_pipeline_status answers whether the branch is currently green, and get_job_test_results returns test metadata so a model can distinguish a genuine regression from an environment problem. Beyond triage, the server covers the workflows around a build. find_flaky_tests analyses execution history to name the tests that pass and fail without a code change — the single most valuable tool here, because flakiness is exactly the kind of pattern that is obvious across hundreds of runs and invisible in any one of them. find_underused_resource_classes reports jobs provisioned larger than their actual compute use, which is a direct cost lever on a CI bill, and download_usage_api_data pulls raw Usage API data for the same analysis. config_helper validates a .circleci/config.yml and explains what is wrong with it, so an assistant can iterate on config without pushing commits to find out. Control tools cover run_pipeline, rerun_workflow (from the start or just from the failed job), run_rollback_pipeline, list_artifacts, list_followed_projects and list_component_versions. Installation is npx -y @circleci/mcp-server-circleci@latest with CIRCLECI_TOKEN in the environment, and there is an official Docker image (circleci/mcp-server-circleci) plus a self-managed remote-server mode documented for teams that would rather run one shared instance than a process per developer. CIRCLECI_BASE_URL is optional and only needed by on-prem customers. Note that rerun_workflow, run_pipeline and run_rollback_pipeline are write operations against real infrastructure — a rollback pipeline in particular ships to production — so a token scoped to the projects you want an agent touching is worth setting up before you connect it.

A
Reliable98/100
low confidence · 1 measured signal

Grade A (98/100, reliable) from 1 measured signal, based on repository evidence. Only one signal stands behind it, so treat the grade as provisional.

What was measured

  • Repository maintenance100/100 · weight 20

    The repository has been pushed to or released within the last six months. — last push 2026-07-19.

  • Source verification100/100 · weight 25

    The repository URL was confirmed to resolve against the live GitHub API and is not archived.

  • Provenance90/100 · weight 10

    Published and maintained by the vendor of the service it connects to, rather than by a third party.

  • Listing ↔ repository match100/100 · weight 5

    The listing name lines up with the linked repository CircleCI-Public/mcp-server-circleci.

What could not be measured

These contributed nothing to the score — not a penalty, not a zero. They are why the confidence reads the way it does.

  • Live MCP handshakeunknown

    No remote endpoint to handshake — this server installs and runs locally over stdio, so there is nothing to probe from the outside.

  • Measured uptimeunknown

    No probe history recorded for this server yet.

  • Tool-schema stabilityunknown

    Drift is a difference between two successive checks, and this server has none recorded.

Installation

npm / npx
claude mcp add circleci-mcp-server -e CIRCLECI_TOKEN=your-circleci-token -- npx -y @circleci/mcp-server-circleci@latest

@circleci/mcp-server-circleci confirmed live on the npm registry — checked August 17, 2026.

Frequently Asked Questions

What is CircleCI MCP Server?
CircleCI is an MCP server built by CircleCI. CircleCI's official MCP server exists to close one specific loop: a build fails, and the person who has to fix it is already in an editor with an AI assistant open, not in the CircleCI web UI reading logs. get_build_failure_logs pulls the actual failure output for a branch or pipeline into the conversation, which is enough for an assistant to propose a patch against the real error rather than a guessed one. get_latest_pipeline_status answers whether the branch is currently green, and get_job_test_results returns test metadata so a model can distinguish a genuine regression from an environment problem. Beyond triage, the server covers the workflows around a build. find_flaky_tests analyses execution history to name the tests that pass and fail without a code change — the single most valuable tool here, because flakiness is exactly the kind of pattern that is obvious across hundreds of runs and invisible in any one of them. find_underused_resource_classes reports jobs provisioned larger than their actual compute use, which is a direct cost lever on a CI bill, and download_usage_api_data pulls raw Usage API data for the same analysis. config_helper validates a .circleci/config.yml and explains what is wrong with it, so an assistant can iterate on config without pushing commits to find out. Control tools cover run_pipeline, rerun_workflow (from the start or just from the failed job), run_rollback_pipeline, list_artifacts, list_followed_projects and list_component_versions. Installation is npx -y @circleci/mcp-server-circleci@latest with CIRCLECI_TOKEN in the environment, and there is an official Docker image (circleci/mcp-server-circleci) plus a self-managed remote-server mode documented for teams that would rather run one shared instance than a process per developer. CIRCLECI_BASE_URL is optional and only needed by on-prem customers. Note that rerun_workflow, run_pipeline and run_rollback_pipeline are write operations against real infrastructure — a rollback pipeline in particular ships to production — so a token scoped to the projects you want an agent touching is worth setting up before you connect it.
Who built CircleCI MCP Server?
CircleCI MCP Server was built by CircleCI.
Is CircleCI MCP Server free?
Yes, CircleCI MCP Server has a free option. The MCP server is free and open-source. CircleCI: Free tier (6,000 build minutes/mo). Performance: from $15/mo. Scale: Custom pricing.
How do I install CircleCI MCP Server?
Install CircleCI MCP Server with npm: claude mcp add circleci-mcp-server -e CIRCLECI_TOKEN=your-circleci-token -- npx -y @circleci/mcp-server-circleci@latest
What does CircleCI MCP Server integrate with?
CircleCI MCP Server integrates with Claude Desktop, Cursor, VS Code, Windsurf, Cline.

Repo Health

Actively maintained

Local/stdio install — runs on your machine, so there is no remote endpoint to verify live. Trust signal below is from the source repo.

Last commit
1mo ago
Install
npm

Quick Info

Install Type
npm
Author
CircleCI
Categories
1
Integrations
5

Related Servers

💻

Git

Tools to read, search, and manipulate Git repositories. Full Git operations support.

Local
💻

GitHub MCP Server

authenticated access to the whole GitHub platform — repositories, files, branches, issues, pull requests, Actions runs, security alerts, discussions and notifications — from Claude, Cursor, VS Code, Copilot CLI and any other MCP host. There is no npm package for this server, and that trips up most people who try to install it: `@github/mcp-server` is not published to the npm registry, so any `npx` line you find for it will fail. GitHub ships it three other ways. The easiest is the hosted remote server at https://api.githubcopilot.com/mcp/, which needs no install at all — point an HTTP-transport MCP client at that URL and log in with OAuth (VS Code 1.101+, Claude Desktop, Claude Code, Cursor and Windsurf all support this). The second is the official Docker image ghcr.io/github/github-mcp-server, which is what the copy-paste command on this page runs; on github.com it now performs a browser-based OAuth login on first use and keeps the token in memory only, which is why the published Docker configs map a fixed loopback callback port (-p 127.0.0.1:8085:8085 with GITHUB_OAUTH_CALLBACK_PORT=8085) so the container can receive the callback. Prefer a token? Set GITHUB_PERSONAL_ACCESS_TOKEN instead — it takes precedence over OAuth, and the minimum useful scopes are repo, read:org and read:packages. The third is the native Go binary from the repository's releases, which needs no fixed port for the OAuth flow. GitHub Enterprise Server has no hosted option: use the local server with --gh-host or GITHUB_HOST set to your instance (include the https:// scheme — it defaults to http://, which GHES rejects). Toolsets can be narrowed with GITHUB_TOOLSETS, and an insiders channel is available at /mcp/insiders or via the X-MCP-Insiders header.

Auth required📘
💻

GitLab MCP Server

a first-party MCP endpoint built into the GitLab instance itself — there is no package to install, because the server ships inside GitLab and answers at https://<your-gitlab>/api/v4/mcp (gitlab.com exposes the same path, so https://gitlab.com/api/v4/mcp works for SaaS projects). It landed as an experiment in GitLab 18.3 and moved to beta in 18.6. Authentication is the part that makes it different from every community GitLab server: it uses OAuth 2.0 Dynamic Client Registration, so the first time a client connects it registers itself as an OAuth application on your instance and is issued an access token — no personal access token pasted into a config file. Administrators who do not want one OAuth application per tool can pre-create a shared application instead. Three prerequisites are what actually block most first connections: GitLab Duo must be set to Always on or On by default, beta and experimental features must be enabled, and MCP access must be switched on at the group or instance level. The tool surface covers issues and merge requests (create_issue, get_issue, create_merge_request, get_merge_request, list_merge_requests, get_merge_request_commits, get_merge_request_diffs, get_merge_request_pipelines, create_merge_request_note, get_merge_request_notes), CI/CD (manage_pipeline for list/create/delete/retry/cancel, get_pipeline_jobs, get_job_log), work items (create_workitem_note, get_workitem_notes, link_work_items, get_saved_view_work_items), search (search across the instance, search_labels, semantic_code_search), list_wiki_pages, and attach_scan_profile. HTTP is the recommended transport — claude mcp add --transport http GitLab https://gitlab.com/api/v4/mcp — and clients that only speak stdio can wrap it with npx mcp-remote <url> on Node 20+. Send the X-Gitlab-Mcp-Server-Tool-Name-Prefix header if generic names like search collide with another connected server. If your instance predates 18.3 or Duo is not available to you, the community alternative most teams land on is zereight/gitlab-mcp (1,889 stars as of 2026-08-16, npm @zereight/mcp-gitlab), which authenticates with a plain personal access token and ships 217 tools — including merge_merge_request, approve_merge_request, execute_graphql and full CI/CD variable management, none of which the built-in server exposes — behind GITLAB_PERMISSION_MODE=readonly/modify and GITLAB_TOOLSETS/GITLAB_TOOLS filtering. One further change worth noting: MCP server access moved from GitLab Premium to GitLab Free in 19.2 and became a setting of its own.

Auth required📘
☁️

AWS MCP Servers

AWS Labs maintains a monorepo of specialized, open-source MCP servers that bring AWS best practices directly into AI-assisted development workflows, spanning infrastructure, data, AI/ML, cost management, and healthcare/life-sciences domains. Rather than one monolithic server, the project ships dozens of focused servers you install individually depending on the task: the AWS Documentation MCP Server for real-time official docs and API references, dedicated servers for Terraform/CDK/CloudFormation infrastructure-as-code, container and serverless platforms (ECS, EKS, Lambda), SQL/NoSQL databases (DynamoDB, RDS, Aurora), search and analytics (OpenSearch), messaging (SQS/SNS), and cost/billing analysis. Most servers install via uvx with a package name like awslabs.aws-documentation-mcp-server, run locally over stdio, and use standard AWS credential chains (IAM roles, profiles, or access keys) rather than exposing raw account credentials to the model. AWS also now offers a managed, remote "AWS MCP Server" (in preview) that combines full API coverage with pre-built agent SOPs, syntactically validated API calls, and complete CloudTrail audit logging for teams that want centralized governance instead of running servers locally. The Getting Started with Kiro/Cursor/VS Code/Claude Code sections in the repo provide one-click install configs for each server, making it straightforward to wire up only the AWS services a given project actually touches.

Local
☁️

Cloudflare MCP Server

Cloudflare ships two different things under this name. The mcp-server-cloudflare repo provides 16 remote, domain-specific MCP servers rather than one monolith — Documentation, Workers Bindings (storage/AI/compute primitives), Workers Builds, Observability (logs/analytics), Container sandboxes, Browser Rendering (fetch pages, convert to markdown, screenshots), Logpush health, AI Gateway (prompt/response search), AI Search, Audit Logs, DNS Analytics, Digital Experience Monitoring, Cloudflare One CASB, Radar, GraphQL analytics and the Agents SDK docs server, each on its own `*.mcp.cloudflare.com/mcp` hostname. Separately, the Cloudflare API MCP server at mcp.cloudflare.com/mcp (repo: cloudflare/mcp) exposes the whole 2,500+ endpoint Cloudflare API through just two tools, `search` and `execute`, using the Code Mode pattern — model-written JavaScript runs in an isolated Dynamic Worker, costing ~1,000 tokens of context against the ~1.17M an equivalent native-tool server would need. Pick a domain server when you want a readable, curated tool list for one product area; pick the API server for breadth or for endpoints nobody wrote a tool for. All endpoints are Streamable HTTP on `/mcp` and support the MCP 2026-07-28 spec; the historical `/sse` URLs remain as aliases for the same Streamable HTTP handler but no longer serve the deprecated HTTP+SSE transport, so clients pinned to SSE must switch. Auth is OAuth on connect, or a scoped Cloudflare API token as a bearer header for CI. Clients without native remote-MCP support bridge via `npx mcp-remote https://<subdomain>.mcp.cloudflare.com/mcp`.

Live📘

Sponsored

Better Stack

Free Plan

Get alerted when your APIs, browser tests, payment pipelines, or MCP server dependencies go down. Used by 100K+ developers.

Start monitoring free →