CircleCI MCP Server (Official)

Official CircleCI MCP server enabling AI agents to interact with CircleCI's CI/CD platform — querying pipeline and workflow status, triggering runs, reading test results, and accessing build insights.

Evaluated Mar 06, 2026 (0d ago) vcurrent
Homepage ↗ Repo ↗ Developer Tools circleci ci-cd mcp-server official pipelines continuous-integration devops
⚙ Agent Friendliness
82
/ 100
Can an agent use this?
🔒 Security
78
/ 100
Is it safe for agents?
⚡ Reliability
83
/ 100
Does it work consistently?

Score Breakdown

⚙ Agent Friendliness

MCP Quality
80
Documentation
85
Error Messages
80
Auth Simplicity
85
Rate Limits
78

🔒 Security

TLS Enforcement
100
Auth Strength
75
Scope Granularity
55
Dep. Hygiene
85
Secret Handling
78

HTTPS enforced. API token lacks scopes. FedRAMP, SOC 2, ISO 27001, GDPR. Good CI/CD platform security.

⚡ Reliability

Uptime/SLA
88
Version Stability
85
Breaking Changes
82
Error Recovery
78
AF Security Reliability

Best When

An agent needs to interact with CircleCI for build status, test results, or pipeline management.

Avoid When

You're using a different CI/CD platform — use that platform's integrations.

Use Cases

  • Checking pipeline and workflow status from deployment agents
  • Querying build failure details for automated debugging agents
  • Triggering CircleCI pipelines from release automation agents
  • Reading test insights and flaky test reports from quality agents
  • Monitoring credit usage and resource utilization

Not For

  • Teams using GitHub Actions, Jenkins, or other CI/CD platforms
  • Non-CircleCI workflows
  • Infrastructure provisioning

Interface

REST API
Yes
GraphQL
No
gRPC
No
MCP Server
Yes
SDK
No
Webhooks
Yes

Authentication

Methods: api_token
OAuth: No Scopes: No

Personal API token via CIRCLE_TOKEN. No scope granularity — token grants full org access based on user permissions.

Pricing

Model: usage-based
Free tier: Yes
Requires CC: No

Credit-based pricing. Free tier is limited. API access included in all plans.

Agent Metadata

Pagination
cursor
Idempotent
Partial
Retry Guidance
Documented

Known Gotchas

  • Project slug format is specific (github/org/repo) — must construct correctly
  • Pipeline and workflow IDs required for most operations
  • Triggering pipelines incurs credit cost — implement cost controls
  • Test metadata requires separate endpoint and must be uploaded during build
  • Rate limit (100/min) can be hit by agents monitoring many pipelines
  • v2 API preferred over v1.1 — use v2 for all new agent integrations

Alternatives

Full Evaluation Report

Detailed scoring breakdown, competitive positioning, security analysis, and improvement recommendations for CircleCI MCP Server (Official).

$99

Scores are editorial opinions as of 2026-03-06.

5215
Packages Evaluated
26151
Need Evaluation
173
Need Re-evaluation
Community Powered