What Kubernetes resources must be installed before using Cyclops MCP?

Cyclops and its Custom Resource Definitions (CRDs) must be installed and running in the cluster.

How can I expose the Cyclops MCP server locally?

You can port-forward the service with kubectl, e.g., 'kubectl port-forward -n cyclops svc/cyclops-mcp 8000:8000'.

What environment variables can configure the Cyclops MCP server?

KUBECONFIG, CYCLOPS_KUBE_CONTEXT, CYCLOPS_MODULE_NAMESPACE, CYCLOPS_HELM_RELEASE_NAMESPACE, and CYCLOPS_MODULE_TARGET_NAMESPACE.

Can multiple developers connect to the same Cyclops MCP server?

Yes, you can deploy the MCP server in-cluster and expose it for shared access.

MCP Cyclops

kubernetescloudmcpcyclopsinfrastructure

MCP server enabling AI agents to manage Kubernetes applications via Cyclops Modules and templates.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

One-click editor setup isn’t available for this listing yet — we don’t have a confirmed install command, and we’d rather show nothing than point your editor at the wrong package or host. Follow the project’s own setup instructions, linked above.

Manual Client & Custom JSON ConfigExpand JSON ▾

No confirmed setup config for this listing yet. We only publish a config block when the install details come from the project itself — its README, its docs, or a verified owner. We haven’t found those for cyclops-ui/mcp-cyclops, and we’d rather show nothing than a guess you’d paste into your client. Follow the project’s own setup instructions for the current steps.

Overview

This MCP server allows AI agents to create, update, and manage Kubernetes applications using Cyclops abstractions. It exposes tools to handle Cyclops Modules and Template Stores, validating configurations against JSON schemas to reduce misconfigurations. Use it when you want AI-driven Kubernetes management at a higher abstraction level, avoiding direct manipulation of low-level resources like Deployments and Services.

Use cases

Create new Kubernetes applications using validated Cyclops templates

Update existing Cyclops Modules safely via AI agents

List and fetch Cyclops Modules and Template Stores in the cluster

Validate template configurations against JSON schemas before deployment

Expose a shared MCP server for team-wide AI-driven Kubernetes management

Key features

Create, update, and fetch Cyclops Modules

List Cyclops Modules and Template Stores

Retrieve JSON schema for templates to validate configurations

Operate via Kubernetes cluster context and kubeconfig

Supports SSE transport for AI agent connections

Capabilities & Tool Schemas (7)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by MCP Cyclops.

create_module

Create new Module. Before calling this tool, make sure to call `get_template_schema` to validate values for the given template

get_module

Fetch Module by name

list_modules

List all Cyclops Modules

update_module

Update Module by Name. Before calling this tool, make sure to call `get_template_schema` to validate values for the given template

get_template_schema

Returns JSON schema for the given template. Needs to be checked before calling `create_module` tool

get_template_store

Fetch Template Store by Name

Documentation Overview

Cyclops MCP (Model Context Protocol)

Cyclops MCP allows your favorite AI agent to manage your Kubernetes applications. Cyclops MCP servers provide tools for agents to create and update existing applications safely.

https://github.com/user-attachments/assets/0c675c33-1e36-4fdb-bf8c-2fd7fb491e6b

This means it can check all of your existing templates and the schema of those templates to create accurate and production-ready applications. Your agent now has much less room to make a misconfiguration since it creates high-level resources (Cyclops Modules) instead of touching every line of your Kubernetes resources (Deployments, Services, and Ingresses).

It allows you to move fast and ensure no uncaught misconfigurations are hitting your production.

With Cyclops and our MCP, you can now abstract Kubernetes complexity from your developers AND your AI agents

Install via UI

The easiest way to install the Cyclops MCP server is through the Cyclops UI. Below are instructions on how to install it via binary and kubectl, but the recommended way of installing it is via the UI.

⚠️ To install Cyclops MCP through the UI, you should run Cyclops on a version v0.20.1 or greater

Install the Cyclops MCP by going to sidebar “Addon” > "MCP server". You can now click "Install Cyclops MCP server" and your Cyclops MCP server will be up and running in a few seconds.

Now that your MCP server is up running, all thats left is exposing it outside of your cluster and connecting your AI agent to it.

To expose the MCP server on localhost you can simply port-forward it with the following command:
bash
```
kubectl port-forward -n cyclops svc/cyclops-mcp 8000:8000
```
Your server is now available on localhost:8000.
To connect it to an AI agent you will just have to provide the Cyclops MCP server in its configuration. For example, to add it to Cursor, you can simply add it with the following JSON:
JSON Config
```
{
  "mcpServers": {
    "cyclops-kubernetes": {
      "url": "http://localhost:8000/sse"
    }
  }
}
```

You can now start a fresh conversation with your AI companion. Above is an example of how we used it with Cursor.

Install stdin binary

1. Make sure Cyclops is installed in your Kubernetes cluster

Check our docs on how it install it with a single command - https://cyclops-ui.com/docs/installation/install/manifest

2. Download MCP server

You can download the Cyclops MCP server binary with the following command:

yaml

GOBIN="$HOME/go/bin" go install github.com/cyclops-ui/mcp-cyclops/cmd/mcp-cyclops@latest

3. Add server configuration

⚠️ By default, Cyclops MCP will use the .kube/config file to connect to your cluster

Configure your MCP Cyclops server:

config.json

{
  "mcpServers": {
    "mcp-cyclops": {
      "command": "mcp-cyclops"
    }
  }
}

Configuration

You can configure Cyclops MCP server via env variables. Below is an example of adding the configuration for specifying the kubeconfig file the Cyclops MCP server should use when managing your Cyclops applications.

config.json

{
  "mcpServers": {
    "mcp-cyclops": {
      "command": "mcp-cyclops",
      "env": {
        "KUBECONFIG": "/path/to/your/kubeconfig"
      }
    }
  }
}

Environment variables

Below is the list of environment variables used for configuring your Cyclops MCP server:

Env var	Description
`KUBECONFIG`	Path to kubeconfig file (optional, defaults to in-cluster config or $HOME/.kube/config)
`CYCLOPS_KUBE_CONTEXT`	Kubernetes context to use (optional)
`CYCLOPS_MODULE_NAMESPACE`	Namespace where modules are stored
`CYCLOPS_HELM_RELEASE_NAMESPACE`	Namespace for Helm releases
`CYCLOPS_MODULE_TARGET_NAMESPACE`	Target namespace for modules

Install to a Kubernetes cluster manually

Instead of having each developer install mcp-cyclops binary, you can install the Cyclops MCP server with SSE as transport type to your Kubernetes cluster and allow all of your developers to connect to the same server.

Before installing, make sure Cyclops and all its CRDs are installed in your cluster:

Check Cyclops pods are running:

shell

kubectl get pods -n cyclops

Should write:

Code

NAME                            READY   STATUS    RESTARTS   AGE
cyclops-ctrl-676b5d9789-ntcls   1/1     Running   0          94s
cyclops-ui-7798655f97-xdg29     1/1     Running   0          94s

Check if CRDs are installed

shell

kubectl get crds | grep cyclops-ui

Should write:

Code

modules.cyclops-ui.com             2025-04-26T15:28:18Z
templateauthrules.cyclops-ui.com   2025-04-26T15:28:18Z
templatestores.cyclops-ui.com      2025-04-26T15:28:18Z

Install Cyclops MCP server with the following command:

shell

kubectl apply -f https://raw.githubusercontent.com/cyclops-ui/mcp-cyclops/refs/heads/main/install/mcp-server.yaml

You can now expose the cyclops-mcp service. To test your MCP server, you can port-forward it:
shell
```
kubectl port-forward svc/cyclops-mcp -n cyclops 8000:8000
```
Add your Cyclops MCP server host, or in case you are testing it, the localhost address where you port-forwarded the MCP service:
config.json
```
{
  "mcpServers": {
    "mcp-cyclops": {
      "url": "http://localhost:8000/sse"
    }
  }
}
```

Tools

Tool	Description
`create_module`	Create new Module. Before calling this tool, make sure to call `get_template_schema` to validate values for the given template
`get_module`	Fetch Module by name
`list_modules`	List all Cyclops Modules
`update_module`	Update Module by Name. Before calling this tool, make sure to call `get_template_schema` to validate values for the given template
`get_template_schema`	Returns JSON schema for the given template. Needs to be checked before calling `create_module` tool
`get_template_store`	Fetch Template Store by Name
`list_template_store`	List Template Stores from cluster

Read the full README →View source on GitHub →

Related MCP Servers

View all in Cloud Platforms View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

Last commit

1y ago

Most recent push to the default branch.

Tools exposed

Callable tools this server registers over MCP.

Directory activity

2 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about MCP Cyclops

It uses high-level Cyclops Modules and validates template inputs against JSON schemas, preventing direct low-level resource edits.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/cyclops-ui-mcp-cyclops?style=directory)](https://allmcps.com/mcp/cyclops-ui-mcp-cyclops)

HTML Embed

<a href="https://allmcps.com/mcp/cyclops-ui-mcp-cyclops"><img src="https://allmcps.com/api/badge/cyclops-ui-mcp-cyclops?style=directory" alt="MCP Cyclops on AllMCPs" /></a>

Technical Specs & Signals

CategoryCloud Platforms

PricingFree

10/10 checks healthy over the last 31d

45Quality signal: Fair · 45/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools22/30

Adoption & activity2/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in ☁️ Cloud Platforms →Best MCP servers for Cloud Platforms →Alternatives to MCP Cyclops →Install in Claude Desktop Install in Cursor Install in VS Code

MCP Cyclops

kubernetescloudmcpcyclopsinfrastructure

MCP server enabling AI agents to manage Kubernetes applications via Cyclops Modules and templates.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Manual Client & Custom JSON ConfigExpand JSON ▾

Overview

Use cases

Create new Kubernetes applications using validated Cyclops templates

Update existing Cyclops Modules safely via AI agents

List and fetch Cyclops Modules and Template Stores in the cluster

Validate template configurations against JSON schemas before deployment

Expose a shared MCP server for team-wide AI-driven Kubernetes management

Key features

Create, update, and fetch Cyclops Modules

List Cyclops Modules and Template Stores

Retrieve JSON schema for templates to validate configurations

Operate via Kubernetes cluster context and kubeconfig

Supports SSE transport for AI agent connections

Capabilities & Tool Schemas (7)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by MCP Cyclops.

create_module

Create new Module. Before calling this tool, make sure to call `get_template_schema` to validate values for the given template

get_module

Fetch Module by name

list_modules

List all Cyclops Modules

update_module

Update Module by Name. Before calling this tool, make sure to call `get_template_schema` to validate values for the given template

get_template_schema

Returns JSON schema for the given template. Needs to be checked before calling `create_module` tool

get_template_store

Fetch Template Store by Name

Documentation Overview

Cyclops MCP (Model Context Protocol)

Cyclops MCP allows your favorite AI agent to manage your Kubernetes applications. Cyclops MCP servers provide tools for agents to create and update existing applications safely.

https://github.com/user-attachments/assets/0c675c33-1e36-4fdb-bf8c-2fd7fb491e6b

It allows you to move fast and ensure no uncaught misconfigurations are hitting your production.

With Cyclops and our MCP, you can now abstract Kubernetes complexity from your developers AND your AI agents

Install via UI

⚠️ To install Cyclops MCP through the UI, you should run Cyclops on a version v0.20.1 or greater

Install the Cyclops MCP by going to sidebar “Addon” > "MCP server". You can now click "Install Cyclops MCP server" and your Cyclops MCP server will be up and running in a few seconds.

Now that your MCP server is up running, all thats left is exposing it outside of your cluster and connecting your AI agent to it.

To expose the MCP server on localhost you can simply port-forward it with the following command:
bash
```
kubectl port-forward -n cyclops svc/cyclops-mcp 8000:8000
```
Your server is now available on localhost:8000.
To connect it to an AI agent you will just have to provide the Cyclops MCP server in its configuration. For example, to add it to Cursor, you can simply add it with the following JSON:
JSON Config
```
{
  "mcpServers": {
    "cyclops-kubernetes": {
      "url": "http://localhost:8000/sse"
    }
  }
}
```

You can now start a fresh conversation with your AI companion. Above is an example of how we used it with Cursor.

Install stdin binary

1. Make sure Cyclops is installed in your Kubernetes cluster

Check our docs on how it install it with a single command - https://cyclops-ui.com/docs/installation/install/manifest

2. Download MCP server

You can download the Cyclops MCP server binary with the following command:

yaml

GOBIN="$HOME/go/bin" go install github.com/cyclops-ui/mcp-cyclops/cmd/mcp-cyclops@latest

3. Add server configuration

⚠️ By default, Cyclops MCP will use the .kube/config file to connect to your cluster

Configure your MCP Cyclops server:

config.json

{
  "mcpServers": {
    "mcp-cyclops": {
      "command": "mcp-cyclops"
    }
  }
}

Configuration

config.json

{
  "mcpServers": {
    "mcp-cyclops": {
      "command": "mcp-cyclops",
      "env": {
        "KUBECONFIG": "/path/to/your/kubeconfig"
      }
    }
  }
}

Environment variables

Below is the list of environment variables used for configuring your Cyclops MCP server:

Env var	Description
`KUBECONFIG`	Path to kubeconfig file (optional, defaults to in-cluster config or $HOME/.kube/config)
`CYCLOPS_KUBE_CONTEXT`	Kubernetes context to use (optional)
`CYCLOPS_MODULE_NAMESPACE`	Namespace where modules are stored
`CYCLOPS_HELM_RELEASE_NAMESPACE`	Namespace for Helm releases
`CYCLOPS_MODULE_TARGET_NAMESPACE`	Target namespace for modules

Install to a Kubernetes cluster manually

Before installing, make sure Cyclops and all its CRDs are installed in your cluster:

Check Cyclops pods are running:

shell

kubectl get pods -n cyclops

Should write:

Code

NAME                            READY   STATUS    RESTARTS   AGE
cyclops-ctrl-676b5d9789-ntcls   1/1     Running   0          94s
cyclops-ui-7798655f97-xdg29     1/1     Running   0          94s

Check if CRDs are installed

shell

kubectl get crds | grep cyclops-ui

Should write:

Code

modules.cyclops-ui.com             2025-04-26T15:28:18Z
templateauthrules.cyclops-ui.com   2025-04-26T15:28:18Z
templatestores.cyclops-ui.com      2025-04-26T15:28:18Z

Install Cyclops MCP server with the following command:

shell

kubectl apply -f https://raw.githubusercontent.com/cyclops-ui/mcp-cyclops/refs/heads/main/install/mcp-server.yaml

You can now expose the cyclops-mcp service. To test your MCP server, you can port-forward it:
shell
```
kubectl port-forward svc/cyclops-mcp -n cyclops 8000:8000
```
Add your Cyclops MCP server host, or in case you are testing it, the localhost address where you port-forwarded the MCP service:
config.json
```
{
  "mcpServers": {
    "mcp-cyclops": {
      "url": "http://localhost:8000/sse"
    }
  }
}
```

Tools

Tool	Description
`create_module`	Create new Module. Before calling this tool, make sure to call `get_template_schema` to validate values for the given template
`get_module`	Fetch Module by name
`list_modules`	List all Cyclops Modules
`update_module`	Update Module by Name. Before calling this tool, make sure to call `get_template_schema` to validate values for the given template
`get_template_schema`	Returns JSON schema for the given template. Needs to be checked before calling `create_module` tool
`get_template_store`	Fetch Template Store by Name
`list_template_store`	List Template Stores from cluster

Read the full README →View source on GitHub →

Related MCP Servers

View all in Cloud Platforms View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

Last commit

1y ago

Most recent push to the default branch.

Tools exposed

Callable tools this server registers over MCP.

Directory activity

2 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about MCP Cyclops

It uses high-level Cyclops Modules and validates template inputs against JSON schemas, preventing direct low-level resource edits.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/cyclops-ui-mcp-cyclops?style=directory)](https://allmcps.com/mcp/cyclops-ui-mcp-cyclops)

HTML Embed

<a href="https://allmcps.com/mcp/cyclops-ui-mcp-cyclops"><img src="https://allmcps.com/api/badge/cyclops-ui-mcp-cyclops?style=directory" alt="MCP Cyclops on AllMCPs" /></a>

Technical Specs & Signals

CategoryCloud Platforms

PricingFree

10/10 checks healthy over the last 31d

45Quality signal: Fair · 45/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools22/30

Adoption & activity2/15

Community engagement0/10

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in ☁️ Cloud Platforms →Best MCP servers for Cloud Platforms →Alternatives to MCP Cyclops →Install in Claude Desktop Install in Cursor Install in VS Code