MCP server

CircleCI MCP Server

Find why a build failed, spot flaky tests and rerun pipelines. Official: built and maintained by CircleCI. It runs as a hosted remote server: nothing to install. Setup below for 13 clients (checked 2026-10-25). Repo and registry data checked 2026-10-24.
Maintainer
Official · CircleCI
Runs
Remote
GitHub
★ 93, last push 2026-10-21 (checked 2026-10-24)
URL
https://mcp.circleci.com/v1/mcp
Registry
com.circleci/mcp
Connects to
CircleCI

Install the CircleCI MCP Server

Pick your client. Remote first: nothing to install, and you sign in with OAuth where the client supports it. Config shapes checked against each client's docs on 2026-10-25.

The URL also takes Authorization as a header (see its docs), for clients without OAuth sign-in.

Run in a terminal, then /mcp inside Claude Code to sign in. Add --scope project to share it via .mcp.json. docs

claude mcp add --transport http circleci https://mcp.circleci.com/v1/mcp

Security notes

  • The remote server runs at mcp.circleci.com, hosted by CircleCI. You sign in with OAuth in clients that support it, or with Authorization header where OAuth isn't available, and it acts with your account's permissions.
  • It acts on real infrastructure with your credentials. Use a read-only role or a sandbox account first.
  • Kubesharkofficial · ★ 12k

    Live Kubernetes network traffic: HTTP, gRPC, Redis, Kafka and DNS calls between services.

  • Cloudflareofficial · ★ 4.4k

    A set of hosted servers (docs, Workers bindings, builds, observability, Radar and more), each at its own URL; the docs one is shown.

  • Azureofficial · ★ 3.8k

    Azure resources, storage, Cosmos DB, Key Vault, monitoring and CLI commands from one server.

  • Fly.ioofficial · ★ 1.7k

    MCP server built into flyctl to manage Fly apps, machines, volumes and logs.

  • Terraformofficial · ★ 1.6k

    Look up Terraform providers, modules and policies in the registry, and manage HCP Terraform workspaces.

  • Google Cloud Runofficial · ★ 632

    Deploy code or containers to Cloud Run and list services and logs.

  • Argo CDofficial · ★ 596

    List, sync and inspect Argo CD applications and their resources.

  • Renderofficial · ★ 180

    Create services and databases on Render, check deploys, logs and metrics.

FAQ

What does the CircleCI MCP Server do?+

Find why a build failed, spot flaky tests and rerun pipelines.

Is the CircleCI MCP server official?+

Official: built and maintained by CircleCI.

How do I add CircleCI to Claude Code?+

Run: claude mcp add --transport http circleci https://mcp.circleci.com/v1/mcp, then /mcp inside Claude Code to sign in. Add --scope project to share it with your team through .mcp.json.

How do I use the CircleCI MCP server in Cursor or VS Code?+

Open the Cursor or VS Code tab above: it has the mcp.json entry and a one-click install link. Cursor uses the "mcpServers" key; VS Code uses "servers" and needs a type ("http").

Does CircleCI work in ChatGPT and claude.ai?+

Yes, it has a remote URL (https://mcp.circleci.com/v1/mcp). In claude.ai add it under Customize > Connectors > Add custom connector; in ChatGPT under chatgpt.com/plugins > Add custom MCP server.

What are the alternatives to the CircleCI MCP server?+

Other cloud & devops MCP servers: Kubeshark, Cloudflare, Azure, Fly.io and Terraform.

All MCP servers · What is an MCP server? · Agent skills