KSail MCP Server
io.github.devantler-tech/ksail
Kubernetes cluster and workload management bundled into a single binary with CLI, VS Code, and MCP server.
What this kind of tool is for
- Automate a build, test, or deployment step you repeat by hand.
- Review or refactor code in an existing repository without leaving your agent.
- Bridge an internal service or CLI into the agent toolset.
How to compare servers like this
- Scope of control:
- Repos and CI are hard to undo; prefer tools that ask before anything irreversible.
- Environment fit:
- Match the runtime it expects (Node, Python, a container) to what you actually run.
- Maintenance signal:
- Check the last-commit date — dev tooling that lags upstream breaks first.
- Config surface:
- Prefer tools whose environment-variable or config keys are documented plainly.
This page carries your copy-paste config: pick your MCP client in the install section on this page and use the copy button.
What is the KSail MCP server?
KSail is an SDK and CLI tool that bundles common Kubernetes tooling into a single binary for creating, managing, and operating Kubernetes clusters and workloads. It supports multiple cluster provisioners (Kind, K3d, Talos, VCluster, KWOK, EKS), container orchestration tools (kubectl, Helm, Kustomize), GitOps engines (Flux, ArgoCD), and infrastructure providers (Docker, Kubernetes, Hetzner Cloud, AWS). Available as a CLI, VS Code extension, AI chat TUI, and MCP server.
KSail simplifies Kubernetes cluster provisioning and workload management by bundling essential tools—cluster provisioners, container orchestration, GitOps engines, secrets management, and more—into a single binary. Use it to spin up local clusters with Docker, deploy and manage workloads across distributions and cloud providers, and integrate with AI assistants like GitHub Copilot and Claude.
How to install KSail
Copy-paste configuration for popular MCP clients.
{
"mcpServers": {
"ksail": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/devantler-tech/ksail:v7.197.3"
]
}
}
}Tools & capabilities
Tools this server exposes to the agent.
Cluster Provisioning— Support for Kind, K3d, Talos, VCluster (Vind), KWOK (kwokctl), and EKSContainer Orchestration— kubectl, Helm, and Kustomize integrationGitOps Engines— Flux and ArgoCD supportSecrets Management— SOPS with Age encryptionManifest Validation— Kubeconform for validating Kubernetes manifestsCluster Operations— K9s integration, backup & restore, and multi-tenancy managementAI Integration— Chat assistant, MCP server, and VS Code extension
Use cases
- Scaffold and spin up local Kubernetes clusters with only Docker installed
- Deploy and manage workloads across multiple Kubernetes distributions and cloud providers
- Implement GitOps workflows with Flux or ArgoCD for declarative infrastructure
- Manage secrets securely using SOPS with Age encryption
- Operate multi-tenant Kubernetes clusters with built-in tenant management
KSail MCP server FAQ
KSail is a unified SDK and CLI tool that bundles Kubernetes provisioning, orchestration, GitOps, and operations tooling into a single binary. It supports multiple cluster types (Kind, K3d, Talos, VCluster, KWOK, EKS) and infrastructure providers (Docker, Kubernetes, Hetzner, AWS).
KSail is licensed under the PolyForm Shield License 1.0.0, which permits free use, modification, and distribution for any purpose except building competing products.
Install the ksail plugin for Claude Code with `/plugin marketplace add devantler-tech/ksail` followed by `/plugin install ksail@ksail`, or for GitHub Copilot CLI with `copilot plugin marketplace add devantler-tech/ksail` and `copilot plugin install ksail`. Requires ksail on PATH.
KSail runs on Linux (amd64, arm64), macOS (arm64), and Windows via WSL2 (amd64, arm64). It can provision clusters on Docker, Kubernetes, Hetzner Cloud, Sidero Omni, and AWS.
No. KSail can provision local clusters using only Docker. Cloud provider credentials are only needed if you want to provision clusters on Hetzner Cloud, Omni, or AWS.
KSail includes kubectl, Helm, Kustomize, Flux, ArgoCD, K9s, SOPS, Kubeconform, and provisioners like Kind, K3d, Talos, VCluster, and KWOK.
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
Autonomous UI debugging MCP server: an agent drives the browser/desktop, reports bugs + UX issues.

DevHelm MCP Server
Monitor uptime, manage incidents, configure alerting, and query dependency status via DevHelm

Swell MCP
Model Context Protocol server for Swell e-commerce platform integration with AI assistants

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.

