# KSail

> KSail is a free MCP server for cloud and infrastructure. Create Kubernetes clusters and deliver workloads with GitOps from one CLI and MCP server. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, Linux, macOS, Windows, vscode, self-hosted
- **Website:** https://ksail.devantler.tech
- **Repository:** https://github.com/devantler-tech/ksail
- **MCP Registry name:** io.github.devantler-tech/ksail
- **Categories:** cloud and infrastructure, developer tools
- **Listing updated:** 2026-11-14

## About

Running Kubernetes usually means stitching together kind or k3d, kubectl, Helm, a GitOps engine and SOPS. KSail embeds those tools in one binary driven by a single ksail.yaml, and writes native configs such as kind.yaml and Talos patches so you can keep using the underlying tools.

Clusters can be Vanilla, K3s, Talos, VCluster or KWOK in Docker or on cloud servers, or managed EKS, GKE and AKS. Flux or ArgoCD is built in, and workload push packages manifests as an OCI artifact. Manifests can be schema-checked and security-scanned offline, and secrets are handled with SOPS and Age.

The registry entry ships it as an OCI image over stdio. The README says KWOK only simulates clusters and does not run applications, and cloud providers need their own setup and cost money. The source is available under PolyForm Shield 1.0.0, which has noncompetition terms.

## Features

- **Cluster creation:** Create local or cloud clusters from one ksail.yaml across several distributions.
- **Built-in GitOps:** Flux or ArgoCD, with workload push and reconcile commands.
- **Offline validation:** Schema-check and security-scan manifests without a cluster.
- **Secrets in Git:** Encrypt, decrypt and edit secrets with SOPS and Age.
- **Day-2 operations:** Health diagnosis, backup and restore, registry mirroring and tenant onboarding.
- **Several front ends:** Terminal, web UI, desktop app, VS Code extension, chat assistant or MCP.

## Good for

- Spin up a throwaway local cluster to test a Helm chart
- Use the validation commands as a CI gate for manifests
- Let an assistant create and inspect clusters over MCP
- Move the same project from laptop Docker to a cloud cluster

## Install

### Claude Code (Terminal)

```sh
claude mcp add ksail -- docker run -i --rm ghcr.io/devantler-tech/ksail:v7.215.9
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "ksail": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/devantler-tech/ksail:v7.215.9"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "ksail": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/devantler-tech/ksail:v7.215.9"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "ksail": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/devantler-tech/ksail:v7.215.9"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "ksail": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/devantler-tech/ksail:v7.215.9"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "ksail": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/devantler-tech/ksail:v7.215.9"
      ]
    }
  }
}
```

## FAQ

### Which cluster types does it support?

Vanilla, K3s, Talos, VCluster and KWOK in Docker or on cloud servers, plus managed EKS, GKE and AKS.

### Does KWOK run my applications?

No. The README says KWOK simulates clusters and does not run applications.

### What licence is it under?

PolyForm Shield 1.0.0, a source-available licence with use, redistribution and noncompetition terms. Read it before reusing the code.

### Do I need Docker?

Project files can be created without Docker or a cloud account, but creating a local cluster needs Docker Engine or Docker Desktop.

### Is KSail free?

Yes. KSail is free to use.

### How do I add KSail to Claude Code?

Run this command in your terminal: claude mcp add ksail -- docker run -i --rm ghcr.io/devantler-tech/ksail:v7.215.9

### What are the best alternatives to KSail?

The closest alternatives to KSail are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/ksail
