Query the Registry

The registry is a public, read-optimized knowledge base. Reads need no auth. Query it three ways: from an agent over MCP, from code over REST, or from the web UI.

From an agent (MCP)

The MCP server is the recommended path. Its answer_pack tool returns graded, license-checked citations for a question — each with a fail-closed reuse_ok and the packet_id to pull. search_registry_semantic and search_registry_hybrid expose raw retrieval.

uks serve   # registry-connected by default — paste the printed config into Claude

From code (REST)

All endpoints are under /api/registry. Reads are public.

Search & answer

Endpoint	Purpose
GET /api/registry/search	Keyword / full-text search
GET /api/registry/search/semantic	Embedding-based semantic search
GET /api/registry/search/hybrid	Hybrid (semantic + FTS, fused with RRF)
GET /api/registry/answer?q=…&hops=1|2	Graph-aware answer — returns a citation_chain (entity → relation → entity → sources) with per-edge license, grade, and freshness; degrades to flat retrieval when the graph is sparse
GET /api/registry/sources	Faceted source listing with license + freshness

Packets

Endpoint	Purpose
GET /api/registry/packets	List packets
GET /api/registry/packets/:id	Fetch a packet (raw, JSON-LD via content negotiation)
GET /api/registry/packets/by-cid/:cid	Fetch by content address (current or historical)
GET /api/registry/packets/:id/croissant	MLCommons Croissant export
GET /api/registry/claims.jsonld	schema.org ClaimReview feed

Knowledge graph

Endpoint	Purpose
GET /api/registry/entities · /entities/:name	Entities
GET /api/registry/entities/:name/relations	Typed relationships for an entity
GET /api/registry/entities/:name/authority	Global authority score (PageRank) + rank
GET /api/registry/canonical/:name	Canonical (resolved) entity + aliases
GET /api/registry/consensus/:name	Grade-weighted consensus / contested signal
GET /api/registry/coverage	Coverage map — domain × grade × clinical status
GET /api/registry/stats	Registry statistics

Example

curl "https://sabertools-production.up.railway.app/api/registry/answer?q=does%20CoQ10%20help%20statin%20myalgia&hops=2"

Every result is visibility-scoped and safety-vetoed — private, retracted, taken-down, injection-flagged, dead-link, and revoked-signer knowledge is excluded by default (opt back in per-endpoint with ?include_flagged=true). See Trust & safety.

From the web

Browse, search, and inspect packets — including the coverage heat-map — in the registry browser at saber.tools.

→ Related: MCP Server · Trust & safety · SDK registry client