Read endpoints require no authentication. Machine-readable spec: /openapi.json. Catalog: /.well-known/api-catalog.
| Method | Path | Description |
|---|---|---|
| GET | /api/search?q=&topK=5 | Semantic-first hybrid search across the corpus. |
| GET | /api/entry/{book}/{id}?source= | Fetch one entry by source, book/chapter, id. |
| GET | /api/random | A weighted-random reflectable entry. |
| GET | /api/daily | Today's date-seeded entry + AI meditation. |
| POST | /api/explain | Stream an advisor-style explanation (SSE). |
| PUT | /api/views/{viewId}/rating | Rate a viewed entry (1–3). |
| POST | /mcp | MCP server (Streamable HTTP): search_texts, get_entry, daily_reflection. |
Agents: see also the MCP server card and the agent-skills index.