CircleCI MCP Server
by CircleCI-Public
The CircleCI MCP Server allows you to use natural language to interact with CircleCI through tools like Cursor IDE. It leverages the Model Context Protocol (MCP) to manage context between LLMs and CircleCI.
Last updated: N/A
What is CircleCI MCP Server?
The CircleCI MCP Server is an implementation of the Model Context Protocol (MCP) that enables interaction with CircleCI using natural language queries. It acts as a bridge between Large Language Models (LLMs) and CircleCI, allowing users to perform actions and retrieve information from CircleCI through natural language commands.
How to use CircleCI MCP Server?
To use the CircleCI MCP Server, you need to install it and configure it within your chosen MCP client (e.g., Cursor IDE, Claude Desktop, VS Code, Windsurf). This involves adding the server configuration to the client's settings, providing your CircleCI API token, and optionally specifying the CircleCI base URL for on-prem customers. Once configured, you can use natural language commands within the client to interact with CircleCI.
Key features of CircleCI MCP Server
Retrieves detailed failure logs from CircleCI builds using URLs or local project context.
Identifies flaky tests in your CircleCI project by analyzing test execution history.
Supports integration with Cursor IDE, Claude Desktop, VS Code, and Windsurf.
Allows querying CircleCI using natural language.
Provides context-aware information to LLMs for better interaction with CircleCI.
Use cases of CircleCI MCP Server
Debugging failed builds by retrieving logs using natural language.
Analyzing test failures and investigating deployment issues through natural language queries.
Identifying flaky tests in a CircleCI project to improve test reliability.
Quick access to build logs without leaving your IDE.
Automating CircleCI tasks 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 the purpose of this server?
What is the purpose of this server?
This server allows you to use natural language to accomplish things with CircleCI using tools like Cursor IDE.
What are the requirements for using this server?
What are the requirements for using this server?
You need pnpm, Node.js >= v18.0.0, and a CircleCI API token.
How do I install this server?
How do I install this server?
You need to configure your MCP client (e.g., Cursor IDE, VS Code) with the provided configuration, including your CircleCI API token.
What tools are supported?
What tools are supported?
The server supports get_build_failure_logs and find_flaky_tests.