home / mcp / cycloid mcp server

Cycloid MCP Server

Provides integration between AI assistants and Cycloid infrastructure, enabling blueprints discovery, stack management, and workflow interactions.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "cycloidio-cycloid-mcp-server": {
      "command": "python",
      "args": [
        "server.py"
      ]
    }
  }
}

You can use the Cycloid MCP Server to connect AI assistants with Cycloid’s infrastructure automation capabilities. It enables you to discover blueprints, create and manage infrastructure stacks, and interact with complex workflows through natural language queries, all while leveraging Cycloid’s automation expertise.

How to use

You will interact with the MCP server using a client that communicates through the MCP interface. Start the local server, then use the available tools to explore blueprints, manage stacks, validate configurations, view service catalogs, and monitor events and pipelines.

How to install

Prerequisites: you need Python 3.12 or higher. You may also use Docker for production deployments and a package manager appropriate for your environment (uv for development workflows is recommended). You should have valid Cycloid API credentials for any HTTP-based interactions.

# Clone the project repository
git clone <repository-url>
cd cycloid-mcp-server

# Development setup
make setup

# Run the development server
make dev-server

For a production setup, you can run the server directly via a Python command or package it in a Docker image as shown in production examples. The runtime command to start a local server is the following.

python server.py

If you prefer a containerized production deployment, you can build and run using the project’s production commands and Docker images as described in the production workflow.

Additional notes

Security: each request to the MCP server should include the appropriate organization context and API key when using HTTP transport. When running locally via stdio, ensure you control access to your development environment.

Available tools

CYCLOID_BLUEPRINT_LIST

List all available blueprints with their details.

CYCLOID_BLUEPRINT_STACK_CREATE

Create stacks from blueprints with interactive elicitation.

CYCLOID_STACKFORMS_VALIDATE

Validate StackForms configuration files.

CYCLOID_CATALOG_REPO_LIST

List service catalog repositories.

CYCLOID_EVENT_LIST

List organization events with optional filters such as begin, end, severity, and type.

CYCLOID_PIPELINE_LIST

List all pipelines from Cycloid.