CircleCI MCP Server

@MCP-Mirror

About CircleCI MCP Server

Mirror of

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "circleci-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@circleci/mcp-server-circleci"
      ],
      "env": {
        "CIRCLECI_TOKEN": "your-circleci-token",
        "CIRCLECI_BASE_URL": "https://circleci.com"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is CircleCI MCP Server?

This server enables large language models (LLMs) to interact with CircleCI through natural language. It uses the Model Context Protocol (MCP) and can be used with Cursor IDE or any MCP client.

How to use CircleCI MCP Server?

Install via npx and configure environment variables CIRCLECI_TOKEN and optionally CIRCLECI_BASE_URL. The provided tool is get_build_failure_logs, which retrieves failure logs from CircleCI builds using either CircleCI URLs or local project context (workspace root, git remote, branch).

Key features of CircleCI MCP Server

Retrieves detailed build failure logs
Supports CircleCI URLs or local project context
Provides job names, step-by-step execution, failure context
Works with any MCP client (e.g., Cursor IDE)
Easy debugging without leaving your IDE

Use cases of CircleCI MCP Server

Debugging failed builds
Analyzing test failures
Investigating deployment issues
Quick access to build logs from your IDE

FAQ from CircleCI MCP Server

What are the requirements to run this server?

Node.js version 18 or higher, pnpm package manager, and a CircleCI API token with read access.

How do I configure it in Cursor?

Add the following to your Cursor MCP config: command "npx -y @circleci/mcp-server-circleci" with environment variables CIRCLECI_TOKEN and CIRCLECI_BASE_URL.

What tools are available?

Currently, the server provides one tool: get_build_failure_logs which retrieves failure logs from CircleCI builds.

How can I get logs from my local workspace?

Provide the workspace root path, git remote URL, and branch name. The server finds the latest failed pipeline on that branch and returns its logs.

Can I use this server with other MCP clients besides Cursor?

Yes, the server is compatible with any MCP client, as it uses the standardized Model Context Protocol.

Frequently asked questions

What are the requirements to run this server?

Node.js version 18 or higher, pnpm package manager, and a CircleCI API token with read access.

How do I configure it in Cursor?

Add the following to your Cursor MCP config: command `"npx -y @circleci/mcp-server-circleci"` with environment variables `CIRCLECI_TOKEN` and `CIRCLECI_BASE_URL`.

What tools are available?

Currently, the server provides one tool: `get_build_failure_logs` which retrieves failure logs from CircleCI builds.

How can I get logs from my local workspace?

Provide the workspace root path, git remote URL, and branch name. The server finds the latest failed pipeline on that branch and returns its logs.

Can I use this server with other MCP clients besides Cursor?

Yes, the server is compatible with any MCP client, as it uses the standardized Model Context Protocol.

Comments

Basic information

More Other MCP servers

Awesome Mlops

visenger

A curated list of references for MLOps

14.0K

Peekaboo MCP – lightning-fast macOS screenshots for AI agents

steipete

Peekaboo is a macOS CLI & optional MCP server that enables AI agents to capture screenshots of applications, or the entire system, with optional visual question answering through local or remote AI models.

4.8K