Skip to content
MCP server

Ratatosk MCP

CNCF release intelligence: typed changes from release notes and local stack checks

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted, Web
Runs
Locally
Version
0.9.1
Listing updated
1 day ago

About Ratatosk MCP

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

Ratatosk reads release notes for 76 to 79 CNCF projects and turns them into typed, entity-level changes. Each change has a family (security, breaking or deprecated), a bucket (action, check, plan or other), and an applies_if expression an agent can evaluate against its own manifests, plus a verbatim quote from the release note as evidence. Changes are tied to identifiers such as CVE ids, flags and CRDs, and a matter key links the same issue across releases and branches.

The check_stack tool compares your versions locally, so only project slugs go to the server, and a sample answer for istio shows a high-severity JWKS finding with a condition under which it applies. No account or API key is needed. You can use the hosted endpoint, which allows 60 tool calls a minute per caller, or run the same server yourself with Docker, a Helm chart or a source build, which the README recommends for polling or CI.

Documentation is available in English, Korean and Japanese.

Install

Run in a terminal

claude mcp add ratatosk-mcp -- docker run -i --rm ghcr.io/garlickim21/ratatosk-mcp:0.9.1

Add to claude_desktop_config.json

{
  "mcpServers": {
    "ratatosk-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/garlickim21/ratatosk-mcp:0.9.1"
      ]
    }
  }
}
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/garlickim21/ratatosk-mcp:0.9.1"
      ]
    }
  }
}
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/garlickim21/ratatosk-mcp:0.9.1"
      ]
    }
  }
}

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

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

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

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

Tools this server provides (1)

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

check_stack
Compare your versions with changes after them, locally

What it does

Typed changes
Security, breaking and deprecated changes classified by urgency.
Evidence quotes
Each change carries a verbatim line from the release notes.
applies_if conditions
Machine-evaluable conditions for whether a change affects you.
Local stack check
Compare your versions locally; only project names are sent.
Self-hostable
Run via Docker, Helm or source.
No account
No sign-up or API key.

Good for

  • Check what must be done before upgrading envoy or istio
  • Find CVEs fixed after your deployed version
  • Spot APIs removed on an upgrade path
  • Plan for announced deprecations

Pricing

Open source

Free; hosted endpoint rate-limited to 60 calls/min

Prices change. Check ratatosk.io before you buy.

Ratatosk MCP FAQ

Do I need an account?

No, the README says no account and no API key.

What are the hosted limits?

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

What data is sent for check_stack?

Versions are compared locally and only project slugs go to the server.

How do I run it locally?

With docker run -i --rm using the ghcr.io image.

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/garlickim21/ratatosk-mcp:0.9.1

What are the best alternatives to Ratatosk MCP?

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

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