CircleCI Legacy Standalone MCP Server

Enable AI Agents to fix build failures from CircleCI.

Local serverstdio

What is the CircleCI Legacy Standalone MCP Server?

This profile describes CircleCI’s older standalone MCP package, rather than its current hosted service or CLI-integrated MCP server.

Published migration notice

CircleCI has published a security and deprecation notice for the standalone package. Check that notice before keeping an old package configuration in an active client. The replacement routes have different runtimes and authentication, so copying a new endpoint into an old local command is not a complete migration.

Choose a current route

Use CircleCI Hosted for the documented remote CI-run workflow. Use the current CircleCI CLI MCP when the work requires the CLI’s broader local configuration and administrative surface. CircleCI Server users should follow the vendor’s migration guidance for their installation.

Verify the migration

After adding the selected replacement, confirm the authenticated account and read a known project run. Check the returned branch and job before asking for a rerun. Keep the old configuration disabled once the replacement is working so tool names and actions do not resolve to an unintended server.

This historical URL is retained for existing links. It should not be read as a recommendation to begin a new installation with the deprecated standalone package.

Publisher documentation

Source 1 · Source 2

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
Example"Run the pipeline for https://app.circleci.com/pipelines/github/org/repo/123"
Textdefault): Returns flaky test details in text format
Filerequires FILE_OUTPUT_DIRECTORY env var): Creates a directory with flaky test details
Step-bystep execution details

How to install the CircleCI Legacy Standalone MCP Server

{
  "mcpServers": {
    "circleci-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@circleci/mcp-server-circleci@latest"
      ],
      "env": {
        "CIRCLECI_TOKEN": "YOUR_CIRCLECI_TOKEN",
        "CIRCLECI_BASE_URL": "https://circleci.com",
        "MAX_MCP_OUTPUT_LENGTH": "50000"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
CIRCLECI_TOKENDeclared in the maintainer’s client configuration.Check documentation
CIRCLECI_BASE_URLDeclared in the maintainer’s client configuration.Yes
MAX_MCP_OUTPUT_LENGTHDeclared in the maintainer’s client configuration.Optional

Frequently asked questions

Enable AI Agents to fix build failures from CircleCI. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.