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

Yes! Use the `trigger_cci_pipeline` 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.

How do I see why a specific job failed?

Use the `get_job_details` 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.

Where do I find my CircleCI API Token?

Log in to CircleCI, go to **User Settings -> Personal API Tokens**. You can generate and copy a new token from there.

CircleCI MCP Server

Name: CircleCI
Availability: InStock
Author: Vinkius

circleci.com

Built by Vinkius GDPR ToolsFree

Manage CI/CD pipelines and workflows via CircleCI — track jobs, trigger pipelines, and monitor build status directly from any AI agent.

Vinkius AI Gateway supports streamable HTTP and SSE.

Works with every AI agent you already use

…and any MCP-compatible client

CircleCI MCP Server: see your AI Agent in action

AI Agent→Vinkius→CircleCI

You

Vinkius AI Gateway

GDPR·High Security·Kill Switch·Ultra-Low Latency·Plug and Play

Built-in capabilities (8)

get_job_details

Get detailed information for a specific job

get_my_cci_profile

Retrieve information about the authenticated user

get_workflow_details

Get detailed information for a specific workflow

list_cci_contexts

List shared contexts for an organization

list_cci_pipelines

List recent CI/CD pipelines

list_pipeline_workflows

List all workflows within a specific pipeline

list_workflow_jobs

List all jobs within a specific workflow

trigger_cci_pipeline

Trigger a new pipeline for a project

What this connector unlocks

Connect your CircleCI account to any AI agent and take full control of your CI/CD pipelines and software delivery through natural conversation. Streamline how you monitor and trigger automated builds.

What you can do

Pipeline Oversight — List and retrieve details for recent CI/CD pipelines across your organizations natively
Trigger Management — Manually trigger new pipeline runs for specific projects and branches flawlessly
Workflow Intelligence — Access detailed information for workflows and their constituent jobs securely
Job Auditing — Retrieve detailed metadata and execution status for specific jobs flawlessly
Context Logistics — List shared environment contexts used for securing sensitive project data flawlessly
Developer Insights — Retrieve your own user profile and organization membership information directly within your workspace

How it works

1. Subscribe to this server
2. Enter your CircleCI Personal API Token (obtained from User Settings)
3. Start managing your pipelines from Claude, Cursor, or any MCP-compatible client

Who is this for?

DevOps Engineers — monitor pipeline health and trigger manual builds using natural language
Software Developers — audit job failures and review workflow progress without opening the CircleCI dashboard
Release Managers — verify release pipeline status and approve manual gates straight from their chat interface
Infrastructure Teams — manage shared contexts and environment variables across projects

Frequently asked questions

Give your AI agents the power of CircleCI

Access CircleCI and 2,000+ MCP servers — ready for your agents to use, right now. No glue code. No custom integrations. Just plug Vinkius AI Gateway and let your agents work.

DETAILS

CategoryShip It

Traefik Hub

8 tools

Cloud-native API Management & Gateway evaluating proxy topologies explicitly running Kubernetes integrations.

DigitalOcean

10 tools

Equip your AI agent to manage cloud infrastructure, track Droplets, and monitor managed databases via the DigitalOcean API.

Applitools

10 tools

Bring AI-powered visual testing to your AI agent — inspect test batches, review UI diffs, and manage your visual baselines naturally.

Mindbody

15 tools

Manage classes, appointments, clients, staff, and sales from your Mindbody-powered fitness studio, spa, or wellness business through natural conversation.

Elastic Email

10 tools

Equip your AI agent to manage email campaigns, track contacts, and monitor delivery logs via the Elastic Email API.

Nutritionix

2 tools

Analyze food nutrition from natural language using the industry-leading NLP engine — type any meal description and get instant, precise calorie and macro data.