KSail: Kubernetes clusters and an MCP server in one CLI
KSail
A CLI for local and cloud Kubernetes clusters with GitOps and secrets; ships an MCP server and a plugin for Claude Code
- 164 ★ on the repository
- Last commit
Broad access
Why this level
- The agent creates and deletes clusters, deploys applications and handles secrets, and cloud clusters cost money
- The install script runs through curl and sh, so read it before running
Install
- Works in
Manual install
curl -fsSL https://github.com/devantler-tech/ksail/releases/latest/download/install.sh | shThe script from the README verifies the download and targets Linux and Apple Silicon.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- The agent creates and deletes clusters, deploys applications and handles secrets, and cloud clusters cost money
- The install script runs through curl and sh, so read it before running
This is third-party code. Review the repository files before installing.
What it does
KSail gathers into one command what is usually spread across a dozen utilities: creating a cluster, deploying applications and day-to-day operations. Locally, a cluster starts in Docker on Kind, K3d, Talos, vCluster or KWOK (which only simulates a cluster and runs no applications). EKS, GKE and AKS and existing clusters are supported too, though provider setup and billing stay with you. For deployment it bundles kubectl, Helm, Kustomize, Flux and ArgoCD. Secrets are encrypted with SOPS and Age, and Kubeconform validates manifests. K9s connects for cluster work, and there are backup, restore and multi-tenancy features. KSail reaches AI three ways: a built-in chat assistant, a VS Code extension and an MCP server. In the MCP registry the server is published as the image ghcr.io/devantler-tech/ksail over stdio. The plugin from the devantler-tech marketplace registers that server and a KSail skill in Claude Code and GitHub Copilot CLI.
Who it is for. Kubernetes teams who want to spin up a test cluster with one command and let an agent manage it over MCP.
Good fit when
- You need a local Kind or K3d cluster with GitOps through Flux or ArgoCD ready to go
- Manifests with secrets must live in the repository encrypted with SOPS and Age
- You ask an agent to create a cluster, deploy a chart and check its state without assembling commands by hand
- You want to validate manifests quickly before a commit
Not a fit when
- You need an OSI-approved license: the code is source-available under PolyForm Shield 1.0.0 with noncompete terms
- There is no Docker on the machine and you only need a remote cluster: kubectl with a Kubernetes MCP server is simpler
- You need a packaged Windows install: the quick path in the README targets Linux and Apple Silicon
Example request
Create a local Kind cluster with Flux, deploy my chart from the k8s folder and show which pods came up.Limitations
The PolyForm Shield 1.0.0 license allows use and redistribution but forbids competing, so read the terms before using it in a product. The quick install script targets Linux and Apple Silicon Macs, and the other options (Homebrew, a Windows download) are described in the reference. Local clusters need Docker running.
Cloud clusters need your provider setup and cost money. The README gives no exact command for launching the MCP server from the binary: it is easier to install the plugin from the devantler-tech marketplace, which registers the server itself. It needs ksail on the PATH.
How to disable. Remove the plugin through /plugin in Claude Code or the server entry from the client config. A trial cluster is removed with `ksail cluster delete`, and the project files stay.
FAQ
How do I connect KSail to Claude Code?
Through the plugin from the devantler-tech marketplace: `/plugin marketplace add devantler-tech/agent-plugins`, then `/plugin install ksail@devantler-plugins`. The plugin registers the MCP server and a skill itself. It needs ksail on the PATH and a subscription for the chosen client.
Which clusters can KSail create?
Kind, K3d, Talos, vCluster and KWOK locally, plus EKS, GKE and AKS at cloud providers. KWOK only simulates a cluster and runs no applications. The compatibility map is in the support matrix on the project site.
What happens when I delete the trial cluster?
The command `ksail cluster delete --name my-app --provider Docker` asks for confirmation and removes the cluster with its applications. Project files (ksail.yaml, kind.yaml, k8s/kustomization.yaml) remain for reuse.
Does KSail need Docker?
For local clusters yes, Docker Engine or Docker Desktop must be running. The `ksail project init` command creates project files with no Docker and no cloud account.
What license is KSail under?
The code is published under PolyForm Shield 1.0.0: use and redistribution are allowed, competing with the project is not. It is not on the OSI-approved list, so read the terms before using it in a commercial product.
Discussion
No questions or reviews yet.
Related
CLI toolsA CLI and Kubernetes operator that runs Claude Code, Codex, Gemini, OpenCode and Cursor as tasks and sessions inside a cluster
MCP server for Kubernetes: the agent reads cluster state, diagnoses pod failures and runs operations through kubectl
An AI assistant for Kubernetes that turns plain-language requests into kubectl operations and doubles as an MCP server
A CLI and Kubernetes controller for developing, building and deploying MCP servers. For platform teams, written in Go
A Kubernetes panel with an MCP server: Claude Code reads pod logs, edits resources and rolls back releases in connected clusters.
Kubernetes MCP
MCP Server Kubernetes
MCP server for managing a Kubernetes cluster through kubectl and Helm, with a non-destructive mode
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| KSail: Kubernetes clusters and an MCP server in one CLI (this card) | yes | not required | 164 | |
| Kubernetes MCP Server | no | not required | 2,244 | an MCP server for an existing cluster, with no creation or GitOps |
| K9s | no | 34,993 | a terminal UI for clusters that KSail bundles as one part |
README in short
The README describes KSail through a table of tasks: creating clusters, deploying, protecting configuration, operating and working with AI. A five-command quickstart follows, with links to the docs, the support matrix and a reference for assistant plugins.