Skip to content
AgentAtlas

Official server by CircleCI

CircleCI MCP server

Inspect CircleCI projects, pipelines, workflows, jobs, logs, tests and artifacts, and debug failed builds.

Install

Pick your agent and copy one line. Remote servers ask you to sign in on first use.

claude mcp add --transport http circleci https://mcp.circleci.com/v1/mcp
Full steps for Claude Code →

What it can do

From CircleCI's own MCP documentation.

Sign in

OAuth2 or a personal API token.

Tools (13)

hellolist_runsget_runlist_workflowsget_workflowrerun_workflowcancel_workflowlist_jobsget_jobget_job_logslist_artifactslist_job_testsdownload_usage_data

Options

  • rerun_workflow takes from_failed to rerun only failed jobs and what follows them.
  • list_job_tests returns failing tests by default. Set all to include passing and skipped tests.
  • The CircleCI CLI MCP is a separate local option that exposes the whole CLI and uses circleci auth login or CIRCLE_TOKEN.

Good to know

  • The old local npx server is deprecated. Remove it before connecting to the hosted server.
  • download_usage_data takes a date range of up to 31 days.
  • Rerun and cancel change real CI state, so review them first.
  • Restart or reconnect your MCP host to see newly released tools.

Details

Registry name
com.circleci/mcp
Latest version
1.0.0 (updated 2026-08-11)
Endpoints

https://mcp.circleci.com/v1/mcp (streamable-http)

Links
CircleCI docs

More in Developer tools

Reviewed Oct 21, 2026. Official means published under CircleCI's namespace in the MCP registry. It is not a security audit.

Built an MCP server? Get it listed everywhere →

Shipping an Android app? Google Play needs 12 testers for 14 days first. Get them with Tester Exchange →