CircleCI MCP Server
for AI Agents

Get a list of pipelines across ALL recently built projects in an organization (org-wide view, up to 250 projects). If you need pipelines for a SPECIFIC project, use list_project_pipelines instead. Requires org-slug from list_collaborations — never guess the slug format.

Get a pipeline by ID

Create a new context

List all contexts for an owner (organization). Use owner-id (UUID) OR owner-slug (format "gh/org-name" for GitHub, "circleci/org-id" for GitLab/GitHub App). The owner-slug requires a VCS prefix — passing just the org name (e.g., "FalconTest") returns 404.

Get a context by ID

Delete a context

List environment variables in a context

Remove an environment variable from a context

Create a project or expression restriction on a context to control which projects can use it. Returns 409 Conflict if the restriction already exists — this means the restriction is already in place (treat as success). Returns 400 if the project ID or expression is invalid.

Get a list of restrictions associated with a context

Delete a restriction from a context

Create a new organization

Get an organization by slug or ID

Delete an organization

Create a new URL Orb allow-list entry

Remove an entry from the org's URL orb allow-list

Create an outbound webhook

List outbound webhooks for a scope

Get a webhook by ID

Update an outbound webhook

Delete an outbound webhook

Create a new project

Get a project by its project-slug (format "vcs-slug/org-name/repo-name"). Returns 404 if the project does not exist. IMPORTANT — never guess the project slug. First call list_collaborations to get the org slug, then call list_pipelines to find the exact project_slug from recent pipeline data.

Get advanced settings for a project. The provider/organization/project path params are the three segments of the project slug — get the full slug from list_pipelines first, then split it.

Update advanced settings for a project. The provider/organization/project path params are the three segments of the project slug — get the full slug from list_pipelines first, then split it.

Create a new checkout key for a project

Get all checkout keys for a project

Create an environment variable for a project

List all environment variables for a project

Get a masked environment variable by name

Delete an environment variable from a project

Create a pipeline schedule for a project

List schedule triggers for a project

Get a schedule by ID

Update a pipeline schedule

Delete a schedule

Create a pipeline definition for a project. The config_source.provider must match the project's actual integration type (e.g., use github_app if the project uses GitHub App, not github_server). Using a provider that doesn't match the project's configured integration returns 400. Check existing definitions via list_pipeline_definitions to see the correct provider.

List all pipeline definitions for a project

Get details for a pipeline definition

Update an existing pipeline definition's name, config file path, or checkout source. You cannot change the provider type to one the project doesn't support (e.g., switching from github_app to github_server returns 400 if no GitHub Server integration is configured). Use list_pipeline_definitions to see the current provider before updating.

Delete a pipeline definition

List environments for an organization

Get an environment by ID

List components for an organization

Get a component by ID

Create a new group in an organization

Get all groups in an organization

Get details for a group in an organization

Delete a group in an organization