KSail MCP Server
io.github.devantler-tech/ksail
Kubernetes cluster creation, management, and workload deployment through CLI, VS Code, AI chat, or MCP server.
What is the KSail MCP server?
The KSail MCP server is an MCP interface to KSail, an SDK that bundles Kubernetes tooling (Kind, K3d, Talos, kubectl, Helm, Flux, ArgoCD, and more) into a single binary. It enables AI agents to create local or cloud clusters, deploy workloads, and operate cloud-native stacks across distributions and providers with only Docker or cloud provider access required.
KSail simplifies Kubernetes cluster provisioning and management by bundling common tools (cluster creation, container orchestration, GitOps, secrets management, and operations) into one interface. The MCP server exposes these capabilities to AI assistants, letting you scaffold projects, spin up clusters, deploy workloads, and manage multi-tenant environments through natural language or programmatic requests.
How to install KSail
Copy-paste configuration for popular MCP clients.
Use cases
- Scaffold and initialize a Kubernetes project with native configurations
- Create and manage local Kubernetes clusters using Kind, K3d, or other distributions
- Deploy and manage workloads using kubectl, Helm, and Kustomize
- Set up GitOps pipelines with Flux or ArgoCD
- Manage secrets with SOPS and Age encryption
KSail MCP server FAQ
KSail is an MCP server that exposes Kubernetes cluster and workload management capabilities. It bundles tools like Kind, K3d, Talos, kubectl, Helm, Flux, and ArgoCD, allowing AI agents to create clusters, deploy applications, and operate cloud-native infrastructure.
KSail is licensed under the PolyForm Shield License 1.0.0. You can use, modify, and distribute it freely for any purpose except building a competing product. No commercial license is required for standard use.
Install the ksail plugin for Claude Code with `/plugin marketplace add devantler-tech/ksail` followed by `/plugin install ksail@ksail`, or for Copilot CLI with `copilot plugin marketplace add devantler-tech/ksail` and `copilot plugin install ksail`. Requires `ksail` on your PATH.
KSail supports Docker (local clusters), Kubernetes (nested), Hetzner Cloud, Sidero Omni, and AWS (in progress). For local development, only Docker is required.
KSail runs on Linux (amd64, arm64), macOS (arm64), and Windows via WSL2 (amd64, arm64). You need Docker or access to a cloud provider to create clusters.
KSail requires Docker for local cluster creation or credentials for cloud providers (Hetzner, AWS, etc.). The MCP server itself does not require separate authentication beyond your existing Kubernetes and cloud provider setup.
README (reference)
Source of truth, from the repository.
🛥️🐳 KSail
KSail bundles common Kubernetes tooling into a single binary. Spin up local clusters, deploy workloads, and operate cloud-native stacks across distributions and providers through a CLI, VS Code extension, AI chat TUI, or MCP server — with only Docker or access to a Cloud Provider required.
📖 Full documentation: https://ksail.devantler.tech
Quick Install
# macOS / Linux (Homebrew)
brew install --cask devantler-tech/tap/ksail
# Go (1.26.1+)
go install github.com/devantler-tech/ksail/v7@latest
See the Installation Guide for binary downloads and more options.
AI Assistant Plugins
Install the ksail plugin for GitHub Copilot CLI or Claude Code to auto-register ksail's MCP server and a ksail expertise skill.
Copilot CLI:
copilot plugin marketplace add devantler-tech/ksail
copilot plugin install ksail
Claude Code:
/plugin marketplace add devantler-tech/ksail
/plugin install ksail@ksail
Requires ksail on PATH.
Quick Start
ksail cluster init --name my-app # scaffold project + native configs
ksail cluster create # spin up the cluster (Docker only)
ksail cluster connect # open K9s
Continue with the Getting Started guide for GitOps, workloads, and multi-tenancy.
What KSail Bundles
| Category | Built-in Capabilities |
|---|---|
| Cluster Provisioning | Kind, K3d, Talos, VCluster (Vind), KWOK (kwokctl), EKS |
| Container Orchestration | kubectl, Helm, Kustomize |
| GitOps Engines | Flux, ArgoCD |
| Secrets Management | SOPS with Age encryption |
| Manifest Validation | Kubeconform |
| Cluster Operations | K9s, backup & restore, multi-tenancy (ksail tenant) |
| AI Integration | Chat assistant (Copilot SDK), MCP server, VS Code extension |
| Infrastructure Providers | Docker (local), Kubernetes (nested), Hetzner Cloud, Sidero Omni, AWS |
See the feature overview and architecture guide for details.
Supported Platforms
| OS | Architecture |
|---|---|
| 🐧 Linux | amd64, arm64 |
| 🍎 macOS | arm64 |
| ⊞ Windows (native untested; WSL2 recommended) | amd64, arm64 |
| Provider | Vanilla | K3s | Talos | VCluster | KWOK | EKS |
|---|---|---|---|---|---|---|
| Docker | ✅ (Kind) | ✅ (K3d) | ✅ | ✅ (Vind) | ✅ (kwokctl) | — |
| Kubernetes | ✅ | ✅ | ✅ | ✅ | ✅ | — |
| Hetzner | — | — | ✅ | — | — | — |
| Omni | — | — | ✅ | — | — | — |
| AWS | — | — | — | — | — | 🚧 |
Community & Support
- 💬 GitHub Discussions — questions, ideas, and community
- 🐛 Issue Tracker — bugs and feature requests
- 📖 Documentation — guides, CLI reference, architecture
- 🎓 Resources — presentations, blog posts, tutorials
- ⭐ Star the repo — help others discover KSail
Contributing
Contributions are welcome! See CONTRIBUTING.md for the development process, coding standards, and PR guidelines. Start with issues labeled good first issue.
Related Projects
| Project | Description | Type |
|---|---|---|
| devantler-tech/platform | The maintainer's personal kubernetes platform | Platform |
Using KSail in your project? Open a PR to add it here.
License
KSail is licensed under the PolyForm Shield License 1.0.0. You may use, modify, and distribute KSail for any purpose — except providing a product that competes with KSail. When redistributing, you must include the license terms and the required copyright notice.
What this means in practice:
- ✅ Use KSail as a CLI tool in any project (open-source or proprietary)
- ✅ Embed or link KSail as a library in your own software
- ✅ Fork and modify KSail for internal or non-competing use
- ✅ Use any license for your own project — no copyleft requirement
- ❌ Build and distribute a product that competes with KSail
For the full license text including notice and non-compete details, see LICENSE. For common questions, see the Licensing FAQ.
Star History
<a href="https://www.star-history.com/#devantler-tech/ksail&type=timeline&legend=top-left"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=devantler-tech/ksail&type=timeline&theme=dark&legend=top-left" /> <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=devantler-tech/ksail&type=timeline&legend=top-left" /> <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=devantler-tech/ksail&type=timeline&legend=top-left" /> </picture> </a>Related MCP servers
SkillDB
A registry of 5,900+ peer-authored skills any MCP agent can search and load on demand.
io.github.developer-ishan/pexels
MCP server for searching Pexels stock photos, videos, and curated collections.
An MCP server that provides AI travel recommendations from Asian expats.
Autonomous UI debugging MCP server: an agent drives the browser/desktop, reports bugs + UX issues.
FocusRelay
Connect AI tools to OmniFocus on macOS to find, review, and safely update tasks and projects.