Reading the text

Which verse, chapter or book does the text actually contain, and how do translations differ? 11 Darash MCP tools, listed below with the exact description and input schema the server itself returns. Endpoint: https://darash-api.publifye.com/mcp. See [connect](../../../docs/connect.md) to get a key.

Tool What it does
get_verse Get verse(s) by reference
get_chapter Get entire chapter with all verses[END]
get_book Get entire book with all chapters and verses[END]
list_books List all 66 books of the Bible with chapters and testament
list_bibles List all 59 Bible translations with metadata (abbreviation, name, language, year)[END]
get_bible Get detailed metadata and complete structure for a Bible translation (books, chapters per…
compare_verses Compare the same verse across multiple Bible translations in one call
export_bible Export an entire Bible translation as structured JSON
export_bible_book Export a single book from a Bible translation as structured JSON
verse_to_position INVERSE of position_to_verse: given a Torah verse reference, return its exact letter-offset…
position_to_verse INVERSE OF els tool position-output: given a raw Torah LETTER OFFSET, return the verse…

get_verse

Get Verse — read-only, idempotent, closed-world.

Get verse(s) by reference. Supports single verse, verse range within chapter, or count-based cross-chapter fetching. Scripture interprets Scripture: follow a verse into get_cross_refs for its web of parallels, and into strongs_in_verse for the original words.[END]

Parameter Type Required Description
bible string yes Bible translation (e.g., 'kjv', 'asv', 'web')
count integer no Number of verses to fetch starting from ref. Enables cross-chapter reading (e.g., ref='John 3:16', count=25 returns through John 4:2). If omitted, uses range f…
ref string yes Verse reference (e.g., 'John 3:16', 'Gen 1:1-5')

get_chapter

Get Chapter — read-only, idempotent, closed-world.

Get entire chapter with all verses[END]

Parameter Type Required Description
bible string yes Bible translation
ref string yes Chapter reference (e.g., 'John 3', 'Genesis 1')

get_book

Get Book — read-only, idempotent, closed-world.

Get entire book with all chapters and verses[END]

Parameter Type Required Description
bible string yes Bible translation (e.g., 'kjv', 'asv', 'web')
book string yes Book name (e.g., 'Genesis', 'John', 'Psalms')

list_books

List Books — read-only, idempotent, closed-world.

List all 66 books of the Bible with chapters and testament. LEAN by default (id, name, abbr, chapters, testament, genre — no alias arrays, ~3x smaller); pass detail=full to include each book's alias list. Optionally specify language to get localized book names (38 languages available including greek, hebrew, norwegian, german, spanish, etc.). Pass an invalid language to see all available options.[END]

Parameter Type Required Description
detail string no Per-book detail: 'lean' (default, browse fields only) or 'full' (adds the aliases array — the abbreviation variants get_verse/get_chapter accept)
lang string no Language for book names (e.g., 'greek', 'hebrew', 'norwegian', 'german', 'spanish'). Also accepts 'language' as alias. Defaults to 'english'
language string no Alias for 'lang' parameter

list_bibles

List Bibles — read-only, idempotent, closed-world.

List all 59 Bible translations with metadata (abbreviation, name, language, year)[END]

get_bible

Get Bible — read-only, idempotent, closed-world.

Get detailed metadata and complete structure for a Bible translation (books, chapters per book, verses per chapter)[END]

Parameter Type Required Description
abbr string yes Bible abbreviation (e.g., 'kjv', 'asv', 'web')

compare_verses

Compare Verses — read-only, idempotent, closed-world.

Compare the same verse across multiple Bible translations in one call. Include 'kjs' for Strong's tagged text with clickable word study links. For Norwegian work nb2026 is the standard (Masoretic versification) — settle Norwegian usage against its text.[END]

Parameter Type Required Description
bibles string yes Comma-separated Bible translations to compare (e.g., 'kjv,asv,web,kjs')
ref string yes Verse reference (e.g., 'John 3:16', 'Gen 1:1')

export_bible

Export Bible — read-only, idempotent, closed-world.

Export an entire Bible translation as structured JSON. Returns a single-use download URL (expires in 10 minutes). Includes all available books (66 for full Bibles, 27 for NT-only like Vulgate). Output includes verse numbers: {"verse": 1, "text": "..."}.[END]

Parameter Type Required Description
bible string yes Bible translation abbreviation (e.g., 'kjv', 'asv', 'web', 'italian', 'vulgate')

export_bible_book

Export Bible Book — read-only, idempotent, closed-world.

Export a single book from a Bible translation as structured JSON. Returns a single-use download URL (expires in 5 minutes). Output includes verse numbers: {"verse": 1, "text": "..."}.[END]

Parameter Type Required Description
bible string yes Bible translation abbreviation (e.g., 'kjv', 'asv', 'web', 'italian', 'vulgate')
book string yes Book name (e.g., 'Genesis', 'John', 'Psalms', 'Revelation')

verse_to_position

Verse To Position — read-only, idempotent, closed-world.

INVERSE of position_to_verse: given a Torah verse reference, return its exact letter-offset window in the 304,805-letter Koren consonant text.

INPUT: ref = Torah verse like 'Genesis 32:11', 'Exodus 21:32', 'Deuteronomy 6:4'.
OUTPUT: { ref, book, book_name, chapter, verse, start_pos, length, end_pos, book_start_pos, pos_in_book, torah_length, text }
• start_pos = first letter of verse (Torah offset, 0-indexed)
• end_pos = exclusive end (= start_pos + length)
• text = Hebrew consonants of the entire verse

USE WHEN:
• You need the position window of a verse to check whether an ELS code passes through it.
• Filtering els_search results: keep matches whose start_pos falls within [start_pos, end_pos) of the target verse.
• Computing a multi-verse window (e.g., Gen 28:10..28:22): call once per endpoint and use [first.start_pos, last.end_pos).
• Pairing with trace_els_code or position_to_verse for letter-by-letter verification of a finding.

GUARANTEES: Torah-only (Genesis–Deuteronomy). Linear scan of the 5,847-entry verse index — sub-millisecond. Non-Torah books, missing verses, or unparseable refs return precise errors with the valid format example.

VERSIFICATION: the ref is read in KOREN numbering, which equals the Masoretic everywhere except Exodus 20 and Deuteronomy 5 (Koren merges the four short commandments, so its later verses run three lower). Those responses carry mt_equivalent + grid_note, and a Masoretic verse number the shorter Koren chapter lacks (e.g. Exodus 20:24) errors with the Koren verse it maps to.[END]

Parameter Type Required Description
ref string yes Torah verse reference (e.g., 'Genesis 32:11', 'Exodus 21:32'). Required. Must be Genesis–Deuteronomy.

position_to_verse

Position To Verse — read-only, idempotent, closed-world.

INVERSE OF els tool position-output: given a raw Torah LETTER OFFSET, return the verse containing it plus exact verse boundaries and surrounding context.

INPUT: pos = 0-indexed letter position in the Koren Torah (304,805 Hebrew consonants total). Range 0..304804.
pos=0 → first letter of Genesis 1:1 (ב of בראשית)
pos=78064 → first letter of Exodus 1:1
pos=141593 → first letter of Leviticus 1:1
pos=186383 → first letter of Numbers 1:1
pos=249913 → first letter of Deuteronomy 1:1
pos=304804 → last letter of Deuteronomy 34:12

OUTPUT: { pos, letter, book (1-5), book_name, chapter, verse, ref, verse_start_pos, verse_length, verse_end_pos, offset_in_verse, book_start_pos, pos_in_book, torah_length, surface_word, target, versification }

VERSIFICATION: verse numbers are the KOREN letter grid, which equals the Masoretic numbering everywhere EXCEPT Exodus 20 and Deuteronomy 5, where Koren merges the four short commandments into one verse and every later verse sits three lower than the Masoretic. In those two chapters the response adds mt_equivalent and grid_note so a Koren ref is never silently taken for a Masoretic one.

USE WHEN:
• You have a start_pos from els_search/els_discover/els_verse_codes and want the canonical verse + offset.
• Annotating each letter of an ELS sequence (start_pos, start_pos+skip, start_pos+2*skip, ...) with where it lands.
• Rendering or debugging grid coordinates back to chapter:verse.
• Confirming whether a position falls 'inside' a target verse for proximity analysis.

GUARANTEES: O(log N) binary search over the 5,847-verse index. Always returns the exact verse — no clamping, no fallback. Out-of-range positions return a precise error explaining the valid range.

This is a Torah-only tool: positions are letter offsets in the Koren consonant text. For non-Torah books, parse a reference string with get_verse instead. The companion els_verse_codes / els_verse_signal tools take a reference and return positions; this tool reverses that mapping.[END]

Parameter Type Required Description
pos integer yes 0-indexed letter position in the Koren Torah (range 0..304804). Required. Examples: 0 (first letter of Genesis 1:1), 78064 (start of Exodus), 304804 (last lett…
target string no Which Torah text to read the letter from: 'real' (default — actual Koren Torah) or 'shuffled' (deterministically-shuffled control). Verse boundaries are identi…

Generated from the live tools/list on 2026-09-13. Regenerate rather than edit by hand.

Generated from the live service's own tools/list — not written by hand, so it cannot drift from what Darash actually answers. Source on GitHub

Questions about Darash

What people use it for

让我的主日讲章切实建立在经文的实际字句上。

没问题。您的助手会使用 verse_study 获取经文、其标注的原文字词、语法解析及交叉引用,然后通过 strongs_in_verse 验证准备讨论的具体词汇。word_study 则会返回该 Strong’s 编码对应的词典条目、用法和词源。在确立讲道观点之前,您可以亲自查验这些依据;助手必须将检索到的词典数据与其自身阐释清晰区分开来。

Ask your AI
显示罗马书 8:26 背后的希腊文、其语法解析以及明确标注的词典条目。
What it does
  • verse_study
  • strongs_in_verse
  • word_study
What you get
经文文本、标注的原文字词、语法解析以及明确标注的词典出处。
在我围绕希腊文构建讲道观点之前,先核对原文词汇。

没问题。strongs_in_verse 会列出每节经文中带有 Strong’s 编码的原文字词。您的助手可以展示每个位置出现的具体编码,并在对比词义之前打开对应的词典条目,而不是凭记忆或英文译本去揣测希腊文。

Ask your AI
对比约翰福音 21:15 和 21:17 中表示“爱”的希腊文字词。
What it does
  • strongs_in_verse
  • get_strongs
  • get_synonyms
What you get
每节经文中实际标注的词汇及其词典条目。
帮我根据这段经文准备一堂希腊文语法解析课。

没问题。Darash 能逐节提供语法解析和词典数据,您的助手则可以将其排版成学生作业练习纸和参考答案。对每节经文使用 get_morphology,对重点词汇使用 word_study;练习纸本身由您的助手整理生成。

Ask your AI
提供腓立比书 2:5–8 的动词及语法解析,用于制作练习纸。
What it does
  • get_verse
  • get_morphology
  • word_study
What you get
语法解析数据与词典条目,供我的 AI 整理成练习纸。
对比不同译本在同一节经文中的表述。

没问题。首先使用 list_bibles 查看所连接服务中可用的译本及其标识符(包括收录的挪威语、波斯语和拉丁语文本)。compare_verses 会并排返回所选译本的内容,以便您的助手准确引用检索到的经文。

Ask your AI
在我挑选的可用译本中并排显示诗篇 23:4。
What it does
  • list_bibles
  • compare_verses
What you get
检索到的各译本经文并排对照,每项均标明来源。
协助我为正在撰写的书研究一个主题。

没问题。文本搜索可以找到匹配的经文,get_cross_refs 能检索其自带的交叉引用,而 multi_dict_lookup 则能从词典中提取主题条目。您的助手可以将返回的依据整理为研究笔记并注明每个出处;请注意,单次搜索并不能保证穷尽该主题下的所有经文。

Ask your AI
查找旷野相关的经文、交叉引用以及具名的词典词条。
What it does
search → get_cross_refs → multi_dict_lookup
What you get
匹配的经文、预设的交叉引用以及注明出处的主题条目。
让我的个人圣经研读智能体学会核对资料来源。

没问题。支持 MCP 的个人研读智能体可以调用 Darash 获取经文,使用 strongs_in_verse 核对标注词汇,并通过 word_study 查阅具名的词典来源。引用时请注明版本和已知缺失。请注意,若要通过应用、机器人或在线服务向其他用户提供 Darash 或其输出内容,需要单独获得相应许可;个人访问权限不包含此类用途。

Ask your AI
比对 Darash 核实每一个希腊文或希伯来文论断,并引用对应条目。
What it does
  • get_verse
  • strongs_in_verse
  • word_study
What you get
供我的智能体直接引用并注明出处的原文文本与词典数据。

All questions