LOGOI

Documentation

MCP for agents

Endpoint

https://logoi.health/api/mcp — Streamable HTTP transport (MCP SDK ^1.29.0), requests must send Accept: application/json, text/event-stream (a JSON-only Accept gets a self-explaining 406), no authentication required for read access. The MCP tools run against the same corpus as the chat interface, so results are identical across surfaces. 

{
  "mcpServers": {
    "logoi": {
      "type": "http",
      "url": "https://logoi.health/api/mcp"
    }
  }
}

The eighteen tools

Every tool result carries source_ids plus either a materialized receipt_url or an explicit unavailable receipt state. A missing receipt is reported, never replaced with an unrelated one.

  • lemma_lookup — Resolve a lemma to its language-wing term row, lexical pointers, and corpus-wide count.
  • concordance_search — Paginated occurrences of a lemma; optional exact canonical work_id filter.
  • passage_lookup — Fetch a cited passage from any corpus wing; returns source text when its edition license permits.
  • lexicon_lookup — Return entries from the language wing's named lexical authority, or a typed unavailable state.
  • source_get — Source row with edition, license posture, and audit metadata.
  • receipt_get — Receipt with the claim-to-evidence chain.
  • semantic_query — Similarity search over embedded passages; results are candidates, not audited claims.
  • etymology_lookup — Authority pointers (Beekes, Chantraine, Frisk) — never invented content.
  • parse_form — Language-explicit form analysis: Greek morphology only after row-level provider/review/public gates close, otherwise provenance-only; Latin CLTK lemmatization-only with provenance; other wing profiles fail explicitly unavailable without borrowed assumptions.
  • cooccurrence_search — Passages where two lemmas co-occur, or the top companions of one lemma.
  • frequency_profile — Per-work occurrence counts normalized per 10,000 tokens.
  • passage_analysis — Interlinear token-level analysis: lemma, POS, parse, and the language wing's own lexicon record when available.
  • kg_neighbors — Knowledge-graph companions of a soul-word (same-passage co-occurrence + concept lanes), with a receipt on every edge.
  • kg_path — Bounded shortest path between two soul-words in the graph — why they are connected, receipted per hop.
  • lane_compare — The member words of one concept lane side by side, each with its relation (core / partial / contested).
  • reverse_lookup — Find Greek lemmas whose lexicon senses carry a given English word.
  • consult_the_rhapsode — The story-record at mythoi.health over the authenticated family lane — motif addresses, episode search, cross-tradition witnesses, timelines. A missing server-side house credential fails typed connector-unavailable before any request. The additive federation reference labels Mythoi ownership, preserves all owner receipts, and keeps relation and crosswalk state unresolved in Logoi.
  • commentary_search — Unresolved, non-citable bibliography candidates with retrieved text withheld (metered retrieval) — open to members and the family houses; anonymous callers receive an access boundary, never a false empty.

Agent guidance

  • An empty tool result means "not attested in the indexed corpus" — report that; it is a correct answer.
  • Check GET /api/v1/coverage before making absence claims about a work or author.
  • Cite passages by the canonical reference the tool returns (e.g. Il. 1.1, Hdt. 5.56).
  • Do not fill gaps from model memory; the corpus is the only evidence source.
  • Greek text returns only where the edition's license permits display; withheld text comes back as a typed license state, not silence.

See the citation policy for receipts and quoting rules, and the API docs for the SSE chat endpoint.