Developer Tools

CircleCI MCP Server

Use Studio chat to drive this server — credentials stay in your workspace.

CircleCI is a continuous integration and delivery platform that automates software testing and deployment. Use it to streamline development workflows and improve code quality in software projects.

13 tools
Agent guide included
API Key
Start Chatting

Opens MCPBundles Studio with this server selected. After sign-in, chat and run tools from the same thread.

Browse all tools

AI Skill
SKILL.md

Domain knowledge for CircleCI — workflow patterns, data models, and gotchas for your AI agent.

CircleCI

CircleCI is a CI/CD platform for pipelines, workflows, jobs. Org → project → workflow → job hierarchy.

Data Model

  • Discover defaults returns owner_slug, org_slug, project_slug, workflow_id, job_number for your account. Use to bootstrap other calls.
  • Pipelines and Projects are org-scoped. Workflows belong to pipelines. Jobs belong to workflows.
  • Insights: Branches and metrics by project_slug. Context for env vars (owner_slug).
  • Hierarchy: org_slug → project_slug → workflow_id → job_number. Configurable defaults reduce param passing.

Gotchas

  • Slug format: owner_slug and org_slug often "circleci/<id>". project_slug "circleci/<org>/<project>".
  • discover_defaults: Run first to get slugs and IDs for subsequent calls.
  • Configurable defaults: Set owner_slug, org_slug, project_slug to avoid passing repeatedly.

Tools in this Server (13)

Circleci Discover Defaults

Discover key CircleCI identifiers you can set as Configurable Defaults on your CircleCI credentials. Returns owner_slug, org_slug, project_slug, workf...

Circleci Fetch Insights Metrics

Fetch aggregated insights metrics for a CircleCI project. Use this for high-level performance trends and credit usage summaries. Requires project_slug...

Circleci Fetch Jobs

Fetch details for a specific job run within a CircleCI project. Requires project_slug and job_number.

Circleci Fetch Specific Project

Fetch project details by project_slug.

Circleci Fetch Workflow

Fetch details for a workflow by workflow_id.

Circleci List Context

List contexts for an owner in CircleCI. This is useful for managing shared environment variables. Provide owner_slug (or set it as a Configurable Defa...

Circleci List Insights Branches

List branch insights for a CircleCI project. Use this to see which branches have builds and summarize branch-level activity. Requires project_slug.

Circleci List Me

Fetch information about the authenticated CircleCI user.

Circleci List Pipelines

List pipelines for an organization. Use this to find recent project_slug values and pipeline IDs.

Circleci List Projects

List projects (legacy v1.1) and includes branch/workflow information for recent builds. Useful for discovering recent workflow IDs without knowing a p...

Circleci List Self Collaborations

List organizations/projects you can collaborate on. Useful for discovering owner_slug / org_slug (slug field).

Circleci List Self Ids

Get the authenticated user object (v2). Useful for user_id.

Circleci List Workflow Jobs

List jobs in a workflow (includes job_number, name, status).

Frequently Asked Questions

What is the CircleCI MCP server?

CircleCI is a continuous integration and delivery platform that automates software testing and deployment. Use it to streamline development workflows and improve code quality in software projects. It provides 13 tools that AI agents can use through the Model Context Protocol (MCP).

How do I connect CircleCI to my AI agent?

Add the MCPBundles server URL to your MCP client configuration (Claude Desktop, Cursor, VS Code, etc.). The URL format is: https://mcp.mcpbundles.com/bundle/circleci. Authentication is handled automatically.

How many tools does CircleCI provide?

CircleCI provides 13 tools that can be called by AI agents, along with a SKILL.md that gives your AI agent domain knowledge about when and how to use them.

What authentication does CircleCI require?

CircleCI uses API Key. CircleCI requires credentials. Connect via MCPBundles and authentication is handled automatically.

Setup Instructions

Connect CircleCI to any MCP client in minutes

https://mcp.mcpbundles.com/bundle/circleci

What is MCP?

Model Context Protocol lets AI tools call external capabilities securely through a single URL. This bundle groups tools behind an MCP endpoint that many clients can use.

Use this bundle in 3 steps

  1. Copy the MCP URL above
  2. Open your AI tool and add a new MCP/connector
  3. Paste the URL and follow any auth prompts

Claude Desktop Users

Skip the manual setup! Use the .mcpb file format for one-click installation. Check the Claude Desktop tab for setup instructions.

Pick your tool tab for exact steps

Select ChatGPT, Cursor, Claude Code, or another tab for copy-paste config.

Ready to chat with CircleCI?

Same flow: Studio opens on this server after sign-in. Keep chatting to call tools from the conversation.

CircleCI MCP Server & Skill — 13 Tools