CircleCI MCP Server
by CircleCI-Public
The CircleCI MCP Server allows you to interact with CircleCI using natural language via a Model Context Protocol (MCP) client. It enables you to accomplish tasks like retrieving logs and identifying flaky tests using natural language commands.
Last updated: N/A
What is CircleCI MCP Server?
The CircleCI MCP Server is an implementation of the Model Context Protocol (MCP) that allows Large Language Models (LLMs) to interact with CircleCI. It acts as a bridge, enabling users to use natural language commands to query and manage their CircleCI projects.
How to use CircleCI MCP Server?
To use the server, you need to install it and configure your MCP client (e.g., Cursor IDE, Claude Desktop, VS Code, Windsurf) with the server's connection details, including your CircleCI API token. The configuration involves specifying the command to run the server and setting the necessary environment variables. Once configured, you can use natural language commands within your MCP client to interact with CircleCI.
Key features of CircleCI MCP Server
Retrieves detailed failure logs from CircleCI builds using natural language.
Identifies flaky tests in your CircleCI project by analyzing test execution history.
Supports both CircleCI URLs and local project context for querying information.
Integrates with various MCP clients like Cursor IDE, Claude Desktop, VS Code, and Windsurf.
Use cases of CircleCI MCP Server
Debugging failed builds by retrieving logs using natural language queries.
Analyzing test failures to identify root causes.
Investigating deployment issues through log retrieval.
Identifying unreliable tests in your test suite using natural language commands.
FAQ from CircleCI MCP Server
What is MCP?
What is MCP?
Model Context Protocol (MCP) is a standardized protocol for managing context between large language models (LLMs) and external systems.
What is a CircleCI API token and how do I get one?
What is a CircleCI API token and how do I get one?
A CircleCI API token is required to authenticate with the CircleCI API. You can generate one through the CircleCI settings page.
Which IDEs are supported?
Which IDEs are supported?
The server can be used with any MCP client, including Cursor IDE, Claude Desktop, VS Code, and Windsurf.
How do I configure the server with my IDE?
How do I configure the server with my IDE?
You need to add the server configuration to your IDE's MCP settings, including the command to run the server and your CircleCI API token.
What if I'm using CircleCI on-prem?
What if I'm using CircleCI on-prem?
You need to set the CIRCLECI_BASE_URL environment variable to your CircleCI on-prem URL.