Skip to main content
Glama

Read Scripture word for word from a stored text

read_scripture
Read-onlyIdempotent

Read the Bible word for word from a stored text, never from memory. Modes: passage, context, search, compare, original_words, cross_references, verify, translations, which_translation, languages, explained. Use when you know the reference or the words. Example: {mode:"passage", reference:"John 3:16"}. Full guide: living-bread://tools/read_scripture. Access: no sign-in; shared limit of 300 requests a minute per IP.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "read_scripture"
  }
}

Input Schema

NameRequiredDescriptionDefault
bookNoFor search. One book.
modeNoThe kind of answer. Leave out for a guide to the modes.
needNoFor which_translation: what the reader needs.
limitNoPage size.
queryNoFor search: words that must all appear ("mercy truth"), or an exact phrase in double quotes.
quoteNoFor verify: the exact words to check, as they would be quoted.
aroundNoFor context. Verses either side.
cursorNonext_cursor from the last answer.
detailNolean (default) or full evidence record.
strongNoFor original_words. Strong's number, e.g. G25.
languageNoBCP-47 language code.
parallelNoFor search. Translation id beside each verse.
referenceNoBook, chapter and optional verse or range as a reader writes it: "John 3:16", "Psalm 23", "1 Cor 13:4-7".
testamentNoFor search. old or new.
translationNoTranslation id (mode translations lists them).
whole_wordsNoFor search. Whole words only (default).
include_textNoFor cross_references. Read each linked passage.
translationsNoFor compare. Translation ids to compare.
include_originalNoFor compare. Add Hebrew or Greek.
include_license_textNoFor translations. Full license statements.

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed38 schema fields changed
    • removedInput schema / $schema
      Removed value: -"http://json-schema.org/draft-07/schema#"
    • changedInput schema / properties / around / description
      Previous value: -"For context: verses to read on each side (default 2)."New value: +"For context. Verses either side."
    • changedInput schema / properties / book / description
      Previous value: -"For search: one book to search, e.g. \"Psalms\", \"1 Cor\"."New value: +"For search. One book."
    • changedInput schema / properties / cursor / description
      Previous value: -"Opaque paging token: next_cursor from the previous answer of the same call. Omit for the first page."New value: +"next_cursor from the last answer."
    • changedInput schema / properties / detail / description
      Previous value: -"lean (default): the answer, its credit and one door. full: the complete evidence record (per-passage hashes, canon, layers)."New value: +"lean (default) or full evidence record."
    • changedInput schema / properties / include_license_text / description
      Previous value: -"For translations: true returns each license statement in full."New value: +"For translations. Full license statements."
    • changedInput schema / properties / include_original / description
      Previous value: -"For compare: true (default) adds the Hebrew or Greek line."New value: +"For compare. Add Hebrew or Greek."
    • changedInput schema / properties / include_text / description
      Previous value: -"For cross_references: true (default) reads each linked passage; false returns references and votes only."New value: +"For cross_references. Read each linked passage."
    • changedInput schema / properties / language / description
      Previous value: -"The person's BCP-47 language, e.g. \"es\", \"pt-BR\", \"sw\". Picks the best stored public domain or freely licensed Bible for it; translation wins over it."New value: +"BCP-47 language code."
    • changedInput schema / properties / limit / description
      Previous value: -"For search (page size, default 10, max 20) and cross_references (default 6, max 12)."New value: +"Page size."
    • changedInput schema / properties / mode / description
      Previous value: -"Which kind of answer: passage, context, search, compare, original_words, cross_references, verify, translations, which_translation, languages, explained. Each mode, and the parameters it needs, is explained in the description. Leave it out and the answer says what each mode is for."New value: +"The kind of answer. Leave out for a guide to the modes."
    • changedInput schema / properties / need / description
      Previous value: -"For which_translation: what the reader needs, in a few words or one of first_time, study, memorize, children, listen, free, spanish, portuguese (default first_time)."New value: +"For which_translation: what the reader needs."
    • changedInput schema / properties / parallel / description
      Previous value: -"For search: a translation id read beside each verse found, e.g. \"kjv\"."New value: +"For search. Translation id beside each verse."
    • changedInput schema / properties / query / description
      Previous value: -"For search: words that must all appear (\"mercy truth\"), or an exact phrase in double quotes. Case-insensitive."New value: +"For search: words that must all appear (\"mercy truth\"), or an exact phrase in double quotes."
    • changedInput schema / properties / reference / description
      Previous value: -"Book, chapter and optional verse or range as a reader writes it: \"John 3:16\", \"Psalm 23\", \"1 Cor 13:4-7\". Required for passage, context, compare, original_words and cross_references; optional for verify (the reference the words are attributed to)."New value: +"Book, chapter and optional verse or range as a reader writes it: \"John 3:16\", \"Psalm 23\", \"1 Cor 13:4-7\"."
    • changedInput schema / properties / strong / description
      Previous value: -"For original_words: keep only the words with this Strong's number, e.g. \"G25\" or \"H1254\"."New value: +"For original_words. Strong's number, e.g. G25."
    • changedInput schema / properties / testament / description
      Previous value: -"For search: \"old\" or \"new\" to search one testament."New value: +"For search. old or new."
    • changedInput schema / properties / translation / description
      Previous value: -"A stored translation id from read_scripture mode translations, e.g. \"bsb\", \"web\", \"dra\", \"rv1909\", \"cuv\". Default: the King James Version, or the best stored Bible for language."New value: +"Translation id (mode translations lists them)."
    • changedInput schema / properties / translations / description
      Previous value: -"For compare: up to six translation ids, e.g. [\"kjv\",\"bsb\",\"dra\",\"rv1909\"]."New value: +"For compare. Translation ids to compare."
    • changedInput schema / properties / whole_words / description
      Previous value: -"For search: true (default) matches whole words only; false matches inside words."New value: +"For search. Whole words only (default)."
    • removedOutput schema / $schema
      Removed value: -"http://json-schema.org/draft-07/schema#"
    • removedOutput schema / properties / answered_by
      Removed value: -{
      -  "description": "The implementation that answered (the same tool name the signed-in endpoint lists).",
      -  "type": "string"
      -}
    • removedOutput schema / properties / attribution
      Removed value: -{
      -  "description": "Credit: The Living Bread (living-bread.org).",
      -  "type": "string"
      -}
    • removedOutput schema / properties / content_flags
      Removed value: -{
      -  "description": "Set when retrieved text was withheld.",
      -  "items": {
      -    "type": "string"
      -  },
      -  "type": "array"
      -}
    • removedOutput schema / properties / content_layers
      Removed value: -{
      -  "additionalProperties": {},
      -  "description": "full detail: Scripture versus interpretation versus reflection.",
      -  "properties": {},
      -  "type": "object"
      -}
    • removedOutput schema / properties / evidence
      Removed value: -{
      -  "additionalProperties": {},
      -  "description": "When Scripture was read: translation, license, attribution, corpus version (full detail adds hashes and canon).",
      -  "properties": {},
      -  "type": "object"
      -}
    • removedOutput schema / properties / freshness
      Removed value: -{
      -  "additionalProperties": {},
      -  "description": "kind, retrieved_at, available_now (true only when verified live).",
      -  "properties": {},
      -  "type": "object"
      -}
    • removedOutput schema / properties / ids
      Removed value: -{
      -  "description": "Up to 25 ids in this answer.",
      -  "items": {
      -    "type": "string"
      -  },
      -  "type": "array"
      -}
    • removedOutput schema / properties / ignored_params
      Removed value: -{
      -  "description": "Parameters given that this mode does not use.",
      -  "items": {
      -    "type": "string"
      -  },
      -  "type": "array"
      -}
    • removedOutput schema / properties / license
      Removed value: -{
      -  "description": "License URL (CC BY 4.0 unless stated).",
      -  "type": "string"
      -}
    • removedOutput schema / properties / mode
      Removed value: -{
      -  "description": "The mode that answered.",
      -  "type": "string"
      -}
    • removedOutput schema / properties / next_actions
      Removed value: -{
      -  "description": "Links to open next.",
      -  "items": {
      -    "additionalProperties": {},
      -    "properties": {
      -      "label": {
      -        "type": "string"
      -      },
      -      "url": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "label",
      -      "url"
      -    ],
      -    "type": "object"
      -  },
      -  "type": "array"
      -}
    • removedOutput schema / properties / ok
      Removed value: -{
      -  "description": "Always true on success.",
      -  "type": "boolean"
      -}
    • removedOutput schema / properties / result_state
      Removed value: -{
      -  "description": "\"empty\" when nothing matched.",
      -  "enum": [
      -    "useful",
      -    "empty"
      -  ],
      -  "type": "string"
      -}
    • removedOutput schema / properties / scripture_fields
      Removed value: -{
      -  "description": "Which fields are Scripture (all else is the house's own words).",
      -  "items": {
      -    "type": "string"
      -  },
      -  "type": "array"
      -}
    • removedOutput schema / properties / source_url
      Removed value: -{
      -  "description": "A public page of The Living Bread this answer came from.",
      -  "type": [
      -    "string",
      -    "null"
      -  ]
      -}
    • removedOutput schema / properties / visibility
      Removed value: -{
      -  "description": "\"public\" or \"yours\".",
      -  "type": "string"
      -}
    • removedOutput schema / required
      Removed value: -[
      -  "mode",
      -  "answered_by"
      -]
  2. Changed14 schema fields changed
    • addedInput schema / properties / detail
      Added value: +{
      +  "description": "lean (default): the answer, its credit and one door. full: the complete evidence record (per-passage hashes, canon, layers).",
      +  "enum": [
      +    "lean",
      +    "full"
      +  ],
      +  "type": "string"
      +}
    • changedOutput schema / properties / attribution / description
      Previous value: -"Credit line for the data: The Living Bread (living-bread.org)."New value: +"Credit: The Living Bread (living-bread.org)."
    • changedOutput schema / properties / content_flags / description
      Previous value: -"[\"instruction_like_text_removed\"] when retrieved text was withheld."New value: +"Set when retrieved text was withheld."
    • changedOutput schema / properties / content_layers / description
      Previous value: -"Which fields are Scripture and which are human interpretation or reflection."New value: +"full detail: Scripture versus interpretation versus reflection."
    • changedOutput schema / properties / evidence / description
      Previous value: -"Present when Scripture was read: translation, canon, corpus version, attribution, and a SHA-256 per passage."New value: +"When Scripture was read: translation, license, attribution, corpus version (full detail adds hashes and canon)."
    • changedOutput schema / properties / freshness / description
      Previous value: -"How current the answer is: kind (scheduled | recently_observed | verified_live | record), retrieved_at, available_now (true only when activity was verified live)."New value: +"kind, retrieved_at, available_now (true only when verified live)."
    • changedOutput schema / properties / ids / description
      Previous value: -"Up to 25 ids found in this answer, for follow-up calls."New value: +"Up to 25 ids in this answer."
    • changedOutput schema / properties / license / description
      Previous value: -"License URL of the returned data (CC BY 4.0 unless stated)."New value: +"License URL (CC BY 4.0 unless stated)."
    • changedOutput schema / properties / next_actions / description
      Previous value: -"Up to 4 links the person can open next."New value: +"Links to open next."
    • changedOutput schema / properties / ok / description
      Previous value: -"Always true on a successful answer (errors come back as isError, never here)."New value: +"Always true on success."
    • changedOutput schema / properties / result_state / description
      Previous value: -"\"empty\" when nothing matched (count 0, no results); the text then says so plainly."New value: +"\"empty\" when nothing matched."
    • addedOutput schema / properties / scripture_fields
      Added value: +{
      +  "description": "Which fields are Scripture (all else is the house's own words).",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • changedOutput schema / properties / source_url / description
      Previous value: -"The first public web page this answer came from or points to."New value: +"A public page of The Living Bread this answer came from."
    • changedOutput schema / properties / visibility / description
      Previous value: -"\"public\" for shared data, \"yours\" for the signed-in believer's own data."New value: +"\"public\" or \"yours\"."
  3. Changed2 schema fields changed
    • changedInput schema / properties / mode / description
      Previous value: -"Which kind of answer: passage, context, search, compare, original_words, cross_references, verify, translations, which_translation, languages. Each mode, and the parameters it needs, is explained in the description. Leave it out and the answer says what each mode is for."New value: +"Which kind of answer: passage, context, search, compare, original_words, cross_references, verify, translations, which_translation, languages, explained. Each mode, and the parameters it needs, is explained in the description. Leave it out and the answer says what each mode is for."
    • changedInput schema / properties / mode / enum
      Previous value: -[
      -  "passage",
      -  "context",
      -  "search",
      -  "compare",
      -  "original_words",
      -  "cross_references",
      -  "verify",
      -  "translations",
      -  "which_translation",
      -  "languages"
      -]New value: +[
      +  "passage",
      +  "context",
      +  "search",
      +  "compare",
      +  "original_words",
      +  "cross_references",
      +  "verify",
      +  "translations",
      +  "which_translation",
      +  "languages",
      +  "explained"
      +]
  4. Changed2 schema fields changed
    • changedInput schema / properties / mode / description
      Previous value: -"Which kind of answer: passage, context, search, compare, original_words, cross_references, verify, translations, which_translation, languages. Each mode, and the parameters it needs, is explained in the description."New value: +"Which kind of answer: passage, context, search, compare, original_words, cross_references, verify, translations, which_translation, languages. Each mode, and the parameters it needs, is explained in the description. Leave it out and the answer says what each mode is for."
    • removedInput schema / required
      Removed value: -[
      -  "mode"
      -]
  5. Changed3 schema fields changed
    • changedInput schema / properties / mode / description
      Previous value: -"Which kind of answer: passage, context, search, compare, original_words, cross_references, verify, translations, languages. Each mode, and the parameters it needs, is explained in the description."New value: +"Which kind of answer: passage, context, search, compare, original_words, cross_references, verify, translations, which_translation, languages. Each mode, and the parameters it needs, is explained in the description."
    • changedInput schema / properties / mode / enum
      Previous value: -[
      -  "passage",
      -  "context",
      -  "search",
      -  "compare",
      -  "original_words",
      -  "cross_references",
      -  "verify",
      -  "translations",
      -  "languages"
      -]New value: +[
      +  "passage",
      +  "context",
      +  "search",
      +  "compare",
      +  "original_words",
      +  "cross_references",
      +  "verify",
      +  "translations",
      +  "which_translation",
      +  "languages"
      +]
    • addedInput schema / properties / need
      Added value: +{
      +  "description": "For which_translation: what the reader needs, in a few words or one of first_time, study, memorize, children, listen, free, spanish, portuguese (default first_time).",
      +  "maxLength": 80,
      +  "type": "string"
      +}
  6. Changed2 schema fields changed
    • changedInput schema / properties / mode / description
      Previous value: -"Which kind of answer: passage, context, search, compare, original_words, cross_references, verify, translations. Each mode, and the parameters it needs, is explained in the description."New value: +"Which kind of answer: passage, context, search, compare, original_words, cross_references, verify, translations, languages. Each mode, and the parameters it needs, is explained in the description."
    • changedInput schema / properties / mode / enum
      Previous value: -[
      -  "passage",
      -  "context",
      -  "search",
      -  "compare",
      -  "original_words",
      -  "cross_references",
      -  "verify",
      -  "translations"
      -]New value: +[
      +  "passage",
      +  "context",
      +  "search",
      +  "compare",
      +  "original_words",
      +  "cross_references",
      +  "verify",
      +  "translations",
      +  "languages"
      +]
  7. Added

TDQS

A3.9/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnly, idempotent, open-world, and non-destructive behavior. The description adds genuinely useful operational context beyond them: no sign-in required and a shared 300 requests/minute per IP limit. It also guarantees the text comes from storage rather than memory. It does not elaborate on paging behavior, though the output schema covers return values.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is compact and front-loads the core guarantee and usage condition. The mode list partially duplicates the schema enum but serves as an at-a-glance capability summary. The guide link and access constraints are useful and efficiently stated.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given 20 parameters, an output schema, and rich annotations, the description provides strong context: capability modes, when to use, a call example, access limits, and a pointer to the full guide. It does not attempt to map every parameter to its mode, but the schema handles that. Nothing critical for correct invocation is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With 20 parameters and 100% schema description coverage, the schema already explains each parameter's purpose and mode-specific applicability. The description redundantly lists the mode enum and gives one passing example, adding only marginal semantic value. Baseline 3 is appropriate when structured fields do the heavy lifting.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb and resource: reading the Bible word for word from a stored text, not from memory. It enumerates the eleven modes, which makes the tool's scope concrete. However, it does not explicitly distinguish this tool from siblings like `search` or `find_scripture_for`, leaving the agent to infer the boundary.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives a clear usage condition: 'Use when you know the reference or the words,' which correctly routes reference-based and quote-based lookups here. An inline example reinforces the expected call shape. It does not name alternative tools or state when not to use it, so it stops short of full routing guidance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources