Ratatosk MCP
CNCF release intelligence: typed changes from release notes and local stack checks
- 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.1Add to claude_desktop_config.json
{
"mcpServers": {
"ratatosk-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/garlickim21/ratatosk-mcp:0.9.1"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"ratatosk-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/garlickim21/ratatosk-mcp:0.9.1"
]
}
}
}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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools