Monitor pipelines, trigger builds, and manage workflows in CircleCI — give AI agents full CI/CD visibility.
Use with AI AssistantsMCP
Connect Claude, Cursor, or any MCP-compatible client — then call tools directly
① Add This MCP Server
Paste into your AI client config — then all its tools are available instantly.
{
"mcpServers": {
"circleci": {
"url": "https://mcp.aerostack.dev/s/aerostack/mcp-circleci",
"headers": {
"Authorization": "Bearer YOUR_AEROSTACK_TOKEN"
}
}
}
}Replace YOUR_AEROSTACK_TOKEN with your API token from the dashboard.
② Call a Tool
Ask your AI assistant to call a specific tool, or send raw JSON-RPC:
Natural Language Prompt
“Use the _ping tool to verify circleci token by fetching the current user. used internally by aerostack to validate credentials”
Using a Workspace?
Add this MCP to your Workspace — your team shares one token, secrets are stored securely, and every AI agent in the workspace can call it without per-user setup.
Monitor pipelines, trigger builds, and manage CI/CD workflows in CircleCI.
CircleCI is a leading continuous integration and delivery platform. This MCP server gives your AI agents the ability to list pipelines, inspect workflow and job status, retrieve build artifacts, trigger new pipelines, and cancel running workflows — enabling automated CI/CD observability and control from any agent.
Live endpoint: https://mcp.aerostack.dev/s/aerostack/mcp-circleci
CIRCLECI_TOKEN when prompted| Tool | Description |
|---|---|
_ping | Verify token by fetching the current user |
list_pipelines | List recent pipelines for a project |
get_pipeline | Get details of a single pipeline |
list_workflows | List workflows for a pipeline |
get_workflow | Get details of a single workflow |
list_jobs | List jobs for a workflow |
get_job | Get details of a job by job number |
get_job_artifacts | List artifacts produced by a job |
trigger_pipeline | Trigger a new pipeline on a project |
cancel_workflow | Cancel a running workflow |
| Variable | Required | Description |
|---|---|---|
CIRCLECI_TOKEN | Yes | CircleCI Personal API Token |
CircleCI identifies projects using a slug format: {vcs}/{org}/{repo}
gh/my-org/my-repobb/my-org/my-repoUse this format for project_slug parameters in all tools.
"List the last 5 pipelines for gh/acme/api-server and tell me if any are failing"
"Show me the jobs in the most recent workflow for pipeline abc-123 and check if tests passed"
"Trigger a new pipeline on the staging branch of gh/acme/api-server"
"Cancel workflow xyz-789 — we pushed a fix and need to re-run"
"Get the test artifacts from job 542 in gh/acme/api-server"
curl -X POST https://mcp.aerostack.dev/s/aerostack/mcp-circleci \
-H 'Content-Type: application/json' \
-H 'X-Mcp-Secret-CIRCLECI-TOKEN: your-circleci-token' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_pipelines","arguments":{"project_slug":"gh/my-org/my-repo"}}}'
MIT
Live Endpoint
https://mcp.aerostack.dev/s/aerostack/mcp-circleci
Sub-50ms globally · Zero cold start
@aerostack
Pre-built functions for the most common MCP tool patterns. Clone, extend, and deploy.
by @aerostack
Tasks, projects, sections, comments, teams, custom fields via Asana's official MCP
by @aerostack
Jira issues, sprints, Confluence pages via Atlassian's official MCP
by @aerostack
Cloudflare Workers, KV, R2, D1, Pages, DNS via Cloudflare's official MCP
by @aerostack
Dashboards, monitors, logs, metrics, incidents, SLOs, APM traces via Datadog's official MCP
by @aerostack
Files, frames, components, comments, variables via Figma's official MCP
by @aerostack
GitHub repos, PRs, issues, branches, code search via GitHub's official hosted MCP
Yes. The trigger_pipeline tool accepts a project slug and branch or tag. Claude can kick off a CircleCI build directly from a chat prompt without opening the CircleCI dashboard.
Use get_job to retrieve job details, then get_job_artifacts to fetch logs or test-result files. Claude can parse the artifact content and summarize the root cause of a CircleCI failure.
Yes. cancel_workflow takes a workflow ID and cancels it immediately in CircleCI. Combine with list_workflows to find the active workflow ID before issuing the cancel.
The current tool set covers pipelines, workflows, and jobs but does not include an approve_job tool. Approval-gated jobs must still be actioned from the CircleCI UI or API directly.