# Ratatosk MCP

> Ratatosk MCP is an open-source MCP server for developer tools. CNCF release intelligence: typed changes from release notes and local stack checks. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, Web
- **Website:** https://ratatosk.io
- **Repository:** https://github.com/garlickim21/ratatosk-mcp
- **MCP Registry name:** io.github.garlicKim21/ratatosk-mcp
- **Categories:** developer tools, cloud and infrastructure, security
- **Listing updated:** 2026-11-16

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

```json
{
  "servers": {
    "ratatosk-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/garlickim21/ratatosk-mcp:0.9.1"
      ]
    }
  }
}
```

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

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

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

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

## Tools

- `check_stack`: Compare your versions with changes after them, locally

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

- [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/ratatosk-mcp
