CircleCI Connector for AI agents.

Q: Can I trigger a build for a specific branch through the agent?

Yes! Use the triggerccipipeline tool. You need to provide the project slug (e.g., gh/org/repo) and the branch name. The agent will instruct CircleCI to start the pipeline immediately.

Q: How do I see why a specific job failed?

Use the getjobdetails tool with the project slug and job number. Your agent will fetch the execution status and metadata, which often points to the cause of failure.

8 live capabilities

Manage CI/CD pipelines and trigger automated builds from your agent.

Live agent request CircleCI / Connector

Waiting for input…

AI Agent

Why people use CircleCI

CircleCI for CI/CD Pipeline Management

This Connector changes that. You just ask your agent for the status or to trigger a run. It pulls the data and puts it right in front of you. You get a continuous workflow where the AI handles the navigation and you just make the decisions.

What Vinkius changes

You get direct, conversational control over your CircleCI builds without leaving your primary workspace.

Use it from Claude, ChatGPT, Cursor or another AI client you already have.

One account · 5,900+ Connectors

Real-world use case 01

Debugging a failed build

A developer asks why the last build failed.
Real-world use case 02

Manual production deployment

A release manager tells the agent to start a build on the main branch.
Real-world use case 03

Onboarding and permissions

A new team member asks for their account details.

Complete set · 8capabilities

The complete CircleCI capability set.

These are the exact actions your AI can choose when you ask it to work with CircleCI.

Capability set01 / 02

01—04

4 capabilities in this set.

Part of 8 available through CircleCI.

01 Capability
Get my cci profile
Get your account details and membership info. This helps you confirm which user is currently authenticated.
02 Capability
Get workflow details
Pull specific data for a single workflow. Use this to see the structure of a specific pipeline.
03 Capability
List cci contexts
See all shared contexts for an organization. This is useful for checking available environment variables.
04 Capability
List workflow jobs
See every job inside a specific workflow. Use this to audit the full sequence of a build.

Capability set02 / 02

05—08

4 capabilities in this set.

Part of 8 available through CircleCI.

05 Capability
List cci pipelines
List your most recent CI/CD pipelines. This gives you a quick look at recent activity across projects.
06 Capability
Trigger cci pipeline
Start a new pipeline run for a project. You can use this to kick off builds on specific branches.
07 Capability
Get job details
Get the execution status and metadata for a specific job. This helps you find exactly where a build failed.
08 Capability
List pipeline workflows
List all workflows tied to a specific pipeline. This helps you see the different paths a pipeline can take.

Set up in minutes

One URL. Then ask CircleCI to work.

Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use CircleCI from the conversation.

Choose your client

Live preview

Advanced clients IDE · CLI

Claude · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_RYNFniMxh53CKeYToBM2UNUbXRz4n2cftwtxDiON/mcp

Step 01

Open Connectors

In Claude Web or Claude Desktop, open Settings and choose Connectors.
Step 02

Add the URL

Choose Add custom connector, name it CircleCI, and paste the URL above.
Step 03

Turn it on in chat

Select +, open Connectors, and enable CircleCI for the conversation.

ChatGPT · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_RYNFniMxh53CKeYToBM2UNUbXRz4n2cftwtxDiON/mcp

Step 01

Open MCP settings

On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
Step 02

Add the URL

Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the CircleCI URL.
Step 03

Save and start

Save the connection and enable CircleCI in your conversation. Desktop may ask you to restart once.

Cursor · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "circleci": {
      "url": "https://edge.vinkius.com/vk_preview_RYNFniMxh53CKeYToBM2UNUbXRz4n2cftwtxDiON/mcp"
    }
  }
}

Step 01

Open MCP Settings

Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
Step 02

Add the server config

Paste the JSON configuration above into the mcp.json file that opens
Step 03

Save the file

Cursor will automatically detect the new Connector
Step 04

Start using CircleCI

Open Agent mode in chat and ask: "Using CircleCI, help me...". 8 tools available

VS Code Copilot · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "circleci": {
      "url": "https://edge.vinkius.com/vk_preview_RYNFniMxh53CKeYToBM2UNUbXRz4n2cftwtxDiON/mcp"
    }
  }
}

Step 01

Create MCP config

Create a .vscode/mcp.json file in your project root
Step 02

Add the server config

Paste the JSON configuration above
Step 03

Enable Agent mode

Open GitHub Copilot Chat and switch to Agent mode using the dropdown
Step 04

Start using CircleCI

Ask Copilot: "Using CircleCI, help me...". 8 tools available

Windsurf · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "circleci": {
      "url": "https://edge.vinkius.com/vk_preview_RYNFniMxh53CKeYToBM2UNUbXRz4n2cftwtxDiON/mcp"
    }
  }
}

Step 01

Open MCP Settings

Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
Step 02

Add the server

Paste the JSON configuration above into mcp_config.json
Step 03

Save and reload

Windsurf will detect the new server automatically
Step 04

Start using CircleCI

Open Cascade and ask: "Using CircleCI, help me...". 8 tools available

Cline · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "circleci": {
      "url": "https://edge.vinkius.com/vk_preview_RYNFniMxh53CKeYToBM2UNUbXRz4n2cftwtxDiON/mcp"
    }
  }
}

Step 01

Open Cline MCP Settings

Click the Connectors icon in the Cline sidebar panel
Step 02

Add remote server

Click "Add Connector" and paste the configuration above
Step 03

Enable the server

Toggle the server switch to ON
Step 04

Start using CircleCI

Ask Cline: "Using CircleCI, help me...". 8 tools available

Claude Code · Terminal command

Official guide ↗

Advanced setup

claude mcp add circleci --transport http "https://edge.vinkius.com/vk_preview_RYNFniMxh53CKeYToBM2UNUbXRz4n2cftwtxDiON/mcp"

Step 01

Install Claude Code

Run npm install -g @anthropic-ai/claude-code if not already installed
Step 02

Add the Connector

Run the command above in your terminal
Step 03

Verify the connection

Run claude mcp to list connected servers, or type /mcp inside a session
Step 04

Start using CircleCI

Ask Claude: "Using CircleCI, show me...". 8 tools are ready

Where the request belongs

Work CircleCI can move forward.

Built around the request

For DevOps engineers and release managers who spend half their day clicking through build logs or manually triggering pipelines across dozens of projects.

DevOps Engineer

Checks pipeline health and triggers manual builds during production incidents using natural language.

Software Developer

Audits failed jobs and reviews workflow progress while staying in their IDE.

Release Manager

Verifies release status and approves manual gates via a chat interface.

When one Connector is not enough

Combine CircleCI with the systems that finish the task.

View all recipes

Connectors That Diagnose CI Failures First

Your CI pipeline has been red for 6 hours and the team keeps pushing to the same branch , nobody knows the failure is a flaky infrastructure test, not their code

Track Engineering Metrics Using Connectors

Merge request velocity measured, pipeline success rates tracked, cycle time calculated, team metrics published , build your DORA dashboard without a BI capability

Track Technical Debt Per Pull Request via MCP

Build failures analyzed, code complexity measured, tech debt cataloged, remediation prioritized , track what you owe your codebase

Build the capability set

Each Connector adds new actions and data without changing how you work.

Browse Connectors

01 8 capabilities

Codefresh

Manage CI/CD and GitOps via Codefresh. track pipelines, trigger builds, and monitor delivery clusters directly from any AI agent.

View Connector

02 10 capabilities

Travis CI

Manage CI/CD pipelines, trigger custom builds, and oversee repository testing health securely via your AI agent.

View Connector

03 36 capabilities

Semaphore

Automate CI/CD workflows, manage pipelines, and monitor build jobs directly from your AI agent.

View Connector

04 11 capabilities

Buildkite

Automate CI/CD pipelines via Buildkite. manage builds, agents, and deployments directly from any AI agent.

View Connector

05 34 capabilities

Woodpecker CI

Manage your Woodpecker CI instance. control pipelines, monitor agents, and configure repositories directly from your AI agent.

View Connector

06 28 capabilities

AppVeyor

Manage CI/CD pipelines, users, roles, and collaborators on AppVeyor directly from your AI agent.

View Connector

Bring your own AI

Change the model, client or framework. Keep CircleCI connected.

Claude
ChatGPT
Gemini
Cursor
VS Code
Windsurf
ZCode
Cline
Zed
Continue
Kiro
Roo Code
Zencoder
Goose
Void
Augment Code
Amp
Qodo
Tabnine
Pieces
Sourcegraph Cody
JetBrains
Warp
Amazon Q
Antigravity
BoltAI
Raycast
Jan
LM Studio
AnythingLLM
Open WebUI
Msty
Cherry Studio
LibreChat
TypingMind
Chorus
5ire
n8n
LangChain
LlamaIndex
CrewAI
Vercel AI SDK

Before you connect

Questions about CircleCI.

The practical details behind the request, access and result.

Can I use the CircleCI MCP to trigger builds?

Yes. You can ask your agent to start a new pipeline for any project and branch. It will handle the request and return the new pipeline ID for you.

How do I see why my build failed using this Connector?

Just ask your agent for the status of a specific job. It will pull the execution metadata and tell you exactly where the process stopped.

Does the CircleCI MCP work with Cursor and Claude?

Yes. Since it's an Connector, it works with any compatible client like Claude, Cursor, Windsurf, or VS Code once connected via Vinkius.

Can I check my user profile with CircleCI MCP?

Yes. Your agent can retrieve your account details, membership information, and other profile data directly from CircleCI.

Can I see all the jobs in a specific workflow?

Yes. You can ask your agent to list all jobs within a workflow. It will show you every step in the sequence and their current statuses.

Can I manage shared contexts with CircleCI MCP?

Yes. You can ask your agent to list the shared contexts for your organization to see what environment variables are currently available.

Can I trigger a build for a specific branch through the agent?

Yes! Use the trigger_cci_pipeline capability. You need to provide the project slug (e.g., gh/org/repo) and the branch name. The agent will instruct CircleCI to start the pipeline immediately.

How do I see why a specific job failed?

Use the get_job_details capability with the project slug and job number. Your agent will fetch the execution status and metadata, which often points to the cause of failure.

Where do I find my CircleCI API Token?

One connection away

Give your agent a direct line to CircleCI.

Connect CircleCI once. Keep it beside 5,900+ managed Connectors when the next task needs more.

Explore every Connector No credit card required · Free tier available

CircleCI for CI/CD Pipeline Management

You get direct, conversational control over your CircleCI builds without leaving your primary workspace.

Debugging a failed build

Manual production deployment

Onboarding and permissions

Get my cci profile

Get workflow details

List cci contexts

List workflow jobs

List cci pipelines

Trigger cci pipeline

Get job details

List pipeline workflows

Open Connectors

Add the URL

Turn it on in chat

Open MCP settings

Add the URL

Save and start

Open MCP Settings

Add the server config

Save the file

Start using CircleCI

Create MCP config

Add the server config

Enable Agent mode

Start using CircleCI

Open MCP Settings

Add the server

Save and reload

Start using CircleCI

Open Cline MCP Settings

Add remote server

Enable the server

Start using CircleCI

Install Claude Code

Add the Connector

Verify the connection

Start using CircleCI

DevOps Engineer

Software Developer

Release Manager

Connectors That Diagnose CI Failures First

Track Engineering Metrics Using Connectors

Track Technical Debt Per Pull Request via MCP

Codefresh

Travis CI

Semaphore

Buildkite

Woodpecker CI

AppVeyor

Give your agent a direct line to CircleCI.