Skip to main content
Glama

Urantia Papers

Get Paragraph with Context

paragraphs.context
Read-onlyIdempotent

Get a paragraph with surrounding context (N paragraphs before and after within the same paper). Useful for understanding passages in context.

Input Schema

NameRequiredDescriptionDefault
refYesParagraph reference. Examples: "1:2.0.1", "2:0.1", "2.0.1"
langNoLanguage of the text and titles. "es" gives the Spanish translation (an AI translation, CC0); each paragraph then has `language` and a `translation` label. Default "eng".eng
windowNoNumber of paragraphs before and after (1-10, default 2)
include_entitiesNoInclude entity mentions

Output Schema

NameRequiredDescriptionDefault
afterYes
beforeYes
targetYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / lang / description
      Previous value: -"Language of the text and titles. \"es\" gives the Spanish translation (a machine translation, CC0); each paragraph then has `language` and a `translation` label. Default \"eng\"."New value: +"Language of the text and titles. \"es\" gives the Spanish translation (an AI translation, CC0); each paragraph then has `language` and a `translation` label. Default \"eng\"."
  2. Changed7 schema fields changed
    • addedInput schema / properties / lang
      Added value: +{
      +  "default": "eng",
      +  "description": "Language of the text and titles. \"es\" gives the Spanish translation (a machine translation, CC0); each paragraph then has `language` and a `translation` label. Default \"eng\".",
      +  "enum": [
      +    "eng",
      +    "es"
      +  ],
      +  "type": "string"
      +}
    • addedOutput schema / properties / after / items / properties / language
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / after / items / properties / translation
      Added value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "license": {
      +      "const": "CC0-1.0",
      +      "type": "string"
      +    },
      +    "method": {
      +      "const": "machine",
      +      "type": "string"
      +    },
      +    "review": {
      +      "anyOf": [
      +        {
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    }
      +  },
      +  "required": [
      +    "method",
      +    "license",
      +    "review"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / before / items / properties / language
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / before / items / properties / translation
      Added value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "license": {
      +      "const": "CC0-1.0",
      +      "type": "string"
      +    },
      +    "method": {
      +      "const": "machine",
      +      "type": "string"
      +    },
      +    "review": {
      +      "anyOf": [
      +        {
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    }
      +  },
      +  "required": [
      +    "method",
      +    "license",
      +    "review"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / target / properties / language
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / target / properties / translation
      Added value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "license": {
      +      "const": "CC0-1.0",
      +      "type": "string"
      +    },
      +    "method": {
      +      "const": "machine",
      +      "type": "string"
      +    },
      +    "review": {
      +      "anyOf": [
      +        {
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    }
      +  },
      +  "required": [
      +    "method",
      +    "license",
      +    "review"
      +  ],
      +  "type": "object"
      +}
  3. Changed9 schema fields changed
    • removedOutput schema / properties / after / items / properties / audio
      Removed value: -{}
    • removedOutput schema / properties / after / items / properties / htmlText
      Removed value: -{
      -  "type": "string"
      -}
    • changedOutput schema / properties / after / items / required
      Previous value: -[
      -  "id",
      -  "standardReferenceId",
      -  "sortId",
      -  "paperId",
      -  "sectionId",
      -  "partId",
      -  "paperTitle",
      -  "sectionTitle",
      -  "paragraphId",
      -  "text",
      -  "htmlText",
      -  "labels",
      -  "audio"
      -]New value: +[
      +  "id",
      +  "standardReferenceId",
      +  "sortId",
      +  "paperId",
      +  "sectionId",
      +  "partId",
      +  "paperTitle",
      +  "sectionTitle",
      +  "paragraphId",
      +  "text",
      +  "labels"
      +]
    • removedOutput schema / properties / before / items / properties / audio
      Removed value: -{}
    • removedOutput schema / properties / before / items / properties / htmlText
      Removed value: -{
      -  "type": "string"
      -}
    • changedOutput schema / properties / before / items / required
      Previous value: -[
      -  "id",
      -  "standardReferenceId",
      -  "sortId",
      -  "paperId",
      -  "sectionId",
      -  "partId",
      -  "paperTitle",
      -  "sectionTitle",
      -  "paragraphId",
      -  "text",
      -  "htmlText",
      -  "labels",
      -  "audio"
      -]New value: +[
      +  "id",
      +  "standardReferenceId",
      +  "sortId",
      +  "paperId",
      +  "sectionId",
      +  "partId",
      +  "paperTitle",
      +  "sectionTitle",
      +  "paragraphId",
      +  "text",
      +  "labels"
      +]
    • removedOutput schema / properties / target / properties / audio
      Removed value: -{}
    • removedOutput schema / properties / target / properties / htmlText
      Removed value: -{
      -  "type": "string"
      -}
    • changedOutput schema / properties / target / required
      Previous value: -[
      -  "id",
      -  "standardReferenceId",
      -  "sortId",
      -  "paperId",
      -  "sectionId",
      -  "partId",
      -  "paperTitle",
      -  "sectionTitle",
      -  "paragraphId",
      -  "text",
      -  "htmlText",
      -  "labels",
      -  "audio"
      -]New value: +[
      +  "id",
      +  "standardReferenceId",
      +  "sortId",
      +  "paperId",
      +  "sectionId",
      +  "partId",
      +  "paperTitle",
      +  "sectionTitle",
      +  "paragraphId",
      +  "text",
      +  "labels"
      +]
  4. Changed6 schema fields changed
    • addedOutput schema / properties / after / items / properties / bibleParallels
      Added value: +{
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "bookCode": {
      +        "type": "string"
      +      },
      +      "chapter": {
      +        "maximum": 9007199254740991,
      +        "minimum": -9007199254740991,
      +        "type": "integer"
      +      },
      +      "chunkId": {
      +        "type": "string"
      +      },
      +      "embeddingModel": {
      +        "type": "string"
      +      },
      +      "rank": {
      +        "maximum": 9007199254740991,
      +        "minimum": -9007199254740991,
      +        "type": "integer"
      +      },
      +      "reference": {
      +        "type": "string"
      +      },
      +      "similarity": {
      +        "type": "number"
      +      },
      +      "source": {
      +        "type": "string"
      +      },
      +      "text": {
      +        "type": "string"
      +      },
      +      "verseEnd": {
      +        "maximum": 9007199254740991,
      +        "minimum": -9007199254740991,
      +        "type": "integer"
      +      },
      +      "verseStart": {
      +        "maximum": 9007199254740991,
      +        "minimum": -9007199254740991,
      +        "type": "integer"
      +      }
      +    },
      +    "required": [
      +      "chunkId",
      +      "reference",
      +      "bookCode",
      +      "chapter",
      +      "verseStart",
      +      "verseEnd",
      +      "text",
      +      "similarity",
      +      "rank",
      +      "source",
      +      "embeddingModel"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / after / items / properties / urantiaParallels
      Added value: +{
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "embeddingModel": {
      +        "type": "string"
      +      },
      +      "id": {
      +        "type": "string"
      +      },
      +      "paperId": {
      +        "type": "string"
      +      },
      +      "paperTitle": {
      +        "type": "string"
      +      },
      +      "rank": {
      +        "maximum": 9007199254740991,
      +        "minimum": -9007199254740991,
      +        "type": "integer"
      +      },
      +      "sectionTitle": {
      +        "anyOf": [
      +          {
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "similarity": {
      +        "type": "number"
      +      },
      +      "source": {
      +        "type": "string"
      +      },
      +      "standardReferenceId": {
      +        "type": "string"
      +      },
      +      "text": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "id",
      +      "standardReferenceId",
      +      "paperId",
      +      "paperTitle",
      +      "sectionTitle",
      +      "text",
      +      "similarity",
      +      "rank",
      +      "source",
      +      "embeddingModel"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / before / items / properties / bibleParallels
      Added value: +{
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "bookCode": {
      +        "type": "string"
      +      },
      +      "chapter": {
      +        "maximum": 9007199254740991,
      +        "minimum": -9007199254740991,
      +        "type": "integer"
      +      },
      +      "chunkId": {
      +        "type": "string"
      +      },
      +      "embeddingModel": {
      +        "type": "string"
      +      },
      +      "rank": {
      +        "maximum": 9007199254740991,
      +        "minimum": -9007199254740991,
      +        "type": "integer"
      +      },
      +      "reference": {
      +        "type": "string"
      +      },
      +      "similarity": {
      +        "type": "number"
      +      },
      +      "source": {
      +        "type": "string"
      +      },
      +      "text": {
      +        "type": "string"
      +      },
      +      "verseEnd": {
      +        "maximum": 9007199254740991,
      +        "minimum": -9007199254740991,
      +        "type": "integer"
      +      },
      +      "verseStart": {
      +        "maximum": 9007199254740991,
      +        "minimum": -9007199254740991,
      +        "type": "integer"
      +      }
      +    },
      +    "required": [
      +      "chunkId",
      +      "reference",
      +      "bookCode",
      +      "chapter",
      +      "verseStart",
      +      "verseEnd",
      +      "text",
      +      "similarity",
      +      "rank",
      +      "source",
      +      "embeddingModel"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / before / items / properties / urantiaParallels
      Added value: +{
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "embeddingModel": {
      +        "type": "string"
      +      },
      +      "id": {
      +        "type": "string"
      +      },
      +      "paperId": {
      +        "type": "string"
      +      },
      +      "paperTitle": {
      +        "type": "string"
      +      },
      +      "rank": {
      +        "maximum": 9007199254740991,
      +        "minimum": -9007199254740991,
      +        "type": "integer"
      +      },
      +      "sectionTitle": {
      +        "anyOf": [
      +          {
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "similarity": {
      +        "type": "number"
      +      },
      +      "source": {
      +        "type": "string"
      +      },
      +      "standardReferenceId": {
      +        "type": "string"
      +      },
      +      "text": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "id",
      +      "standardReferenceId",
      +      "paperId",
      +      "paperTitle",
      +      "sectionTitle",
      +      "text",
      +      "similarity",
      +      "rank",
      +      "source",
      +      "embeddingModel"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / target / properties / bibleParallels
      Added value: +{
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "bookCode": {
      +        "type": "string"
      +      },
      +      "chapter": {
      +        "maximum": 9007199254740991,
      +        "minimum": -9007199254740991,
      +        "type": "integer"
      +      },
      +      "chunkId": {
      +        "type": "string"
      +      },
      +      "embeddingModel": {
      +        "type": "string"
      +      },
      +      "rank": {
      +        "maximum": 9007199254740991,
      +        "minimum": -9007199254740991,
      +        "type": "integer"
      +      },
      +      "reference": {
      +        "type": "string"
      +      },
      +      "similarity": {
      +        "type": "number"
      +      },
      +      "source": {
      +        "type": "string"
      +      },
      +      "text": {
      +        "type": "string"
      +      },
      +      "verseEnd": {
      +        "maximum": 9007199254740991,
      +        "minimum": -9007199254740991,
      +        "type": "integer"
      +      },
      +      "verseStart": {
      +        "maximum": 9007199254740991,
      +        "minimum": -9007199254740991,
      +        "type": "integer"
      +      }
      +    },
      +    "required": [
      +      "chunkId",
      +      "reference",
      +      "bookCode",
      +      "chapter",
      +      "verseStart",
      +      "verseEnd",
      +      "text",
      +      "similarity",
      +      "rank",
      +      "source",
      +      "embeddingModel"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / target / properties / urantiaParallels
      Added value: +{
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "embeddingModel": {
      +        "type": "string"
      +      },
      +      "id": {
      +        "type": "string"
      +      },
      +      "paperId": {
      +        "type": "string"
      +      },
      +      "paperTitle": {
      +        "type": "string"
      +      },
      +      "rank": {
      +        "maximum": 9007199254740991,
      +        "minimum": -9007199254740991,
      +        "type": "integer"
      +      },
      +      "sectionTitle": {
      +        "anyOf": [
      +          {
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "similarity": {
      +        "type": "number"
      +      },
      +      "source": {
      +        "type": "string"
      +      },
      +      "standardReferenceId": {
      +        "type": "string"
      +      },
      +      "text": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "id",
      +      "standardReferenceId",
      +      "paperId",
      +      "paperTitle",
      +      "sectionTitle",
      +      "text",
      +      "similarity",
      +      "rank",
      +      "source",
      +      "embeddingModel"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
  5. First observed

TDQS

A3.8/5.0
Behavior4/5

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

Annotations already cover read-only, idempotent, non-destructive, and closed-world, so the safety profile is done. The description adds a genuine behavioral constraint not in the annotations: context is bounded 'within the same paper', meaning the window truncates at paper edges rather than pulling in neighbouring papers.

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?

Two short sentences with the core behavior front-loaded. The trailing clause 'Useful for understanding passages in context' is slightly redundant with 'with surrounding context' but is not costly.

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

Completeness5/5

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

An output schema exists so return shape needn't be explained, all parameters are fully described in the schema, and annotations carry the safety profile. The description supplies the one non-obvious semantic (same-paper boundary), leaving nothing an agent needs before calling it.

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 all four parameters (ref, lang, window, include_entities) are already documented, including the 1-10 window range and the enum for lang. The description only restates the window concept ('N paragraphs before and after'), adding nothing new about ref formats or entity inclusion, so baseline 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 and resource ('Get a paragraph') plus a precise scope modifier ('with surrounding context, N paragraphs before and after within the same paper'). This implicitly differentiates it from the sibling paragraphs.get (single paragraph) and paragraphs.random, though it never names those siblings explicitly.

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

Usage Guidelines3/5

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

'Useful for understanding passages in context' implies the usage scenario but gives no explicit when-to-use/when-not guidance and never points to an alternative such as paragraphs.get. The choice between this and the plain paragraph tool must be inferred.

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.