CircleCI MCP Server

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.