Skip to content

MCP setupDevOps and cloud

CircleCI MCP Server

Read CircleCI build failures, test results and pipeline status from your agent, then get help fixing the config or the failing job.

npx workspacetemplates add circleci-mcp --tool claude-code

Writes 1 file to your project root

.mcp.jsonmerge into your file14 lines · 229 BFile
{
  "mcpServers": {
    "circleci": {
      "command": "npx",
      "args": [
        "-y",
        "@circleci/mcp-server-circleci@latest"
      ],
      "env": {
        "CIRCLECI_TOKEN": "${CIRCLECI_TOKEN}"
      }
    }
  }
}

What it does

The CircleCI MCP server lets an agent pull the failure logs of a build, see which tests failed and check the latest pipeline on a branch, so you can say "why is main red" without opening the web app. It can also validate a config file and find flaky tests.

It runs through npx with a personal API token. Some tools do more than read: rerun_workflow and run_pipeline start work on your account. CircleCI marks this package deprecated in favor of its hosted server, so look at the source page for the current recommendation.

Example

you › The build on branch fix/cart-total is red. Get the failure logs and tell me what broke.

agent › The test job failed in cart.spec.ts: "expected 1999, received 2000". The rounding change in totals.ts rounds before adding tax. Suggested fix: round once after the sum.

Questions

Does it work with self-hosted CircleCI?
Yes. Set the optional CIRCLECI_BASE_URL variable to your server address.
Can it trigger builds?
Yes, through run_pipeline and rerun_workflow. Tell the agent to ask first if you want a check before it starts anything.
  • AWS Documentation MCP Server

    MCP setupDevOps and cloud

    Free
  • Azure MCP Server

    MCP setupDevOps and cloud

    Free
  • Cloudflare MCP Server

    MCP setupDevOps and cloud

    Free
  • Docker MCP Gateway

    MCP setupDevOps and cloud

    Free