# Ratatosk MCP

> Ratatosk MCP is an open-source MCP server for cloud and infrastructure. CNCF release notes turned into typed changes, with a local stack version check. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, API
- **Website:** https://ratatosk.io
- **Repository:** https://github.com/basphere/ratatosk-mcp
- **MCP Registry name:** io.github.basphere/ratatosk-mcp
- **Categories:** cloud and infrastructure, security
- **Listing updated:** 2026-11-15

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## Tools

- `check_stack`: Compares the versions you run against recorded changes locally.

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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Agent Roast](https://ai-powered.com/mcp/agent-roast): Agent Roast is an open-source MCP server for developer tools.
- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.
- [Leash](https://ai-powered.com/mcp/leash): Leash is a free MCP server for security.
- [Tinplate Edge AI Safety, Security & EU Compliance](https://ai-powered.com/mcp/tinplate-edge-ai-safety-security-and-eu-compliance): Tinplate Edge AI Safety, Security & EU Compliance is a freemium MCP server for security.
- [SecureCloud](https://ai-powered.com/mcp/securecloud): SecureCloud is a free MCP server for security.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.
- [SynomosAI Governance MCP](https://ai-powered.com/mcp/synomosai-governance-mcp-2): SynomosAI Governance MCP is an open-source MCP server for security.

---
Source: https://ai-powered.com/mcp/ratatosk-mcp-2
