Cycloid MCP Server

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

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 elicitation handle the rest. DO NOT provide name, use_case, or service_catalog_source_canonical when elicitation is available.

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

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

List components in a project environment.

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 actual `action`/`entity` tag VALUE (note: the entity is `ci_build`, not `build`). If a filter matches nothing while events exist, the response lists the available_actions/available_entities to retry with. `type` is ONLY the high-level category: Cycloid, AWS, Monitoring, Custom (do NOT pass an action/entity name as `type`). `severity` is one of: info, warn, err, crit. `begin`/`end` are Unix timestamps in SECONDS (strings); omit any filter to include all of its values. Returns full event payload including tags. Actor identity is in tags as {key: 'user', value: '<username>'}.

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

List all pipelines from Cycloid.

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_LIST to get numeric ids for building member URLs. Hard cap: aborts with a structured error if total components exceed the configured maximum (default 50). Use begin/end/severity/type/action/entity to narrow results. Filter by WHAT HAPPENED with `action` (e.g. create, update, delete, configure, pause, unpause) and/or `entity` (e.g. component, ci_build, ci_job, pipeline) — matched case-insensitively against each event's actual tag VALUE (the entity is `ci_build`, not `build`). If a filter matches nothing while events exist, the response lists available_actions/available_entities to retry with. `type` is ONLY the high-level category: Cycloid, AWS, Monitoring, Custom (do NOT pass an action/entity name as `type`). `severity` is one of: info, warn, err, crit.

Get one or more projects by canonical.

List all projects in the organization.

List environments in a project.

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