CircleCI MCP
by CircleCI
Official listing: built and published by CircleCI. More from CircleCI
Lets coding agents diagnose CircleCI pipelines over a hosted MCP server, reading runs, job logs, and failing tests, and rerunning or cancelling workflows.
Use it now
Keep it with up to 9 other tools you're setting up, then share them all as one link.
Try this first
Ask your assistant, with CircleCI MCP connected:
- Workflow Rerun And Cancel
Use CircleCI MCP to rerun a workflow from the start: ‹what you need›
- Failing Test Lookup
Use CircleCI MCP to list a job's test results: ‹what you need›
- Usage Data Export
Use CircleCI MCP to export an organization's CircleCI usage data as downloadable CSV files: ‹what you need›
Connect it over MCP
{
"mcpServers": {
"circleci-mcp": {
"url": "https://mcp.circleci.com/v1/mcp"
}
}
}claude mcp add --transport http circleci-mcp https://mcp.circleci.com/v1/mcp
In Grok, ChatGPT and other assistants, add a custom connector with the address https://mcp.circleci.com/v1/mcp (how, step by step).
It may ask you to sign in to CircleCI or for a key when you add it; the setup guide says which.
Setup guide: circleci.com/docs/guides/toolkit/connecting-to-the-circleci…
Install the CLI
brew install circleci
Setup guide: circleci.com/docs/guides/toolkit/connecting-to-the-circleci…
Compare
Press Compare to add it to the tray at the bottom of the window, then pick up to 2 others anywhere on the site.
- Access
- MCPCLI
- Auth
- OAuth 2.0
- Skills
- 5
Skills
Failed Run Diagnosis
Chains list_runs, get_run, list_workflows, and get_job_logs to find a failed job and read its failed step output.
Workflow Rerun And Cancel
Reruns a workflow from the start or only from failed jobs with from_failed, or cancels a running workflow by UUID.
Failing Test Lookup
Lists a job's test results with list_job_tests, returning failing tests by default along with their failure messages.
Usage Data Export
Exports an organization's CircleCI usage data as downloadable CSV files for a date range of up to 31 days.
CLI MCP
Runs the CircleCI CLI's built-in MCP locally for config authoring, orb management, and other administrative commands.