circleci.com
CircleCI is a cloud-based continuous integration and delivery platform for automating software build, test, and deployment workflows. It integrates with source control and developer tooling to run pipelines and provide build, workflow, and project visibility.
CircleCI exposes REST APIs for v1 and v2, a command-line interface, and an MCP server; developer authentication is centered on CircleCI-issued API tokens, especially personal API tokens.
- CircleCI MCP serverdiscovered
- CircleCI REST API v2discovered
- CircleCI REST API v1discovered
- CircleCI CLIdiscovered
In the CircleCI app, open User settings, then Personal API Tokens, click Create New Token, give it a name, and click Add API Token. Copy the token when it is shown; CircleCI says you will not be able to view it again. The docs state personal API tokens are used to interact with CircleCI APIs v1 and v2, and the API developer guide says they are currently the only supported tokens on API v2.
In the CircleCI app, go to your project's settings, select API Permissions, click Add API Token, choose a scope (Status, Read Only, or Admin), enter a label, and click Add API Token. The docs say project API tokens are for specific projects, and that Read Only and Admin project tokens apply to API v1 only while Status tokens are used for status badges.
conventions · 1/7 published
- integrations.json——
- llms.txt✓https://circleci.com/llms.txt
- API catalog✗
/.well-known/api-catalog - OpenAPI document✗
/api/schema/, /openapi.json, /swagger.json, /api/openapi.json, or /v1/openapi.json - MCP server card✗
/.well-known/mcp/server-card.json - OAuth protected resource✗
/.well-known/oauth-protected-resource - Agent card✗
/.well-known/agent-card.json - Agent skills✗
/.well-known/agent-skills/index.json
Publish these signals → /publishing