Skip to content
MCP server

KSail

Create Kubernetes clusters and deliver workloads with GitOps from one CLI and MCP server

Runs locallyStatus and history
Pricing
Free
Platforms
CLI, Linux, macOS
Runs
Locally
Version
7.215.9
Listing updated
3 days ago

About KSail

KSail is a free MCP server for cloud and infrastructure. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "ksail": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/devantler-tech/ksail:v7.215.9"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "ksail": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/devantler-tech/ksail:v7.215.9"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

What it does

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

Pricing

Free

Source-available under PolyForm Shield 1.0.0; cloud providers bill separately

Prices change. Check ksail.devantler.tech before you buy.

KSail 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 to KSail

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools