CircleCI MCP Server
by CircleCI-Public
The CircleCI MCP Server allows you to use natural language via an MCP Client (like Cursor IDE) to interact with CircleCI. 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 the CircleCI platform.
How to use CircleCI MCP Server?
- Install the server using pnpm. 2. Configure your MCP client (e.g., Cursor IDE) with the server details, including your CircleCI API token. 3. Use natural language queries within your MCP client to interact with CircleCI, such as retrieving build logs or finding failed pipelines.
Key features of CircleCI MCP Server
Natural language interaction with CircleCI
Retrieval of build failure logs
Support for CircleCI URLs and local project context
Integration with MCP-compatible clients like Cursor IDE
Use cases of CircleCI MCP Server
Debugging failed builds using natural language
Analyzing test failures through conversational queries
Investigating deployment issues with simple commands
Quick access to build logs without leaving your IDE
Automating CircleCI tasks using natural language
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 Cursor IDE?
What is Cursor IDE?
Cursor IDE is an example of an MCP Client that can be used to interact with the CircleCI MCP Server.
How do I get a CircleCI API token?
How do I get a CircleCI API token?
You can generate a CircleCI API token through the CircleCI settings page.
What is the purpose of the CIRCLECI_BASE_URL environment variable?
What is the purpose of the CIRCLECI_BASE_URL environment variable?
The CIRCLECI_BASE_URL environment variable specifies the base URL for your CircleCI instance. It defaults to https://circleci.com.
What kind of access does the API token need?
What kind of access does the API token need?
The API token needs read access to your CircleCI projects.