English Français العربية

io.cycloid.mcp/server

Official registry Other

An MCP server that let you interact with Cycloid.io Internal Development Portal and Platform

Source code Documentation

What can you do with io.cycloid.mcp/server?

  • 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 (begin, end, severity, type)
  • CYCLOID_PIPELINE_LIST: List all pipelines from Cycloid

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http server 'https://mcp.cycloid.io/mcp' --header 'X-CY-API-KEY: <API key for authentication>' --header 'X-CY-ORG: <The organization canonical name (tenant) you want to interact with>'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "server": {
            "type": "http",
            "url": "https://mcp.cycloid.io/mcp",
            "headers": {
                "X-CY-API-KEY": "<API key for authentication>",
                "X-CY-ORG": "<The organization canonical name (tenant) you want to interact with>"
            }
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Cycloid MCP Server
  2. Overview
  3. Available Tools
  4. Available Resources
  5. Architecture
  6. HTTP Transport
  7. Quick Start
  8. MCP Configuration
  9. Available Commands
  10. Contributing
  11. License

Cycloid MCP Server

A Model Context Protocol (MCP) server that provides seamless integration with the Cycloid platform, enabling AI assistants to interact with Cycloid's infrastructure management capabilities through natural language.

Overview

The Cycloid MCP Server bridges the gap between AI assistants and Cycloid's powerful infrastructure automation platform. It enables users to:

  • Discover and explore available blueprints and service catalogs
  • Create and manage infrastructure stacks using Cycloid's blueprints
  • Interact naturally with complex infrastructure workflows through AI assistants
  • Leverage Cycloid's expertise in infrastructure as code and automation

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 (begin, end, severity, type)
  • CYCLOID_PIPELINE_LIST: List all pipelines from Cycloid

Available Resources

  • cycloid://blueprints: Access to blueprint information
  • cycloid://service-catalogs-repositories: Access to service catalog repositories information
  • cycloid://events: Access to recent organization events as JSON
  • cycloid://pipelines: Access to pipeline information
Event Filters
  • begin/end: Unix timestamps (strings) delimiting the time window
  • severity: One or more of info, warn, err, crit
  • type: One or more of Cycloid, AWS, Monitoring, Custom

Architecture

The server uses a dynamic component registration system based on FastMCP's MCPMixin:

  • Automatic Discovery: Components are automatically discovered from src/components/
  • File-based Organization: Components are organized by feature (catalogs/, stacks/)
  • Standard Patterns: Each component follows the pattern *_tools.py, *_resources.py, *_handlers.py, *_prompts.py
  • MCPMixin Integration: Uses FastMCP's built-in register_all() method for proper tool/resource registration

HTTP Transport

The Cycloid MCP Server runs as a web service using HTTP transport. Organization and API key are provided via HTTP headers (X-CY-ORG and X-CY-API-KEY) for each request, enabling multi-tenant usage.

Usage: python server.py

Quick Start

Prerequisites
  • Python 3.12 or higher
  • uv package manager (recommended)
  • Docker (for production deployment)
  • Valid Cycloid API credentials
Development Setup
# Clone and setup
git clone <repository-url>
cd cycloid-mcp-server
make setup

# Run development server
make dev-server
Production Setup
Using Pre-built Docker Images

The project provides pre-built Docker images via Docker Hub:

# Pull the latest image
docker pull cycloid/cycloid-mcp-server:latest

# Run the server
docker run -p 8010:8010 cycloid/cycloid-mcp-server:latest
Building Locally
# Build Docker image
make build

# Run production server
make prod-server

MCP Configuration

For detailed MCP server configuration examples, see mcp-examples.md.

Available Commands

# Development Environment
make setup          # Setup development environment with uv
make install        # Install dependencies
make help           # Show all available commands
make validate-env   # Validate local environment matches CI

# Development Server
make dev-server     # Run development server using Python virtual environment

# HTTP Server
python server.py  # Run HTTP server

# Production
make build          # Build Docker image
make prod-server    # Run production server using Docker

# Testing and Quality
make test           # Run all tests
make type-check     # Run pyright type checking
make lint           # Run PEP 8 linting with flake8
make format         # Format code with black and isort
make quality-check  # Run all quality checks (tests + type checking + linting)
make simulate-ci    # Validate environment and run quality checks

# Cleanup
make clean          # Clean up development artifacts
make clean-docker   # Clean up Docker artifacts

Contributing

See CONTRIBUTING.md for detailed development guidelines.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Frequently asked questions

What is io.cycloid.mcp/server?

An MCP server that let you interact with Cycloid.io Internal Development Portal and Platform

How do I install io.cycloid.mcp/server?

It runs as a remote server. In Claude Code: claude mcp add --transport http server 'https://mcp.cycloid.io/mcp' --header 'X-CY-API-KEY: <API key for authentication>' --header 'X-CY-ORG: <The organization canonical name (tenant) you want to interact with>'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.cycloid.mcp/server need an API key?

Yes. It expects X-CY-API-KEY, X-CY-ORG, which you set in its configuration.

Is io.cycloid.mcp/server open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.cycloid.mcp/server?

It is published by cycloidio. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.