Developer Tools

CircleCI MCP Server

Connect your account, then chat with AI to run tools.

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.

Managed
13 tools
Agent guide included

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, and jobs. Org → project → workflow → job hierarchy.

Typical read order

  1. Discover defaults — resolve owner_slug, org_slug, project_slug, workflow_id, and job_number for your account.
  2. Collaborations or pipelines — confirm org access and pick a project_slug when defaults are unset.
  3. Project-scoped reads — insights branches, metrics summary, project metadata, job detail.
  4. Workflow-scoped reads — workflow status, then jobs in that workflow.

Data model

  • Pipelines and projects are org-scoped. Workflows belong to pipelines. Jobs belong to workflows.
  • Insights branch lists and metrics summaries are keyed by project_slug. Contexts (shared env vars) are keyed by owner_slug.
  • Hierarchy: org_slug → project_slug → workflow_id → job_number. Connection defaults on the credential reduce repeated slug params.

Gotchas

  • Slug format: owner_slug and org_slug often look like circleci/<org_id>. project_slug is circleci/<org>/<project>.
  • v1.1 projects embed branch → latest_workflows maps; useful when you have a project but not a pipeline id yet.
  • Connection defaults: save owner_slug, org_slug, and project_slug on the CircleCI credential when you reuse the same org/project.

Tools in this Server (13)

Circleci Discover Defaults

Discover owner_slug, org_slug, project_slug, workflow_id, and job_number for your account. Run first when wiring connection defaults or before project...

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 CircleCI project metadata by project_slug, including VCS linkage and default branch.

Circleci Fetch Workflow

Fetch workflow status and timing by workflow_id, including pipeline linkage and created time.

Circleci List Context

List shared environment-variable contexts for a CircleCI owner. Provide owner_slug or set it as a connection default on your credentials.

Circleci List Insights Branches

List branch-level build insights for a CircleCI project. Shows which branches have recent pipeline activity. Requires project_slug.

Circleci List Me

Return profile details for the authenticated CircleCI user (v1.1 me).

Circleci List Pipelines

List pipelines for an organization. Useful for recent project_slug values and pipeline IDs. Provide org_slug or a connection default.

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 with job_number, name, type, and status for each step.

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

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

One-click install:

The link prefills the Add custom connector dialog — you still review the values and click Add, then Connect to complete OAuth.

Or add manually

  1. Open claude.ai → Settings → Connectors.
  2. Click the + button and choose Add custom connector.
  3. Set Name to CircleCI and paste the MCP URL into Remote MCP server URL.
  4. Click Add. CircleCI will appear under Not connected — select it and click Connect to complete OAuth.
Name: CircleCI
Remote MCP server URL: https://mcp.mcpbundles.com/bundle/circleci
Authentication: OAuth

Custom connectors at claude.ai require a paid Claude plan (Pro, Max, Team, or Enterprise).

Ready to use CircleCI?

Sign in to connect your credentials and start running tools from the chat.

CircleCI MCP Server & Skill