# CircleCI MCP
> CircleCI provides a hosted MCP server for build and workflow diagnosis, and a separate local MCP server built into its CLI for broader project administration and configuration tasks.
Canonical: https://www.mcpfolio.com/servers/circleci
Last updated: 2026-10-28
## Catalog record

- Publisher: CircleCI
- Categories: productivity

## Website

https://circleci.com/docs/guides/toolkit/circleci-mcp-overview/

## Repository

https://github.com/CircleCI-Public/mcp-server-circleci

## Authentication

Hosted server: OAuth 2.0 in the MCP client, or a CircleCI personal API token if client OAuth is unavailable. CLI server: use `circleci auth login` or CIRCLE_TOKEN. The former standalone npx/Docker MCP is deprecated.

## Tools

- **list_runs**: List CircleCI runs, including the authenticated user’s runs across projects.
- **get_run**: Retrieve a run and its outcome and source details.
- **list_run_workflows**: List workflows belonging to a run.
- **get_workflow**: Retrieve workflow status and details.
- **list_workflow_jobs**: List jobs belonging to a workflow.
- **get_job**: Retrieve job status, failed step and exit code.
- **list_job_tests**: List test results for a job, including failing tests by default.
- **get_job_logs**: Retrieve processed job-step logs, defaulting to failed steps.
- **get_job_resource_usage**: Compare executor resource usage with its resource-class limits.
- **list_job_artifacts**: List job artifacts with download URLs.
- **rerun_workflow**: Rerun a workflow, optionally starting from failed jobs.
- **cancel_workflow**: Cancel a running workflow.
- **validate_config**: Compile and validate CircleCI configuration, expanding orbs and parameters.
- **get_orb**: Inspect an orb and whether its pin is current.
- **get_orb_source**: Retrieve orb source and usage guidance.
- **list_deployments**: List project deployments and determine what is live.
- **list_deploy_components**: List deployment components.
- **list_deploy_environments**: List deployment environments.
- **list_deploy_component_versions**: List versions of a deployment component.
- **rollback_deploy_component**: Roll back a deployment component to a prior version.
- **get_me**: Retrieve information about the authenticated CircleCI account.
- **download_usage_data**: Download organization usage data for a date range.

## Sources

- [official_documentation](https://circleci.com/changelog/hosted-mcp-server-now-available/)
- [official_tool_reference](https://circleci.com/docs/guides/toolkit/circleci-mcp-overview/)
- [official_tool_reference](https://circleci.com/product/mcp/)

## Setup

Use the interactive setup panel on [the detail page](https://www.mcpfolio.com/servers/circleci) to view instructions for each supported client.