CircleCI MCP Cookbook

This repository contains a collection of cookbook examples demonstrating how to use CircleCI MCP (Model Context Protocol) server tools within your IDE with AI agents like Cursor, VSCode Copilot etc.

Overview

The examples in this repository showcase practical implementations and usage patterns for CircleCI MCP server tools, helping you understand how to:

• Enable AI agents to get build logs, test results, and other context from CircleCI to fix issues in your codebase.

Getting Started

These examples are designed to work with any MCP supported AI agents directly in your IDE. Follow these steps to get started:

1. Set up the CircleCI MCP Server by following the instructions in the server repository
2. Choose an example from the list below and follow its specific documentation for detailed usage instructions

Examples

• Fix Failed CircleCI Builds
• Fix Failed Tests in CircleCI Build
• Find Flaky Tests in CircleCI Build

Prerequisites

• IDE with MCP support
• GitHub account
• CircleCI account with Personal Access Token

Contributing

Feel free to add your own examples or improvements to the existing cookbook recipes.

License

Apache 2.0