io.github.jrainsberger/orthotomeo

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Read-only scripture-study engine: complete-or-fail concordance over Greek NT, Hebrew OT, LXX.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "orthotomeo": {
      "url": "https://orthotomeo.app/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (12)

• attestation read-only

  Returns the WHNT-style Type/Editions manuscript-tradition columns as neutral text-critical data (e.g. Mark 16:9-20 = Type KO) - which editions carry a word, with no argument for or against a variant.

  Parameters:

  • book (required) — string — USFM book code (e.g. GEN, PSA, MAT, REV) or the full English book name, any case (e.g. Genesis, matthew)
  • chapter (required) — integer — chapter number
  • verse (required) — integer — verse number
  • corpus (required) — string — word-tagged corpus: TAGNT, TAHOT, Swete, OSS-LXX-lemma
  • word — ['null', 'integer'] — 1-based word_no within the verse; omit for every word in the verse

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

• cite read-only

  Renders Citations (from any of the above tools) as quoted, fully-attributed Markdown bullets - the only sanctioned bridge from a query result to pastable study-document text.

  Parameters:

  • citations (required) — array — Citations previously returned by another tool call, to render as a pastable reference block

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

• concord_lemma read-only

  Complete-or-fail concordance: every words row in corpus whose lemma, dStrong, or (with by="surface") exact inflected surface form matches query. Route lemma/Strong's-number/surface-word lookups here, never by writing SQL or guessing occurrences from memory. This deployment caps one concordance result at 2000 occurrences and refuses anything broader, reporting the exact match count in the error. Call count first when a query might be broad - count is never capped.

  Parameters:

  • query (required) — string — a lemma (e.g. ἄφεσις), a disambiguated Strong's number (e.g. G0859, H7225G), or (with by="surface") the exact inflected word as it appears in the verse
  • corpus (required) — string — word-tagged corpus to search: TAGNT (Greek NT), TAHOT (Hebrew OT), Swete (LXX surface), OSS-LXX-lemma (LXX lemma)
  • by — string — optional match column override: lemma, dstrong, or surface. Omit for auto-detect (dStrong shape, else lemma) - surface must always be requested explicitly, it is never guessed

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

• concord_phrase read-only

  Complete-or-fail multi-word concordance: every occurrence, within one verse, of tokens (lemma strings) appearing in order within window intervening words of each other (window=0 = strictly adjacent). This is the tool for a phrase query like εἰς ἄφεσιν. This deployment caps one concordance result at 2000 occurrences and refuses anything broader, reporting the exact match count in the error. Call count first when a query might be broad - count is never capped.

  Parameters:

  • tokens (required) — array — ordered lemma strings to find co-occurring within one verse, e.g. ["εἰς","ἄφεσις"]
  • corpus (required) — string — word-tagged corpus to search: TAGNT, TAHOT, Swete, OSS-LXX-lemma
  • window (required) — integer — max words allowed between consecutive tokens; 0 = strictly adjacent

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

• count read-only

  Occurrence tally (total + per-book breakdown) for the identical query concord_lemma would match. count.Total always equals len(concord_lemma(...)) - use this to sanity-check a concordance result, or when only the number matters.

  Parameters:

  • query (required) — string — a lemma, dStrong, or (with by="surface") exact inflected word, same as concord_lemma
  • corpus (required) — string — word-tagged corpus: TAGNT, TAHOT, Swete, OSS-LXX-lemma
  • by — string — optional match column override: lemma, dstrong, or surface, same as concord_lemma

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

• get_passage read-only

  Returns get_verse's result for every canonical verse in a contiguous, single-book range, in order - verse boundaries preserved, never concatenated into one blob.

  Parameters:

  • book (required) — string — USFM book code (e.g. GEN, PSA, MAT, REV) or the full English book name, any case (e.g. Genesis, matthew)
  • start_chapter (required) — integer — first chapter of the range, inclusive
  • start_verse (required) — integer — first verse of the range, inclusive
  • end_chapter (required) — integer — last chapter of the range, inclusive
  • end_verse (required) — integer — last verse of the range, inclusive
  • editions (required) — array — verse-text editions to fetch verbatim text from: KJV, ASV, WEB, BSB, Brenton

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

• get_verse read-only

  Returns verbatim verse text with provenance for one canonical reference, one Citation per requested edition (KJV, ASV, WEB, BSB, Brenton).

  Parameters:

  • book (required) — string — USFM book code (e.g. GEN, PSA, MAT, REV) or the full English book name, any case (e.g. Genesis, matthew)
  • chapter (required) — integer — chapter number
  • verse (required) — integer — verse number
  • editions (required) — array — verse-text editions to fetch verbatim text from: KJV, ASV, WEB, BSB, Brenton

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

• interlinear read-only

  Returns a row-aligned reading view for every word in a verse (or one word, if word is given): original text, transliteration, gloss (via lexicon_lookup), grammar, and manuscript attestation stacked per word - the composed display shape for a study reading view, built on parse and lexicon_lookup rather than any new query. This is the most complete per-word view; use parse or attestation when you want only one of those facets.

  Parameters:

  • book (required) — string — USFM book code (e.g. GEN, PSA, MAT, REV) or the full English book name, any case (e.g. Genesis, matthew)
  • chapter (required) — integer — chapter number
  • verse (required) — integer — verse number
  • corpus (required) — string — word-tagged corpus: TAGNT, TAHOT, Swete, OSS-LXX-lemma
  • word — ['null', 'integer'] — 1-based word_no within the verse; omit for every word in the verse

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

• lemmatize read-only

  Returns the ordered lemma list for a verse (words with no lemma are omitted, not fabricated).

  Parameters:

  • book (required) — string — USFM book code (e.g. GEN, PSA, MAT, REV) or the full English book name, any case (e.g. Genesis, matthew)
  • chapter (required) — integer — chapter number
  • verse (required) — integer — verse number
  • corpus (required) — string — word-tagged corpus: TAGNT, TAHOT, Swete, OSS-LXX-lemma

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

• lexicon_lookup read-only

  Resolves a disambiguated Strong's number (dStrong) to its lexicon entry: lemma, transliteration, gloss, and - for a Greek entry only - a fuller definition (Abbott-Smith 1922, Public Domain). A Hebrew entry's definition field is always omitted: it is abridged BDB via Online Bible, which requires permission not yet obtained, so only its gloss is ever returned. Not to be confused with the get_verse/get_passage tools, which resolve a Ref to translated verse text, not a dStrong to a dictionary entry.

  Parameters:

  • dstrong (required) — string — a disambiguated Strong's number, e.g. G0859, H7225G

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

• parse read-only

  Returns dStrong + expanded morphology (via the T6 morph_codes table) for every word in a verse, or one word if word is given. LXX corpora (Swete, OSS-LXX-lemma) are always Flagged - neither carries morphology.

  Parameters:

  • book (required) — string — USFM book code (e.g. GEN, PSA, MAT, REV) or the full English book name, any case (e.g. Genesis, matthew)
  • chapter (required) — integer — chapter number
  • verse (required) — integer — verse number
  • corpus (required) — string — word-tagged corpus: TAGNT, TAHOT, Swete, OSS-LXX-lemma
  • word — ['null', 'integer'] — 1-based word_no within the verse; omit for every word in the verse

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

• resolve_ref read-only

  Reports, for every per-verse content edition (KJV, ASV, WEB, BSB, Brenton, TAGNT, TAHOT, Swete, OSS-LXX-lemma), whether a canonical reference has a counterpart there and where. Cross-edition divergence (a T4b merge/renumber/divide, or a reference simply missing from an edition) is reported as Caveats - never a silent shift.

  Parameters:

  • book (required) — string — USFM book code (e.g. GEN, PSA, MAT, REV) or the full English book name, any case (e.g. Genesis, matthew)
  • chapter (required) — integer — chapter number
  • verse (required) — integer — verse number

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.