CircleCI MCP Server
Provides tools for interacting with CircleCI, enabling agents to investigate pipelines and cancel reviewed stuck workflows through PipMCP-hosted discovery and execution.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Understand a stuck build before cancelling anything
CircleCI + your AI assistant · powered by PipMCP
You want to understand a stuck build before cancelling anything, using the account your team has actually connected.
Made for: Owners checking an app build
For real use, you will need PipMCP and access to CircleCI.
Ask your AI to set this up
Paste this into a coding assistant that can open project files and run commands, such as Codex, Claude Code or Grok Build. You do not need to understand the code first.
Help me use this project: https://github.com/jannikco/circleci-mcp
I'm not a programmer. My goal is: Understand a stuck build before cancelling anything.
Read the project instructions and set it up in a new folder without overwriting my work.
Guide me through PipMCP and its private key setup; never ask me to paste secrets into this
chat. Run a documented sample-data demo if available, then help me get a first small
result from my connected app. Explain the result in plain English. Ask before changing
records, sending messages or publishing anything.Related MCP server: GitHub Actions MCP Server
Three useful things to ask for
Show recent project pipelines and workflows for the pipeline I choose.Explain which workflow appears stuck from its actual state. Ask before cancelling the
exact workflow I select.Prepare a build-investigation note from the pipeline and workflow states we reviewed.Your path to a real result
flowchart LR
A["Ask your AI"] --> B["Connect PipMCP"] --> C["Understand a stuck<br/>build before<br/>cancelling…"] --> D["Review together"]Open PipMCP setup and sign in or create your account.
Connect the app in PipMCP with the permissions you want to grant.
Create the product API key through the official setup, add it privately to your AI project's environment, and ask your AI to try a small read.
What to expect: Connect CircleCI in your PipMCP account, then use your PipMCP key for the supported actions. Review proposed changes before they are sent. Results depend on the connected account and its permissions; check the returned outcome before relying on it.
Add your PipMCP key privately in your project settings. Keep keys out of chat and public repositories.
Keep going
CircleCI MCP server
Use CircleCI from Claude Code, Codex, Grok Build and MCP clients through PipMCP. One PipMCP API key connects this package to private execution.
Activate with PipMCP · Integration directory
Build something useful
Investigate pipelines then cancel a reviewed stuck workflow. Read provider data first, then explicitly approve the selected change with operator write opt-in and a unique per-call approval key.
The package is an authenticated client: discovery, schemas, policy decisions and execution come from PipMCP. Provider implementation remains on the server.
Quick start
Requires Node.js 22+. Clone this repository, then:
npm ci --ignore-scripts
npm test
npm start
# After configuring your provider in PipMCP and setting PIPMCP_API_KEY:
npm start -- --live
# Launch the stdio MCP bridge:
npm run serverCreate a PipMCP API key with explicit connectors:read and connectors:call scopes. Set PIPMCP_API_KEY in the calling process environment. Provider credentials are configured in PipMCP. Multiple accounts require explicit PIPMCP_INTEGRATION_ID and PIPMCP_CONNECTION_ID from discovery. Existing keys do not gain scopes automatically.
Built for coding agents
Install this repository's skill into your project:
node lib/cli.mjs agents install --client codex --scope project --project /path/to/project
# Use claude or grok for those clients.Connect AI agents to CircleCI using one PipMCP API key and actual hosted tool discovery. Native AGENTS.md, CLAUDE.md and project skills support the current coding session. No additional AI model key is required. capabilities.json describes the package; llms.txt indexes its instructions.
Inspect actual tools before calling
import {PipMCPGatewayClient} from './lib/index.mjs';
const client = new PipMCPGatewayClient(); // PIPMCP_API_KEY
const inventory = await client.getTools("circleci");
console.log(inventory.data.tools);
// Select a real tool and validate your arguments against its returned schema.
// client.callTool(provider, actualToolName, reviewedArguments, {idempotencyKey});PipMCP enforces workspace, role, connection, policy/approval and usage controls. Preserve the original idempotency key when retrieving/resuming a receipt. Pending and confirmation_required are not completed provider results; uncertain writes are held for reconciliation. The bridge never auto-approves a hosted action.
Version 1 migration
This release uses the authenticated PipMCP gateway for real discovery/execution. Upgrade your MCP launch command and configure PIPMCP_API_KEY before reconnecting. Historical local runtimes remain available under their original MIT license in Git history.
Evidence and support
Transport, package and agent fixtures are tested. Authentication/provider access must be checked in your own configured workspace; synthetic fixtures do not establish live provider execution. Do not include credentials or customer records in public issues. MIT covers this public client.
Provider setup reference
Official provider documentation. Credentials are entered in PipMCP; this package does not accept or store provider secrets.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Connect any AI agent to 1,000+ apps and 27,000+ actions through one remote MCP server (OAuth).
Zero-setup MCP gateway securely connecting AI to your tools with authentication and workflows
The OpenRouter for tools. One MCP connection gives any AI agent 254 hosted tools, pay per call.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceConnects AI agents and MCP clients to Azure DevOps through a single PipMCP API key, exposing hosted tool discovery, schema validation, and policy-governed execution so agents can read project and pipeline data and approve selected write actions.1,134 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents and MCP clients to inspect CI runs and dispatch explicitly reviewed workflows through PipMCP, with hosted schemas, policy checks, and approval-gated execution.19 npmMIT
- AlicenseNot gradedqualityBmaintenanceConnects AI agents and MCP clients to CRM operations through PipMCP, providing hosted tool discovery, schema validation, and governed execution with one API key.MIT
- AlicenseNot gradedqualityBmaintenanceConnects AI agents and MCP clients to Deepgram through a single PipMCP API key, enabling hosted tool discovery, policy-governed execution, and workflows such as inspecting projects and requesting URL transcriptions.96 npmMIT