circleci-connector

Read CircleCI build, pipeline, workflow, and test data using a Personal API Token.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/selrai-company/claude-workshop-kit --skill circleci-connector
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: circleci-connector
Source: https://github.com/selrai-company/claude-workshop-kit/tree/main/skills/circleci-connector
Command: npx skills add https://github.com/selrai-company/claude-workshop-kit --skill circleci-connector

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill lets an assistant access and interpret CircleCI build, pipeline, workflow, and test data on behalf of a user so they don't have to manually hunt through CI dashboards or raw logs. It turns noisy failure logs and test histories into concise diagnoses, shows artifacts and usage metrics, and can trigger or rerun pipelines when explicitly confirmed.

Core Features & Use Cases

  • Conversational Bootstrap: Guides non-technical users to create a Personal API Token and securely store it so the assistant can call CircleCI tools without exposing technical details.
  • Read & Inspect: List followed projects, fetch latest pipeline status, retrieve build failure logs, show job test results, list artifacts, detect flaky tests, and download usage data.
  • Actionable Controls: Trigger pipelines, rerun workflows, and initiate rollback pipelines after explicit user confirmation.
  • Error Handling & Safety: Handles token validation (401/403), rate limits, missing projects, and retries while never echoing credentials back to the user.

Quick Start

Connect my CircleCI and show the status of the latest pipeline on my main branch.

Frequently Asked Questions about circleci-connector

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check CircleCI pipeline status without opening the dashboard?

You can check CircleCI pipeline status conversationally by asking the assistant to fetch the latest pipeline state for your main branch. The connector reads build and workflow data on your behalf and summarizes the results without needing a dashboard visit.

How do I diagnose flaky tests in CircleCI workflows?

To detect flaky tests in CircleCI, the connector analyzes your test history and workflow data to identify inconsistent failures. It interprets the test results directly so you receive a concise diagnosis of which tests are unstable.

Can I trigger or rerun CircleCI pipelines from a chat interface?

Yes, you can trigger pipelines and rerun workflows from chat after explicitly confirming the action. The connector sends the start or rerun command to CircleCI and reports back the execution status of the initiated job.

Do I need a CircleCI API token to inspect build failure logs?

Yes, you need a Personal API Token saved into the local MCP server configuration to inspect build failure logs. The connector uses this token to authenticate requests and retrieve logs without exposing the credentials back to you.

What happens if my CircleCI API token is invalid or expired?

If your CircleCI API token is invalid or expired, the connector handles the 401 or 403 authentication errors and guides you through token validation. It safely manages retries and rate limits without echoing your credentials back.

Can I list and download CircleCI artifacts and usage data?

Yes, you can list artifacts and download usage data for your followed CircleCI projects. The connector retrieves available build artifacts and compiles usage metrics so you can inspect them directly in the conversation.