Server

cycloidio/cycloid-mcp-server

Connects Claude to Cycloid's internal development portal for infrastructure automation. You get tools to list and create stacks from blueprints, validate StackForms configs, browse service catalogs, and query organization events and pipelines. Runs as an HTTP service with per-request API key headers, so it's multi-tenant ready. The blueprint stack creation tool uses interactive elicitation to walk through complex infrastructure configs. Reach for this when you want conversational access to Cycloid's infrastructure as code workflows without switching contexts. Events can be filtered by timestamp, severity, and type. Built on FastMCP with automatic component discovery from the codebase.

tools: 13
auth: Secret needed
transport: HTTP
last updated: Oct 8, 2025

View on GitHub

Install

From registry metadata

$ npx add-mcp https://mcp.cycloid.io/mcp --name io.cycloid. --header 'X-CY-API-KEY: ${X_CY_API_KEY}' --header 'X-CY-ORG: ${X_CY_ORG}'

Run in your terminal. add-mcp asks which agents to add it to, then asks for each value it needs. Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http io.cycloid. https://mcp.cycloid.io/mcp --header 'X-CY-API-KEY: YOUR_X_CY_API_KEY' --header 'X-CY-ORG: YOUR_X_CY_ORG'

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 13 tools

Verified live against the running server on Nov 6, 2026.

CYCLOID_CATALOG_REPO_LISTList all available service catalog repositories with their details. The LLM can filter the results based on user requirements.

List all available service catalog repositories with their details. The LLM can filter the results based on user requirements.

No parameters. Call it with no arguments.

CYCLOID_COMPONENT_GETGet the state of one or more components in a project environment.3 params

Get the state of one or more components in a project environment.

Parameters* required

canonicals*array

List of component canonicals to fetch.

env*string

The environment canonical.

project*string

The project canonical.

CYCLOID_COMPONENT_LISTList components in a project environment.2 params

List components in a project environment.

Parameters* required

env*string

The environment canonical.

project*string

The project canonical.

CYCLOID_EVENT_LISTList organization events with optional filters. To filter by WHAT HAPPENED, use `action` (e.g. create, update, delete, configure, pause, unpause) and/or `entity` (e.g. component, ci_build, ci_job, pipeline, credential) — these are matched case-insensitively against each event'...6 params

List organization events with optional filters. To filter by WHAT HAPPENED, use `action` (e.g. create, update, delete, configure, pause, unpause) and/or `entity` (e.g. component, ci_build, ci_job, pipeline, credential) — these are matched case-insensitively against each event'...

Parameters* required

actionvalue

Filter by the event's `action` tag (e.g. create, configure, pause).

beginvalue

Unix timestamp (string) start date.

endvalue

Unix timestamp (string) end date.

entityvalue

Filter by the event's `entity` tag (e.g. component, ci_build, pipeline).

severityvalue

Event severities to include (info, warn, err, crit).

typevalue

Event categories to include (Cycloid, AWS, Monitoring, Custom).

CYCLOID_PROJECT_EVENTSList events scoped to a specific project's components. Walks project → envs → components, then filters org-wide events by project tag. Returns events, count, and a deduplicated actors list extracted from tags[key=user]. Actor usernames can be cross-referenced with CYCLOID_MEMB...7 params

List events scoped to a specific project's components. Walks project → envs → components, then filters org-wide events by project tag. Returns events, count, and a deduplicated actors list extracted from tags[key=user]. Actor usernames can be cross-referenced with CYCLOID_MEMB...

Parameters* required

actionvalue

Filter by the event's `action` tag (e.g. create, configure, pause).

beginvalue

Unix timestamp (string) start date.

endvalue

Unix timestamp (string) end date.

entityvalue

Filter by the event's `entity` tag (e.g. component, ci_build, pipeline).

project*string

The project canonical (required).

severityvalue

Event severities to include (info, warn, err, crit).

typevalue

Event categories to include (Cycloid, AWS, Monitoring, Custom).

CYCLOID_MEMBER_LISTList all members of the organization. Use this to look up a member's numeric `id` from their `username`. The `id` field is required to build member URLs: /organizations/<org>/members/<id>.

List all members of the organization. Use this to look up a member's numeric `id` from their `username`. The `id` field is required to build member URLs: /organizations/<org>/members/<id>.

No parameters. Call it with no arguments.

CYCLOID_PIPELINE_LISTList all pipelines from Cycloid.

List all pipelines from Cycloid.

No parameters. Call it with no arguments.

CYCLOID_PROJECT_GETGet one or more projects by canonical.1 params

Get one or more projects by canonical.

Parameters* required

canonicals*array

List of project canonicals to fetch.

CYCLOID_PROJECT_LIST_ENVList environments in a project.1 params

List environments in a project.

Parameters* required

project*string

The project canonical.

CYCLOID_PROJECT_LISTList all projects in the organization.

List all projects in the organization.

No parameters. Call it with no arguments.

CYCLOID_STACKFORMS_VALIDATEValidate a StackForms (.forms.yml) file using the Cycloid CLI. This tool can validate StackForms configuration and provide detailed feedback for fixing issues.1 params

Validate a StackForms (.forms.yml) file using the Cycloid CLI. This tool can validate StackForms configuration and provide detailed feedback for fixing issues.

Parameters* required

forms_content*string

The content of the .forms.yml file to validate

CYCLOID_BLUEPRINT_STACK_CREATECreate a new Cycloid stack from a blueprint. CRITICAL: When elicitation context (ctx) is provided, the tool will ALWAYS use interactive elicitation to ask for parameters one by one, REGARDLESS of any parameters provided. The LLM should ONLY provide the 'ref' parameter and let...1 params

Create a new Cycloid stack from a blueprint. CRITICAL: When elicitation context (ctx) is provided, the tool will ALWAYS use interactive elicitation to ask for parameters one by one, REGARDLESS of any parameters provided. The LLM should ONLY provide the 'ref' parameter and let...

Parameters* required

ref*string

The blueprint reference (e.g., "cycloid-io:terraform-sample")

CYCLOID_BLUEPRINT_LISTList all available blueprints with their details. The LLM can filter the results based on user requirements.

List all available blueprints with their details. The LLM can filter the results based on user requirements.

No parameters. Call it with no arguments.

Readme

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

View the full README on GitHub

Details

Repository: github.com/cycloidio/cycloid-mcp-server
Transport: HTTP
Auth: Required
Registry: MCP registry, active
Resources: 5
Tools verified: Nov 6, 2026