# Stoic Sage

A semantic search engine for Stoic philosophy — *Meditations* (Marcus Aurelius), *On the Tranquillity of Mind* and *On the Shortness of Life* (Seneca), and the *Discourses*, *Enchiridion*, and *Fragments* (Epictetus). Over 1,400 curated passages.

## For agents

- **Search:** `GET https://stoicsage.ai/api/search?q=...&topK=5` — semantic-first hybrid search across the corpus.
- **Daily reflection:** `GET https://stoicsage.ai/api/daily` — a date-seeded entry with pre-generated AI commentary.
- **Random entry:** `GET https://stoicsage.ai/api/random`.
- **Single entry:** `GET https://stoicsage.ai/api/entry/{book}/{id}?source=...`.
- **Explain:** `POST https://stoicsage.ai/api/explain` — streamed advisor-style explanation (Server-Sent Events).
- **MCP server:** `https://stoicsage.ai/mcp` — Streamable HTTP. Tools: `search_texts`, `get_entry`, `daily_reflection`.
- **OpenAPI:** `https://stoicsage.ai/openapi.json` · **API catalog:** `https://stoicsage.ai/.well-known/api-catalog`.

## Thematic notes

Long-form essays on Stoic themes at `https://stoicsage.ai/notes`.
