API
The agent channel
The record is served to machines as it is to readers — every tool result an envelope carrying source_ids and a receipt_url (null when no filed receipt backs that specific result).
- GET /api/v1/tools The live tool inventory with JSON schemas — fifteen tools, listed below.
- GET/POST /api/v1/tools/<tool> Run a tool. GET maps query params to input (/api/v1/tools/motif_lookup?tmi_id=A1010); POST takes JSON input.
- POST /api/mcp Model Context Protocol (streamable HTTP, JSON responses): initialize, tools/list, tools/call over the same fifteen tools.
- POST /api/v1/ask The Rhapsode: { question } → answer + the thread of consulted sources. /api/v1/ask-stream streams the same desk.
- GET /llms.txt The concise model orientation; /llms-full.txt carries the expanded grounding contract and generated tool catalog.
- GET /api/v1/openapi.json OpenAPI 3.1 generated from the same tool definitions used by REST, MCP, and the Rhapsode.
The fifteen tools
- motif_lookup Thompson Motif-Index lookup: exact tmi_id or plain-words label search, with filed-attestation counts.
- attestation_search Where a motif lives in the served texts: curated attestations, wired Thompson citations, computed leads.
- tradition_profile A tradition's shelf: its works, episode counts, filed attestations; omit slug to list all traditions.
- episode_lookup Read an episode of a work by canonical ref; text served when license permits, pointer-only otherwise.
- episode_search Full-text search across the complete text of every served episode, all works and shelves at once.
- motif_neighbors The knowledge graph around one motif: tradition citations, index hierarchy, cross-references, ATU links, and the served episodes it is attested in.
- compare_traditions Every witness of a motif and its children, grouped by tradition — the cross-cultural stitch.
- myth_timeline The same witnesses ordered by composition era, oldest first — the long axis through time.
- commentary_search Full-text search over the commentary shelves: early psychology, comparative scholarship, alchemy.
- tale_type_lookup ATU tale types by number or name; numbers and names are the served facts.
- library_quote Cited excerpts from the owned research library — up to 400 words, always attributed inline.
- consult_the_record The philological word-desk at logoi.health: lemma, passage, concordance, or semantic lookups.
- consult_the_analysts The estate's depth-psychology commentary shelf — dated commentary attributed by author and year. Members and the sibling houses only; anonymous callers get an honest access boundary.
- library_lookup The family library's holdings (author/title/year) for cite-and-locate; the text is never served here.
- receipt_get Fetch a receipt by slug: scope, sources with licenses and checksums, what the claim does not prove.
Access lanes
The corpus tools are open to anonymous callers over REST and MCP, held to a per-IP per-minute burst cap; the Rhapsode desk carries a daily anonymous allowance per IP. X-Member-Key lets members ask uncounted; X-House-Token is the federation lane for sibling houses (quota-exempt, burst-braked — courtesy, never content). /api/v1/auth/*, /api/v1/account/*, and /api/v1/billing/* are member surfaces, not part of the public agent channel.