CircleCI's hosted MCP server focuses on run diagnostics: listing and inspecting runs, workflows and jobs, fetching job logs, artifacts and test results, and rerunning or cancelling workflows. It authenticates via OAuth2 or a personal API token. The CircleCI CLI also offers `circleci mcp` for config authoring and admin tasks.
Also available as
Connect
- 1Connect it in ChatGPT
Turn on Developer mode in ChatGPT (Settings → Security and login), open Plugins, select + and paste https://mcp.circleci.com/v1/mcp as the MCP server URL, then sign in with OAuth. Add it to a chat from the composer's tools menu.
- 2Or add it to Codex or the API
codex mcp add circleci --url https://mcp.circleci.com/v1/mcp codex mcp login circleciThe login command opens a browser to finish OAuth.
Configs are generated from the publisher's documented endpoint. Check their docs for plan requirements and scopes. New to this? Read the step-by-step tutorial.
Tools 12
list_runsget_runlist_workflowsget_workflowrerun_workflowcancel_workflowlist_jobsget_jobget_job_logslist_artifactslist_job_testsdownload_usage_dataThings to ask
- “Why did the latest build on main fail?”
- “Show the failing tests from my last workflow”
- “Rerun the deploy workflow from failed”
- “Download last month's usage data for my org”