Skip to main content
Glama

Fetch one search result in full

fetch
Read-onlyIdempotent

Fetch one item by the id a search returned. Full guide: living-bread://tools/fetch. Access: no sign-in; shared limit of 300 requests a minute per IP.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

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

Input Schema

NameRequiredDescriptionDefault
idYesAn id exactly as returned: verse:<ref>, need:<slug>, church:<uuid>, gathering.
detailNolean (default) or full evidence record.

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed25 schema fields changed
    • removedInput schema / $schema
      Removed value: -"http://json-schema.org/draft-07/schema#"
    • 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 / id / description
      Previous value: -"An id exactly as returned: verse:<ref>, need:<slug>, church:<uuid>, gathering:<uuid>, community:<uuid>, or lb:<kind>:<slug> (e.g. lb:denomination:methodism)."New value: +"An id exactly as returned: verse:<ref>, need:<slug>, church:<uuid>, gathering."
    • 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 / id
      Removed value: -{
      -  "description": "The id requested.",
      -  "type": "string"
      -}
    • 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 / metadata
      Removed value: -{
      -  "additionalProperties": {},
      -  "description": "Kind-specific facts plus attribution; unresolved when the id was not found.",
      -  "propertyNames": {
      -    "type": "string"
      -  },
      -  "type": "object"
      -}
    • 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 / text
      Removed value: -{
      -  "description": "The item in full as plain text (Scripture verbatim).",
      -  "type": "string"
      -}
    • removedOutput schema / properties / title
      Removed value: -{
      -  "description": "Item title.",
      -  "type": "string"
      -}
    • removedOutput schema / properties / url
      Removed value: -{
      -  "description": "Web page for the item.",
      -  "type": "string"
      -}
    • removedOutput schema / properties / visibility
      Removed value: -{
      -  "description": "\"public\" or \"yours\".",
      -  "type": "string"
      -}
    • removedOutput schema / required
      Removed value: -[
      -  "answered_by",
      -  "id",
      -  "title",
      -  "text",
      -  "url"
      -]
  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. Changed5 schema fields changed
    • changedInput schema / properties / id / description
      Previous value: -"An id exactly as returned: verse:<ref>, need:<slug>, church:<uuid>, gathering:<uuid>, community:<uuid>, or lb:<kind>:<slug> (e.g. lb:denomination:methodism, lb:church:colombia/iglesia-la-capuchina)."New value: +"An id exactly as returned: verse:<ref>, need:<slug>, church:<uuid>, gathering:<uuid>, community:<uuid>, or lb:<kind>:<slug> (e.g. lb:denomination:methodism)."
    • addedOutput schema / properties / answered_by
      Added value: +{
      +  "description": "The implementation that answered (the same tool name the signed-in endpoint lists).",
      +  "type": "string"
      +}
    • addedOutput schema / properties / ignored_params
      Added value: +{
      +  "description": "Parameters given that this mode does not use.",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • changedOutput schema / properties / metadata / description
      Previous value: -"Kind-specific facts (translation, verses, when_utc, has_passed, join_policy, sameAs) plus attribution; unresolved when the id was not found."New value: +"Kind-specific facts plus attribution; unresolved when the id was not found."
    • changedOutput schema / required
      Previous value: -[
      -  "id",
      -  "title",
      -  "text",
      -  "url"
      -]New value: +[
      +  "answered_by",
      +  "id",
      +  "title",
      +  "text",
      +  "url"
      +]
  4. Changed18 schema fields changed
    • addedInput schema / properties / id / description
      Added value: +"An id exactly as returned: verse:<ref>, need:<slug>, church:<uuid>, gathering:<uuid>, community:<uuid>, or lb:<kind>:<slug> (e.g. lb:denomination:methodism, lb:church:colombia/iglesia-la-capuchina)."
    • addedOutput schema / properties / attribution
      Added value: +{
      +  "description": "Credit line for the data: The Living Bread (living-bread.org).",
      +  "type": "string"
      +}
    • addedOutput schema / properties / content_flags
      Added value: +{
      +  "description": "[\"instruction_like_text_removed\"] when retrieved text was withheld.",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / content_layers
      Added value: +{
      +  "additionalProperties": {},
      +  "description": "Which fields are Scripture and which are human interpretation or reflection.",
      +  "properties": {},
      +  "type": "object"
      +}
    • addedOutput schema / properties / evidence
      Added value: +{
      +  "additionalProperties": {},
      +  "description": "Present when Scripture was read: translation, canon, corpus version, attribution, and a SHA-256 per passage.",
      +  "properties": {},
      +  "type": "object"
      +}
    • addedOutput schema / properties / freshness
      Added value: +{
      +  "additionalProperties": {},
      +  "description": "How current the answer is: kind (scheduled | recently_observed | verified_live | record), retrieved_at, available_now (true only when activity was verified live).",
      +  "properties": {},
      +  "type": "object"
      +}
    • addedOutput schema / properties / id / description
      Added value: +"The id requested."
    • addedOutput schema / properties / ids
      Added value: +{
      +  "description": "Up to 25 ids found in this answer, for follow-up calls.",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / license
      Added value: +{
      +  "description": "License URL of the returned data (CC BY 4.0 unless stated).",
      +  "type": "string"
      +}
    • addedOutput schema / properties / metadata / description
      Added value: +"Kind-specific facts (translation, verses, when_utc, has_passed, join_policy, sameAs) plus attribution; unresolved when the id was not found."
    • addedOutput schema / properties / next_actions
      Added value: +{
      +  "description": "Up to 4 links the person can open next.",
      +  "items": {
      +    "additionalProperties": {},
      +    "properties": {
      +      "label": {
      +        "type": "string"
      +      },
      +      "url": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "label",
      +      "url"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / ok
      Added value: +{
      +  "description": "Always true on a successful answer (errors come back as isError, never here).",
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / result_state
      Added value: +{
      +  "description": "\"empty\" when nothing matched (count 0, no results); the text then says so plainly.",
      +  "enum": [
      +    "useful",
      +    "empty"
      +  ],
      +  "type": "string"
      +}
    • addedOutput schema / properties / source_url
      Added value: +{
      +  "description": "The first public web page this answer came from or points to.",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / text / description
      Added value: +"The item in full as plain text (Scripture verbatim)."
    • addedOutput schema / properties / title / description
      Added value: +"Item title."
    • addedOutput schema / properties / url / description
      Added value: +"Web page for the item."
    • addedOutput schema / properties / visibility
      Added value: +{
      +  "description": "\"public\" for shared data, \"yours\" for the signed-in believer's own data.",
      +  "type": "string"
      +}
  5. First observed

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, non-destructive, open-world behavior, so the safety profile is covered. The description adds genuinely new operational context: no sign-in required and a shared 300 requests/minute per-IP limit, which an agent needs to avoid throttling. It omits whether the returned payload differs meaningfully between lean and full.

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?

Three short sentences, front-loaded with the action and then the constraints, with no filler. The guide URI is compact progressive disclosure rather than bloat, though it consumes a sentence of the limited space.

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?

With an output schema present, return values need no explanation, and the description covers purpose, authentication, and rate limits for a 2-parameter read tool. The only gap is not characterizing when to request `detail: full` versus lean, though the schema's descriptions cover that adequately.

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?

Schema coverage is 100%, so both `id` (with its verse:/need:/church:/gathering: formats) and the `detail` enum are fully documented in structured fields. The description only restates that the id comes from a search and adds no syntax or default behavior beyond the schema, so the baseline of 3 applies.

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?

States a specific verb (fetch) and resource (one item) and ties the input to 'the id a search returned', which cleanly separates it from the sibling `search` tool that produces those ids. It does not name an alternative explicitly, so it stops short of a 5.

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?

The phrase 'by the id a search returned' establishes the intended workflow: search first, then fetch by the returned id. No exclusions or when-not-to-use conditions are given, and the `detail` choice (lean vs full) is left to the schema rather than framed as a usage decision.

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