{"openapi":"3.1.0","info":{"title":"Besorah text API","version":"2.1","description":"Read, search and study the Bible's texts (Hebrew, Greek, Aramaic, English), Strong's lexicon with Brown–Driver–Briggs, cross-references, grammar queries, collocations and more. Free, no key, read-only. Every MCP tool is also available as GET /api/tools/{name}?arg=value (or POST JSON); every page is also available as Markdown, plain text and JSON; the reading schedules are Atom/JSON feeds and calendars. Please link back to the url in each response.","contact":{"name":"Besorah support","email":"support@besorah.bible","url":"https://besorah.bible/about/support.html"},"license":{"name":"Data licence notice (open sources; CC BY / CC BY-SA parts credited)","url":"https://besorah.bible/data-licence.txt"}},"externalDocs":{"description":"Developer guide: formats, REST, MCP, feeds, calendars","url":"https://besorah.bible/about/api/"},"servers":[{"url":"https://besorah.bible"}],"tags":[{"name":"passages","description":"Read verses and chapters"},{"name":"tools","description":"Study tools (the same as the MCP tools)"},{"name":"pages","description":"Any page as Markdown, text or JSON"},{"name":"feeds","description":"Reading schedules as feeds and calendars"},{"name":"discovery","description":"Where to find things"}],"paths":{"/api":{"get":{"tags":["discovery"],"summary":"An index of everything available (JSON)","responses":{"200":{"description":"Index"}}}},"/api/verse":{"get":{"tags":["passages"],"summary":"A verse, range or chapter","parameters":[{"name":"ref","in":"query","required":true,"schema":{"type":"string"},"example":"John 3:16-17"}],"responses":{"200":{"description":"Passage"}}}},"/api/word":{"get":{"tags":["passages"],"summary":"A Strong's entry","parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"},"example":"H430"}],"responses":{"200":{"description":"Word"}}}},"/api/tools/get_passage":{"get":{"tags":["tools"],"operationId":"get_passage","summary":"Read a passage (verse, range or chapter) in its original language (Hebrew, Greek or Aramaic) and English, with a link. Optional: edition (septuagint, onkelos, pseudo-jonathan, jonathan, hebrew-nt, hebrew, greek) and words=true for each word's Strong's number, lemma, meaning and grammatical parsing. Use when the user asks to read or quote a verse, range or chapter.","parameters":[{"name":"reference","in":"query","required":true,"schema":{"type":"string"},"description":"e.g. 'John 3:16', 'Psalm 23', 'Genesis 1:1-3', '1 Corinthians 13:4-7'"},{"name":"edition","in":"query","required":false,"schema":{"type":"string"}},{"name":"words","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"max_chars","in":"query","required":false,"schema":{"type":"number"},"description":"optional: cap the answer at about this many characters (lists are shortened and marked truncated; use offset/nextOffset to get the rest)"},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["json","markdown"]},"description":"optional: json (default) or markdown (compact, readable)"}],"responses":{"200":{"description":"Result (JSON; format=markdown returns { markdown })"},"404":{"description":"{ error }"}}}},"/api/tools/get_verse_study":{"get":{"tags":["tools"],"operationId":"get_verse_study","summary":"Everything Besorah knows about one verse (or a range of up to 5): text, word-by-word Strong's/lemma/parsing, cross-references, quotations between books, curated parallels, similar wording, questions it asks or answers, songs, scribal marks, Ketiv/Qere, Targum connections. Use when the user wants a thorough look at one verse, or up to five.","parameters":[{"name":"reference","in":"query","required":true,"schema":{"type":"string"},"description":"e.g. 'John 3:16', 'Psalm 23', 'Genesis 1:1-3', '1 Corinthians 13:4-7'"},{"name":"edition","in":"query","required":false,"schema":{"type":"string"}},{"name":"max_chars","in":"query","required":false,"schema":{"type":"number"},"description":"optional: cap the answer at about this many characters (lists are shortened and marked truncated; use offset/nextOffset to get the rest)"},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["json","markdown"]},"description":"optional: json (default) or markdown (compact, readable)"}],"responses":{"200":{"description":"Result (JSON; format=markdown returns { markdown })"},"404":{"description":"{ error }"}}}},"/api/tools/search_text":{"get":{"tags":["tools"],"operationId":"search_text","summary":"Search the text itself. English by default; language=hebrew|greek|aramaic searches the original (vowel points and accents ignored). All words must be in the verse; \"quoted phrase\"; prefix with * (lov*). Narrow with book, testament (tanakh|new testament|apocrypha) or edition. Pages with offset. Use when the user searches for words or phrases in the text itself.","parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"}},{"name":"language","in":"query","required":false,"schema":{"type":"string","enum":["english","hebrew","greek","aramaic"]}},{"name":"book","in":"query","required":false,"schema":{"type":"string"}},{"name":"testament","in":"query","required":false,"schema":{"type":"string"}},{"name":"edition","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"number"},"description":"1-25, default 10"},{"name":"offset","in":"query","required":false,"schema":{"type":"number"}},{"name":"max_chars","in":"query","required":false,"schema":{"type":"number"},"description":"optional: cap the answer at about this many characters (lists are shortened and marked truncated; use offset/nextOffset to get the rest)"},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["json","markdown"]},"description":"optional: json (default) or markdown (compact, readable)"}],"responses":{"200":{"description":"Result (JSON; format=markdown returns { markdown })"},"404":{"description":"{ error }"}}}},"/api/tools/search_words":{"get":{"tags":["tools"],"operationId":"search_words","summary":"Find Hebrew or Greek words (Strong's entries) from an English word, a transliteration ('shalom', 'agape') or the original word. Returns Strong's ids with lemma, definition and occurrence counts. Use when the user asks which Hebrew or Greek word lies behind an English word or transliteration.","parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"number"},"description":"1-25, default 10"},{"name":"max_chars","in":"query","required":false,"schema":{"type":"number"},"description":"optional: cap the answer at about this many characters (lists are shortened and marked truncated; use offset/nextOffset to get the rest)"},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["json","markdown"]},"description":"optional: json (default) or markdown (compact, readable)"}],"responses":{"200":{"description":"Result (JSON; format=markdown returns { markdown })"},"404":{"description":"{ error }"}}}},"/api/tools/get_word":{"get":{"tags":["tools"],"operationId":"get_word","summary":"A Strong's lexicon entry (Hebrew H… or Greek G…): lemma, definition, KJV renderings, occurrences, for Hebrew the Brown–Driver–Briggs entry, how names are built, verses per book, and the Septuagint renderings of a Hebrew word (or the Hebrew words a Greek word renders). Use when the user asks what a Hebrew or Greek word means, given its Strong's number.","parameters":[{"name":"strongs","in":"query","required":true,"schema":{"type":"string"},"description":"e.g. H430 or G26"},{"name":"max_chars","in":"query","required":false,"schema":{"type":"number"},"description":"optional: cap the answer at about this many characters (lists are shortened and marked truncated; use offset/nextOffset to get the rest)"},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["json","markdown"]},"description":"optional: json (default) or markdown (compact, readable)"}],"responses":{"200":{"description":"Result (JSON; format=markdown returns { markdown })"},"404":{"description":"{ error }"}}}},"/api/tools/get_word_occurrences":{"get":{"tags":["tools"],"operationId":"get_word_occurrences","summary":"Every verse a Strong's number is in (Hebrew Tanakh, Greek New Testament and Septuagint), with the text, optionally within one book. Covers every form of the word. Pages with offset. Use when the user asks where a particular Hebrew or Greek word occurs.","parameters":[{"name":"strongs","in":"query","required":true,"schema":{"type":"string"}},{"name":"book","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"number"},"description":"1-25, default 10"},{"name":"offset","in":"query","required":false,"schema":{"type":"number"}},{"name":"max_chars","in":"query","required":false,"schema":{"type":"number"},"description":"optional: cap the answer at about this many characters (lists are shortened and marked truncated; use offset/nextOffset to get the rest)"},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["json","markdown"]},"description":"optional: json (default) or markdown (compact, readable)"}],"responses":{"200":{"description":"Result (JSON; format=markdown returns { markdown })"},"404":{"description":"{ error }"}}}},"/api/tools/get_related_passages":{"get":{"tags":["tools"],"operationId":"get_related_passages","summary":"For one verse: voted cross-references, quotations in either direction between books, curated parallel passages, and similar wording. Use when the user asks what passages are related to one verse.","parameters":[{"name":"reference","in":"query","required":true,"schema":{"type":"string"},"description":"e.g. 'John 3:16', 'Psalm 23', 'Genesis 1:1-3', '1 Corinthians 13:4-7'"},{"name":"limit","in":"query","required":false,"schema":{"type":"number"}},{"name":"max_chars","in":"query","required":false,"schema":{"type":"number"},"description":"optional: cap the answer at about this many characters (lists are shortened and marked truncated; use offset/nextOffset to get the rest)"},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["json","markdown"]},"description":"optional: json (default) or markdown (compact, readable)"}],"responses":{"200":{"description":"Result (JSON; format=markdown returns { markdown })"},"404":{"description":"{ error }"}}}},"/api/tools/get_cross_references":{"get":{"tags":["tools"],"operationId":"get_cross_references","summary":"Cross-references for one verse (voted, OpenBible.info); the first few include their English text. Use when the user asks for the cross-references of one verse.","parameters":[{"name":"reference","in":"query","required":true,"schema":{"type":"string"},"description":"e.g. 'John 3:16', 'Psalm 23', 'Genesis 1:1-3', '1 Corinthians 13:4-7'"},{"name":"limit","in":"query","required":false,"schema":{"type":"number"},"description":"1-30, default 12"},{"name":"max_chars","in":"query","required":false,"schema":{"type":"number"},"description":"optional: cap the answer at about this many characters (lists are shortened and marked truncated; use offset/nextOffset to get the rest)"},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["json","markdown"]},"description":"optional: json (default) or markdown (compact, readable)"}],"responses":{"200":{"description":"Result (JSON; format=markdown returns { markdown })"},"404":{"description":"{ error }"}}}},"/api/tools/get_book_connections":{"get":{"tags":["tools"],"operationId":"get_book_connections","summary":"The chapters a book (or one chapter) is most joined to by cross-references across the whole Bible. Use when the user asks which chapters a book or chapter is most connected to.","parameters":[{"name":"reference","in":"query","required":true,"schema":{"type":"string"},"description":"a book ('Isaiah') or a chapter ('Psalm 22')"},{"name":"limit","in":"query","required":false,"schema":{"type":"number"}},{"name":"max_chars","in":"query","required":false,"schema":{"type":"number"},"description":"optional: cap the answer at about this many characters (lists are shortened and marked truncated; use offset/nextOffset to get the rest)"},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["json","markdown"]},"description":"optional: json (default) or markdown (compact, readable)"}],"responses":{"200":{"description":"Result (JSON; format=markdown returns { markdown })"},"404":{"description":"{ error }"}}}},"/api/tools/list_books":{"get":{"tags":["tools"],"operationId":"list_books","summary":"Every book with its code, chapter count, the editions it exists in, and its URL; also the editions. Use when the user asks what books, editions or book codes are available.","parameters":[{"name":"max_chars","in":"query","required":false,"schema":{"type":"number"},"description":"optional: cap the answer at about this many characters (lists are shortened and marked truncated; use offset/nextOffset to get the rest)"},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["json","markdown"]},"description":"optional: json (default) or markdown (compact, readable)"}],"responses":{"200":{"description":"Result (JSON; format=markdown returns { markdown })"},"404":{"description":"{ error }"}}}},"/api/tools/list_songs":{"get":{"tags":["tools"],"operationId":"list_songs","summary":"Songs and prayers inside Scripture (the Song of the Sea, Hannah's prayer, the Magnificat…), by kind. Use when the user asks about songs and prayers inside Scripture.","parameters":[{"name":"kind","in":"query","required":false,"schema":{"type":"string"}},{"name":"max_chars","in":"query","required":false,"schema":{"type":"number"},"description":"optional: cap the answer at about this many characters (lists are shortened and marked truncated; use offset/nextOffset to get the rest)"},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["json","markdown"]},"description":"optional: json (default) or markdown (compact, readable)"}],"responses":{"200":{"description":"Result (JSON; format=markdown returns { markdown })"},"404":{"description":"{ error }"}}}},"/api/tools/list_questions":{"get":{"tags":["tools"],"operationId":"list_questions","summary":"Questions asked in one place and answered in another (e.g. 'what is man?' in Job and Psalm 8), by theme. Use when the user asks about a question in one passage that another passage answers.","parameters":[{"name":"theme","in":"query","required":false,"schema":{"type":"string"}},{"name":"contains","in":"query","required":false,"schema":{"type":"string"}},{"name":"max_chars","in":"query","required":false,"schema":{"type":"number"},"description":"optional: cap the answer at about this many characters (lists are shortened and marked truncated; use offset/nextOffset to get the rest)"},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["json","markdown"]},"description":"optional: json (default) or markdown (compact, readable)"}],"responses":{"200":{"description":"Result (JSON; format=markdown returns { markdown })"},"404":{"description":"{ error }"}}}},"/api/tools/get_targum_connections":{"get":{"tags":["tools"],"operationId":"get_targum_connections","summary":"Where the Targumim and the New Testament share an idea or phrase. Use when the user asks how the Targumim and the New Testament share ideas or phrases.","parameters":[{"name":"max_chars","in":"query","required":false,"schema":{"type":"number"},"description":"optional: cap the answer at about this many characters (lists are shortened and marked truncated; use offset/nextOffset to get the rest)"},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["json","markdown"]},"description":"optional: json (default) or markdown (compact, readable)"}],"responses":{"200":{"description":"Result (JSON; format=markdown returns { markdown })"},"404":{"description":"{ error }"}}}},"/api/tools/get_parashah":{"get":{"tags":["tools"],"operationId":"get_parashah","summary":"A weekly Torah portion with its Torah, Haftarah and Besorah (New Testament) readings. Give a name ('Toledot'), a date (YYYY-MM-DD) for the portion read on the Shabbat on or after it, or list=true for all of them; with none, this week's. Use when the user asks about a weekly Torah portion, its Haftarah or its New Testament reading.","parameters":[{"name":"name","in":"query","required":false,"schema":{"type":"string"}},{"name":"date","in":"query","required":false,"schema":{"type":"string"}},{"name":"list","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"max_chars","in":"query","required":false,"schema":{"type":"number"},"description":"optional: cap the answer at about this many characters (lists are shortened and marked truncated; use offset/nextOffset to get the rest)"},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["json","markdown"]},"description":"optional: json (default) or markdown (compact, readable)"}],"responses":{"200":{"description":"Result (JSON; format=markdown returns { markdown })"},"404":{"description":"{ error }"}}}},"/api/tools/get_guide":{"get":{"tags":["tools"],"operationId":"get_guide","summary":"How Besorah's texts and tools fit together, and the conventions (numbering, ids, codes). Use when the user asks how the texts, numbering and ids work.","parameters":[{"name":"max_chars","in":"query","required":false,"schema":{"type":"number"},"description":"optional: cap the answer at about this many characters (lists are shortened and marked truncated; use offset/nextOffset to get the rest)"},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["json","markdown"]},"description":"optional: json (default) or markdown (compact, readable)"}],"responses":{"200":{"description":"Result (JSON; format=markdown returns { markdown })"},"404":{"description":"{ error }"}}}},"/api/tools/query_words":{"get":{"tags":["tools"],"operationId":"query_words","summary":"Find every word by grammar and/or Strong's number, within a book or testament — e.g. all Qal imperatives of H1285 in the Prophets, every aorist passive participle in Paul, every Hiphil verb in Isaiah. grammar takes the words of the parsing (Qal, Hiphil, imperative, participle, feminine, plural, aorist, passive, genitive, 3rd…); all must be on the same word. Hebrew by default for H ids/Tanakh books, Greek for G ids/New Testament; edition=septuagint for the Septuagint. Pages with offset. Use when the user asks for words by grammatical form, such as every Qal imperative or aorist passive participle.","parameters":[{"name":"strongs","in":"query","required":false,"schema":{"type":"string"},"description":"e.g. H1285 (optional)"},{"name":"grammar","in":"query","required":false,"schema":{"type":"string"},"description":"e.g. 'Qal imperative', 'aorist passive participle', 'feminine plural'"},{"name":"book","in":"query","required":false,"schema":{"type":"string"}},{"name":"testament","in":"query","required":false,"schema":{"type":"string"},"description":"tanakh | new testament | apocrypha"},{"name":"edition","in":"query","required":false,"schema":{"type":"string"},"description":"hebrew | greek | septuagint"},{"name":"limit","in":"query","required":false,"schema":{"type":"number"},"description":"how many to return"},{"name":"offset","in":"query","required":false,"schema":{"type":"number"}},{"name":"max_chars","in":"query","required":false,"schema":{"type":"number"},"description":"optional: cap the answer at about this many characters (lists are shortened and marked truncated; use offset/nextOffset to get the rest)"},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["json","markdown"]},"description":"optional: json (default) or markdown (compact, readable)"}],"responses":{"200":{"description":"Result (JSON; format=markdown returns { markdown })"},"404":{"description":"{ error }"}}}},"/api/tools/get_collocations":{"get":{"tags":["tools"],"operationId":"get_collocations","summary":"The words that keep company with a Hebrew or Greek word: which other words most often appear in the same verse, ranked by how much more than chance. Pass strongs (H430) or a word ('shepherd'). Pass with=<Strong's id> to read the verses where two words meet. corpus: he, nt or lxx. Use when the user asks which words commonly appear alongside a given Hebrew or Greek word.","parameters":[{"name":"strongs","in":"query","required":true,"schema":{"type":"string"},"description":"H430, or an English/transliterated word"},{"name":"with","in":"query","required":false,"schema":{"type":"string"},"description":"a second Strong's id, to see the verses with both"},{"name":"corpus","in":"query","required":false,"schema":{"type":"string","enum":["he","nt","lxx"]}},{"name":"limit","in":"query","required":false,"schema":{"type":"number"},"description":"how many to return"},{"name":"max_chars","in":"query","required":false,"schema":{"type":"number"},"description":"optional: cap the answer at about this many characters (lists are shortened and marked truncated; use offset/nextOffset to get the rest)"},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["json","markdown"]},"description":"optional: json (default) or markdown (compact, readable)"}],"responses":{"200":{"description":"Result (JSON; format=markdown returns { markdown })"},"404":{"description":"{ error }"}}}},"/api/tools/get_vocabulary":{"get":{"tags":["tools"],"operationId":"get_vocabulary","summary":"A book's vocabulary: size, most frequent and most characteristic words (summary); hapax legomena (words used once in the whole text); words used only in that book; or every word by frequency. view=summary|hapax|unique|words. Pages with offset. Use when the user asks about one book's vocabulary, rare words or words unique to it.","parameters":[{"name":"book","in":"query","required":true,"schema":{"type":"string"}},{"name":"view","in":"query","required":false,"schema":{"type":"string","enum":["summary","hapax","unique","words"]}},{"name":"edition","in":"query","required":false,"schema":{"type":"string"},"description":"hebrew | greek | septuagint"},{"name":"limit","in":"query","required":false,"schema":{"type":"number"},"description":"how many to return"},{"name":"offset","in":"query","required":false,"schema":{"type":"number"}},{"name":"max_chars","in":"query","required":false,"schema":{"type":"number"},"description":"optional: cap the answer at about this many characters (lists are shortened and marked truncated; use offset/nextOffset to get the rest)"},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["json","markdown"]},"description":"optional: json (default) or markdown (compact, readable)"}],"responses":{"200":{"description":"Result (JSON; format=markdown returns { markdown })"},"404":{"description":"{ error }"}}}},"/api/tools/compare_books":{"get":{"tags":["tools"],"operationId":"compare_books","summary":"Compare two books' vocabularies: how many words they share, the rare words they share (most of whose uses are in these two books), and the words only one uses. Same language only: two Hebrew books, two Greek ones, or a Septuagint book (editionA: septuagint) against a New Testament book. Use when the user asks how the vocabularies of two books compare.","parameters":[{"name":"a","in":"query","required":true,"schema":{"type":"string"},"description":"e.g. Isaiah"},{"name":"b","in":"query","required":true,"schema":{"type":"string"},"description":"e.g. Matthew"},{"name":"editionA","in":"query","required":false,"schema":{"type":"string"}},{"name":"editionB","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"number"},"description":"how many to return"},{"name":"max_chars","in":"query","required":false,"schema":{"type":"number"},"description":"optional: cap the answer at about this many characters (lists are shortened and marked truncated; use offset/nextOffset to get the rest)"},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["json","markdown"]},"description":"optional: json (default) or markdown (compact, readable)"}],"responses":{"200":{"description":"Result (JSON; format=markdown returns { markdown })"},"404":{"description":"{ error }"}}}},"/api/tools/get_context":{"get":{"tags":["tools"],"operationId":"get_context","summary":"A verse in its setting in one call: the verses before and after, the verse (or up to 5) word by word, and its cross-references, quotations and parallels. Combines several lookups into one answer. Use when the user asks what surrounds a verse, with its neighbouring verses and connections.","parameters":[{"name":"reference","in":"query","required":true,"schema":{"type":"string"},"description":"e.g. 'John 3:16', 'Psalm 23', 'Genesis 1:1-3'"},{"name":"before","in":"query","required":false,"schema":{"type":"number"},"description":"verses before, 0-8, default 2"},{"name":"after","in":"query","required":false,"schema":{"type":"number"},"description":"verses after, 0-8, default 2"},{"name":"edition","in":"query","required":false,"schema":{"type":"string"}},{"name":"max_chars","in":"query","required":false,"schema":{"type":"number"},"description":"optional: cap the answer at about this many characters (lists are shortened and marked truncated; use offset/nextOffset to get the rest)"},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["json","markdown"]},"description":"optional: json (default) or markdown (compact, readable)"}],"responses":{"200":{"description":"Result (JSON; format=markdown returns { markdown })"},"404":{"description":"{ error }"}}}},"/api/tools/trace_theme":{"get":{"tags":["tools"],"operationId":"trace_theme","summary":"Follow a passage's connections outward — voted cross-references plus quotations and parallels between books — one to three steps, and return the verses most strongly connected, with their text. Example: the connections of Passover outward from Exodus 12. Use when the user asks to follow a theme or passage outward through the Bible.","parameters":[{"name":"reference","in":"query","required":true,"schema":{"type":"string"},"description":"a verse, short range or chapter"},{"name":"depth","in":"query","required":false,"schema":{"type":"number"},"description":"1-3 steps, default 2"},{"name":"breadth","in":"query","required":false,"schema":{"type":"number"},"description":"links followed per verse, 2-10, default 5"},{"name":"follow","in":"query","required":false,"schema":{"type":"string","enum":["both","xref","quotes"]}},{"name":"limit","in":"query","required":false,"schema":{"type":"number"},"description":"how many to return"},{"name":"max_chars","in":"query","required":false,"schema":{"type":"number"},"description":"optional: cap the answer at about this many characters (lists are shortened and marked truncated; use offset/nextOffset to get the rest)"},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["json","markdown"]},"description":"optional: json (default) or markdown (compact, readable)"}],"responses":{"200":{"description":"Result (JSON; format=markdown returns { markdown })"},"404":{"description":"{ error }"}}}},"/api/tools/compare_witnesses":{"get":{"tags":["tools"],"operationId":"compare_witnesses","summary":"One verse across the texts: Hebrew, the Septuagint (matched by the app's verse tables, even where numbered differently), the Targumim, the Greek and Hebrew New Testament, and the quotations that join them — with the Greek words a New Testament quotation and the Septuagint do and do not share. Use when the user asks how one verse reads in the Hebrew, Septuagint, Targum and New Testament.","parameters":[{"name":"reference","in":"query","required":true,"schema":{"type":"string"},"description":"e.g. 'John 3:16', 'Psalm 23', 'Genesis 1:1-3'"},{"name":"max_chars","in":"query","required":false,"schema":{"type":"number"},"description":"optional: cap the answer at about this many characters (lists are shortened and marked truncated; use offset/nextOffset to get the rest)"},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["json","markdown"]},"description":"optional: json (default) or markdown (compact, readable)"}],"responses":{"200":{"description":"Result (JSON; format=markdown returns { markdown })"},"404":{"description":"{ error }"}}}},"/api/tools/get_quotations":{"get":{"tags":["tools"],"operationId":"get_quotations","summary":"Where the New Testament quotes the Old, in either direction: give a New Testament book/chapter/verse for the Old Testament passages it quotes, or an Old Testament one for the New Testament passages that quote it. Pages with offset. Use when the user asks where the New Testament quotes the Old Testament, or the reverse.","parameters":[{"name":"reference","in":"query","required":true,"schema":{"type":"string"},"description":"e.g. 'Matthew', 'Hebrews 1', 'Psalm 110:1', 'Isaiah 53'"},{"name":"limit","in":"query","required":false,"schema":{"type":"number"},"description":"how many to return"},{"name":"offset","in":"query","required":false,"schema":{"type":"number"}},{"name":"max_chars","in":"query","required":false,"schema":{"type":"number"},"description":"optional: cap the answer at about this many characters (lists are shortened and marked truncated; use offset/nextOffset to get the rest)"},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["json","markdown"]},"description":"optional: json (default) or markdown (compact, readable)"}],"responses":{"200":{"description":"Result (JSON; format=markdown returns { markdown })"},"404":{"description":"{ error }"}}}},"/{page}.json":{"get":{"tags":["pages"],"summary":"Any chapter, book, word or list page as JSON (also .md and .txt, or Accept: application/json | text/markdown | text/plain)","parameters":[{"name":"page","in":"path","required":true,"schema":{"type":"string"},"example":"tanakh/psalms/23"}],"responses":{"200":{"description":"Page data"}}}},"/feeds/{feed}.xml":{"get":{"tags":["feeds"],"summary":"Atom feed of a reading schedule (also .json for JSON Feed, .ics for a calendar)","parameters":[{"name":"feed","in":"path","required":true,"schema":{"type":"string","enum":["torah-portion","besorah-portion","daily-psalms","mels-bible-study"]}}],"responses":{"200":{"description":"Feed"}}}},"/feeds/plan/{plan}.ics":{"get":{"tags":["feeds"],"summary":"A reading plan as a calendar, day 1 on the given start date","parameters":[{"name":"plan","in":"path","required":true,"schema":{"type":"string","enum":["torah60","wisdom90","gospels30","year"]}},{"name":"start","in":"query","schema":{"type":"string","format":"date"},"example":"2026-11-10"}],"responses":{"200":{"description":"iCalendar"}}}},"/feeds/besorah.opml":{"get":{"tags":["feeds"],"summary":"All feeds in one OPML file","responses":{"200":{"description":"OPML"}}}},"/mcp":{"post":{"tags":["discovery"],"summary":"Model Context Protocol (JSON-RPC over HTTP): tools get_passage, get_verse_study, search_text, search_words, get_word, get_word_occurrences, get_related_passages, get_cross_references, get_book_connections, list_books, list_songs, list_questions, get_targum_connections, get_parashah, get_guide, query_words, get_collocations, get_vocabulary, compare_books, get_context, trace_theme, compare_witnesses, get_quotations; resources; prompts"}}}}