{"name":"Ratatosk agent API","version":"v1","description":"Release intelligence facts for the CNCF/cloud-native ecosystem: typed, entity-level change facts (security fixes, removals, deprecations, renames, defaults) extracted from release notes. Facts are declarative and language-neutral; match entities[].name against your own manifests.","auth":"none (public read); rate limit 60 requests/minute per IP","endpoints":[{"method":"GET","path":"/v1/facts","params":{"project":"project slug filter (see /projects)","type":"fact_type filter, e.g. security_fix|dependency_bump|capability_removed|capability_deprecated|api_version_changed|identifier_renamed|validation_tightened|default_changed|behavior_changed","severity":"info|low|medium|high|critical","since":"cursor: return facts with fact_id greater than this (id-ascending; poll incrementally with the returned next_since)","limit":"page size, default 50, max 200"},"description":"Incremental fact feed, ordered by fact_id ascending.","example":"https://ratatosk.io/v1/facts?severity=critical&limit=5"},{"method":"GET","path":"/v1/facts/by-entity","params":{"name":"exact identifier to look up (case-insensitive): CVE id, CRD, feature gate, flag, metric, config field, dependency…","kind":"optional: api|crd|feature_gate|flag|metric|config_field|extension|dependency|cve|advisory|subsystem"},"description":"Reverse index: every fact touching this identifier.","example":"https://ratatosk.io/v1/facts/by-entity?name=CVE-2026-53329"},{"method":"GET","path":"/v1/releases/{project}/{version}","params":{"include":"raw — add the original release note body as raw_notes (capped; raw_notes_truncated=true when cut). raw_notes is also included automatically when coverage is not full_reviewed or facts is empty, so you can judge from the source."},"description":"One reviewed release: envelope (coverage, assessment, source) plus all its facts. facts=[] with coverage=full_reviewed means the release was read and is routine — auditable silence.","example":"https://ratatosk.io/v1/releases/envoy/v1.38.3?include=raw"}],"mcp_server":{"repository":"https://github.com/garlicKim21/ratatosk-mcp","image":"ghcr.io/garlickim21/ratatosk-mcp","transports":["stdio","streamable-http"],"description":"MCP tools over this API, including check_stack: local version matching so running versions never reach the server."},"terms":"https://ratatosk.io/terms","docs":"https://ratatosk.io/"}