CircleCI MCP Server
by CircleCI-Public
The CircleCI MCP Server allows you to use natural language with LLMs 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 through natural language queries. It acts as a bridge between Large Language Models (LLMs) and the CircleCI platform, allowing users to perform tasks such as retrieving build logs, identifying flaky tests, and checking pipeline statuses using natural language commands.
How to use CircleCI MCP Server?
To use the CircleCI MCP Server, you need to install it and configure it with an MCP client like Cursor IDE, VS Code, Claude Desktop, Claude Code, or Windsurf. The installation process involves adding the server configuration to the respective client's configuration file, providing a CircleCI API token, and optionally specifying the CircleCI base URL for on-prem customers. Once configured, you can use natural language queries within the MCP client to interact with CircleCI.
Key features of CircleCI MCP Server
Retrieves detailed failure logs from CircleCI builds
Identifies flaky tests in your CircleCI project
Retrieves the status of the latest pipeline for a given branch
Retrieves test metadata for CircleCI jobs
Validates CircleCI configuration
Generates structured prompt templates for AI-enabled applications
Generates test cases for prompt templates
Use cases of CircleCI MCP Server
Debugging failed builds using natural language
Analyzing test failures and identifying flaky tests
Checking the status of CI/CD pipelines
Automating CircleCI tasks through natural language commands
Validating and improving CircleCI configuration
Creating and testing prompt templates for AI applications
Quick access to build logs without leaving your IDE
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 the CircleCI MCP Server?
What is the purpose of the CircleCI MCP Server?
It allows you to use natural language to interact with CircleCI through LLMs.
What tools are supported by the CircleCI MCP Server?
What tools are supported by the CircleCI MCP Server?
The server supports tools like get_build_failure_logs, find_flaky_tests, get_latest_pipeline_status, get_job_test_results, config_helper, create_prompt_template, and recommend_prompt_template_tests.
What is needed to install the CircleCI MCP Server?
What is needed to install the CircleCI MCP Server?
You need pnpm package manager, Node.js >= v18.0.0, and a CircleCI API token.
How do I configure the CircleCI MCP Server with Cursor IDE?
How do I configure the CircleCI MCP Server with Cursor IDE?
You need to add the server configuration to your cursor MCP config, providing a CircleCI API token.