Cycloid MCP

Name: Cycloid MCP
Author: cycloidio

by cycloidioversion 1.0.1i★ 0iRuns in the cloud

Registry nameio.cycloid.mcp/server

How to install

Overview

Description from the maker (original English)

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

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Runs in the cloud
Transport: Streamable HTTP
Category: Other
You need to fill in: X-CY-API-KEY, X-CY-ORG

Install

Pick the AI app you use, then copy the settings.

Passed 5/5 checks · What you ask goes through the maker’s server (mcp.cycloid.io)

First: which AI do you use?

ClaudeWeb · app · phoneChatGPTWebClaude CodeTerminalCursorCode editorVS CodeCode editorOtherOther apps

Pick your app and the steps appear below.

Works with Claude · about 5 min

You need a Cycloid MCP key (sign up on the maker’s site, may cost money) · Set it up once on claude.ai or the desktop app, then use it in chat · free accounts can add 1

Sign up and create a Cycloid MCP key
Open the maker’s site, sign up and create an API key for the next step. It may cost money.
How to get a key is in the maker’s README below
Done
Open Claude’s Connectors page
CustomizeConnectors
Done
Click “+ Add” → “Add custom connector” and fill in these 2 fields
Copy each value into the field with the same name in Claude, then click Continue
Name · NameCycloid MCP
Remote MCP server URL · Addresshttps://mcp.cycloid.io/mcp
Under Request headers, add this name and value
Header nameX-CY-API-KEY
Value<paste your key here>
Header nameX-CY-ORG
Value<paste your key here>
Paste the key only into the app’s field, never into a chat or to anyone
Leave Authentication as Claude detected it, then click Add
Done
Turn it on in a chat
+ConnectorsCycloid MCP
Done
Try it
Use Cycloid MCP and tell me what you can do for me, then show me one thing
✓ If Claude says it is using Cycloid MCP or shows a Cycloid MCP tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

ChatGPT cannot connect Cycloid MCP yet

Cycloid MCP needs your own key to connect, but OpenAI’s help page only describes OAuth sign-in; there is no key option we could verify

What you can do instead

A · Use an app that can connect Cycloid MCP

Steps for Claude →You need a Cycloid MCP key (sign up on the maker’s site, may cost money) · Set it up once on claude.ai or the desktop app, then use it in chat · free accounts can add 1
Steps for Claude Code →You need a Cycloid MCP key (sign up on the maker’s site, may cost money)
Steps for Cursor →You need a Cycloid MCP key (sign up on the maker’s site, may cost money)
Steps for VS Code →You need a Cycloid MCP key (sign up on the maker’s site, may cost money)

B · Others in Other that work with ChatGPT

Picked from the most used in the same category, only ones that connect by address with no key

Hostinger✓ ChatGPT
World Monitor✓ ChatGPT
Svelte MCP✓ ChatGPT

Works with Claude Code · about 5 min

You need a Cycloid MCP key (sign up on the maker’s site, may cost money)

Sign up and create a Cycloid MCP key
Open the maker’s site, sign up and create an API key for the next step. It may cost money.
How to get a key is in the maker’s README below
Done
Open Terminal
Mac: press Command+Space and type Terminal · Windows: open PowerShell
Done
3
Paste this command and press Enter
```
claude mcp add --transport http server https://mcp.cycloid.io/mcp --header 'X-CY-API-KEY: your-value' --header 'X-CY-ORG: your-value'
```
Replace “your-value” with your key before pressing Enter
Paste the key only into the app’s field, never into a chat or to anyone
Done
Type /mcp in Claude Code
You should see Cycloid MCP listed as connected
Done
Try it
Use Cycloid MCP and tell me what you can do for me, then show me one thing
✓ If Claude Code says it is using Cycloid MCP or shows a Cycloid MCP tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor · about 5 min

You need a Cycloid MCP key (sign up on the maker’s site, may cost money)

Sign up and create a Cycloid MCP key
Open the maker’s site, sign up and create an API key for the next step. It may cost money.
How to get a key is in the maker’s README below
Done
Click this button to open Cursor
Open in Cursor
Cursor asks you to confirm; click Install
Done
Fill in your key
In the Cycloid MCP settings, X-CY-API-KEY, X-CY-ORG is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Done
Open the AI chat in Cursor in Agent mode
Done
Try it
Use Cycloid MCP and tell me what you can do for me, then show me one thing
✓ If Cursor says it is using Cycloid MCP or shows a Cycloid MCP tool in the answer, you are connected

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code · about 5 min

You need a Cycloid MCP key (sign up on the maker’s site, may cost money)

Sign up and create a Cycloid MCP key
Open the maker’s site, sign up and create an API key for the next step. It may cost money.
How to get a key is in the maker’s README below
Done
Click this button to open VS Code
Open in VS Code
VS Code asks you to confirm; click Install
Done
Fill in your key
In the Cycloid MCP settings, X-CY-API-KEY, X-CY-ORG is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Done
Open the AI chat in VS Code in Agent mode
Done
Try it
Use Cycloid MCP and tell me what you can do for me, then show me one thing
✓ If VS Code says it is using Cycloid MCP or shows a Cycloid MCP tool in the answer, you are connected

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

Address for apps that connect over the web

Addresshttps://mcp.cycloid.io/mcp

JSON settings are under “For developers” below

Stuck? Ask people who use Cycloid MCP💬 Discussion →

For developers: Terminal commands and JSON settings

Over the web

Claude Code

claude mcp add --transport http server https://mcp.cycloid.io/mcp --header 'X-CY-API-KEY: your-value' --header 'X-CY-ORG: your-value'

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "server": {
      "url": "https://mcp.cycloid.io/mcp",
      "headers": {
        "X-CY-API-KEY": "your-value",
        "X-CY-ORG": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "server": {
      "type": "http",
      "url": "https://mcp.cycloid.io/mcp",
      "headers": {
        "X-CY-API-KEY": "your-value",
        "X-CY-ORG": "your-value"
      }
    }
  }
}

Values you fill in

X-CY-API-KEY secret required HTTP header
API key for authentication
X-CY-ORG required HTTP header
The organization canonical name (tenant) you want to interact with

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

GitHub stars i: 0
Downloads per weeki: Not on npm/PyPI
Verified domain: ✓ mcp.cycloid.io
Licence i: MIT
Connection: Runs in the cloud
Transport: streamable-http
Latest versioni: 1.0.1
Categoryi: Other
Published to registryi: Oct 8, 2025
Code last changedi: Jun 9, 2026
Maker: cycloidio
Repo: cycloidio/cycloid-mcp-server
Registry status: Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Connect over the internet in

Claude Goose LM Studio Msty Studio Cherry Studio Cursor VS Code + GitHub Copilot Visual Studio Windsurf (Devin Desktop)Zed Kiro Cline Continue JetBrains AI Assistant Claude Code Codex CLI Gemini CLI OpenCode nodecode Warp LibreChat Open WebUI Raycast

All apps, with pros and cons →

What it can do

Tool names and descriptions exactly as the server reported them on Nov 10, 2026. The maker wrote them, not us; we show them as plain text.

CYCLOID_CATALOG_REPO_LIST
List all available service catalog repositories with their details. The LLM can filter the results based on user requirements.
CYCLOID_COMPONENT_GET
Get the state of one or more components in a project environment.
CYCLOID_COMPONENT_LIST
List components in a project environment.
CYCLOID_EVENT_LIST
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's a
CYCLOID_PROJECT_EVENTS
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_MEMBER_
CYCLOID_MEMBER_LIST
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/ /members/ .
CYCLOID_PIPELINE_LIST
List all pipelines from Cycloid.
CYCLOID_PROJECT_GET
Get one or more projects by canonical.
CYCLOID_PROJECT_LIST_ENV
List environments in a project.
CYCLOID_PROJECT_LIST
List all projects in the organization.
CYCLOID_STACKFORMS_VALIDATE
Validate a StackForms (.forms.yml) file using the Cycloid CLI. This tool can validate StackForms configuration and provide detailed feedback for fixing issues.
CYCLOID_BLUEPRINT_STACK_CREATE
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 eli
CYCLOID_BLUEPRINT_LIST
List all available blueprints with their details. The LLM can filter the results based on user requirements.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 12, 2026

✓ Pass
Maker matches the repo
The registry name was verified against the domain mcp.cycloid.io (the registry checks domain ownership)
✓ Pass
Still maintained
Code last changed 5 months ago
✓ Pass
Has a licence
Uses MIT
✓ Pass
Endpoint responds
Responded in 1174 ms (HTTP 200)
– Not applicable
Sign-in with OAuth
No sign-in needed
✓ Pass
No hidden instructions in tool descriptions
Read 13 tool descriptions and found no hidden instructions to the AI

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

User reviews

No reviews yet

Compared with others in Otheri

More stars than 0% of the other 19286 servers in this category
Published to the registry more recently than 0% of the other 19286 servers in this category
Basic checks equal to or better than 100% of the other 19286 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Cycloid MCP safe?

It passed 5 of 5 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: X-CY-API-KEY, X-CY-ORG

Does it run on my computer or in the cloud?

It runs in the maker’s cloud. Connect over the internet with nothing to install, but what you send passes through the maker’s servers.

Is it still maintained?

The GitHub repo last changed 5 months ago, and the latest version (1.0.1) reached the registry 13 months ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT Business and above.

What can I use instead?

In the same category: World Monitor, Claude Flow, Tldraw

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

World Monitor

Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 102 tools.

by koala73Widely used★ 90.5KUpdated today

Runs in the cloud✓ worldmonitor.app

Install

Claude Flow

AI orchestration with hive-mind swarms, neural networks, and 87 MCP tools for enterprise dev.

by ruvnetWidely used↓ 13.5K/wk★ 81.5KUpdated 14 months ago

Runs on your computer

Install

Tldraw

Draw and visually collaborate with your agents on tldraw's canvas.

by tldrawWidely used★ 51.4KUpdated 8 months ago

Runs in the cloud

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

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 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.

Cycloid MCP

Overview

What you can do with it

Install

Sign up and create a Cycloid MCP key

Open Claude’s Connectors page

Click “+ Add” → “Add custom connector” and fill in these 2 fields

Turn it on in a chat

Try it

What you can do instead

Sign up and create a Cycloid MCP key

Open Terminal

Paste this command and press Enter

Type /mcp in Claude Code

Try it

Sign up and create a Cycloid MCP key

Click this button to open Cursor

Fill in your key

Open the AI chat in Cursor in Agent mode

Try it

Sign up and create a Cycloid MCP key

Click this button to open VS Code

Fill in your key

Open the AI chat in VS Code in Agent mode

Try it

Over the web

Values you fill in

At a glance

Which apps can use it

Related guides

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Discussion

User reviews

Compared with others in Otheri

Common questions

Alternatives

World Monitor

Claude Flow

Tldraw

README from the maker

Cycloid MCP Server

Overview

Available Tools

Available Resources

Event Filters

Architecture

HTTP Transport

Quick Start

Prerequisites

Development Setup

Run development server

Production Setup

Using Pre-built Docker Images

Run the server

Building Locally

Run production server

MCP Configuration

Available Commands

Development Server

HTTP Server

Production

Testing and Quality

Cleanup

Contributing

License