Skip to content
MCP server

Ratatosk MCP

CNCF release notes turned into typed changes, with a local stack version check

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted, API
Runs
Locally
Version
1.0.0
Listing updated
2 days ago

About Ratatosk MCP

Ratatosk MCP is an open-source MCP server for cloud and infrastructure. It runs locally on your machine and is started by your AI client.

Ratatosk reads release notes from CNCF projects and turns each into classified, entity-level changes: security fixes, breaking changes, removals, deprecations and changed defaults. Each change ties to exact identifiers such as a CVE, flag or CRD and carries a verbatim quote from the official release note as evidence. The README says it watches 76 projects, while the website figure is 79.

The headline tool is check_stack. Give it the versions you run, for instance envoy and istio, and it answers from the record with what applies to everyone and what applies only if your configuration matches. Each change has a family (security, breaking, deprecated), a bucket (action, check, plan, other) and an applies_if expression an agent can evaluate against your manifests. Versions are compared locally and only project slugs go to the server.

Use the hosted endpoint at https://ratatosk.io/mcp, limited to 60 calls a minute per caller, or self-host from the OCI image, Helm chart or source for polling and CI. No account or API key is needed.

Install

Run in a terminal

claude mcp add ratatosk-mcp -- docker run -i --rm ghcr.io/basphere/ratatosk-mcp:1.0.0

Add to claude_desktop_config.json

{
  "mcpServers": {
    "ratatosk-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/basphere/ratatosk-mcp:1.0.0"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "ratatosk-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/basphere/ratatosk-mcp:1.0.0"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "ratatosk-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/basphere/ratatosk-mcp:1.0.0"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "ratatosk-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/basphere/ratatosk-mcp:1.0.0"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "ratatosk-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/basphere/ratatosk-mcp:1.0.0"
      ]
    }
  }
}

Tools this server provides (1)

Taken from the project documentation; the running server may differ.

check_stack
Compares the versions you run against recorded changes locally.

What it does

Typed release changes
Classifies security, breaking and deprecated changes.
Verbatim evidence
Quotes the official release note for each change.
Stack check
Compares your versions locally against recorded changes.
Evaluable conditions
applies_if is a boolean expression, not prose.
Hosted or self-hosted
Use the hosted URL or run the container yourself.
Alert view
The website highlights projects that need action.

Good for

  • Check what to do before upgrading Istio or Envoy
  • Surface CVEs fixed after your running version
  • Feed release intelligence to a CI or in-cluster agent
  • Plan for announced deprecations

Pricing

Open source

Free hosted endpoint with a rate limit; self-hosting available

Prices change. Check ratatosk.io before you buy.

Ratatosk MCP FAQ

Do I need an account?

No account or API key is needed.

What is the hosted rate limit?

60 tool calls a minute per caller; self-host for polling or CI.

What data leaves my machine?

Versions are compared locally and only project slugs are sent.

How do I self-host?

Run ghcr.io/basphere/ratatosk-mcp with Docker, the Helm chart or a source build.

Is Ratatosk MCP free?

Yes. Ratatosk MCP is open source, so you can use and self-host it for free.

How do I add Ratatosk MCP to Claude Code?

Run this command in your terminal: claude mcp add ratatosk-mcp -- docker run -i --rm ghcr.io/basphere/ratatosk-mcp:1.0.0

What are the best alternatives to Ratatosk MCP?

The closest alternatives to Ratatosk MCP are REA, Agent Roast, Midplane, Leash and Tinplate Edge AI Safety, Security & EU Compliance.

Alternatives to Ratatosk MCP

  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. Agent Roast

    MCP server

    Offline review that flags agent changes which weaken tests, assertions or CI

    Runs locally
    • Open source
    • 4 Hacker News points
    • Developer tools
  3. Midplane

    MCP server

    Postgres gateway for AI agents with table grants, column masking and approval for writes

    Runs locally
    • Open source
    • 5 GitHub stars
    • Databases
  4. Leash

    MCP server

    Review what your AI touched, approve risky actions and undo supported changes

    • 1 tool
    • Remote
    • Free
    • 1 GitHub star
    • Security
  5. SecureCloud

    MCP server

    SentinelOne and IT security catalog, prices, quotes and checkout links for Israel

    • 7 tools
    • Remote
    • Free
    • Security