Skip to main content
Glama

Traverse the Hispanic Legacy knowledge graph

get_related
Read-onlyIdempotent

Graph neighbours of an object: outgoing and incoming relations, each with its relation type. PAGED: 25 relations by default, 200 at most, and a response budget of about 64 KB per call — a page over budget comes back shorter WITH a next_cursor, never truncated. One cursor walks both directions, outgoing first; its absence means you have the last page. Use this after get_entity to widen an answer with adjacent objects. It walks one hop from an id you already have — use search when you have a question and no starting object.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
idYesThe knowledge object to walk out from, by id.
limitNoHow many relations to return, across both directions. Defaults to 25.
cursorNoContinue from a previous call: pass the next_cursor it returned. Opaque; do not construct one.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
foundYes
totalNoHow many relations this object has in both directions, before paging.
incomingNo
outgoingNo
recoveryNo
returnedNo
next_cursorNoPass to the next call to continue. ABSENT means this was the last page.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed5 schema fields changed
    • addedInput schema / properties / cursor
      Added value: +{
      +  "description": "Continue from a previous call: pass the next_cursor it returned. Opaque; do not construct one.",
      +  "maxLength": 200,
      +  "minLength": 1,
      +  "type": "string"
      +}
    • addedInput schema / properties / limit
      Added value: +{
      +  "description": "How many relations to return, across both directions. Defaults to 25.",
      +  "maximum": 200,
      +  "minimum": 1,
      +  "type": "integer"
      +}
    • addedOutput schema / properties / next_cursor
      Added value: +{
      +  "description": "Pass to the next call to continue. ABSENT means this was the last page.",
      +  "type": "string"
      +}
    • addedOutput schema / properties / returned
      Added value: +{
      +  "maximum": 9007199254740991,
      +  "minimum": -9007199254740991,
      +  "type": "integer"
      +}
    • addedOutput schema / properties / total
      Added value: +{
      +  "description": "How many relations this object has in both directions, before paging.",
      +  "maximum": 9007199254740991,
      +  "minimum": -9007199254740991,
      +  "type": "integer"
      +}
  2. Changed2 schema fields changed
    • addedOutput schema / properties / incoming / items / properties / entity / properties / x
      Added value: +{
      +  "additionalProperties": {
      +    "additionalProperties": {},
      +    "propertyNames": {
      +      "type": "string"
      +    },
      +    "type": "object"
      +  },
      +  "description": "Indexed instance-specific attributes, grouped by namespace — the same fields api/index.json publishes. Absent when the instance declares none.",
      +  "propertyNames": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
    • addedOutput schema / properties / outgoing / items / properties / entity / properties / x
      Added value: +{
      +  "additionalProperties": {
      +    "additionalProperties": {},
      +    "propertyNames": {
      +      "type": "string"
      +    },
      +    "type": "object"
      +  },
      +  "description": "Indexed instance-specific attributes, grouped by namespace — the same fields api/index.json publishes. Absent when the instance declares none.",
      +  "propertyNames": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
  3. Changed1 schema field changed
    • addedInput schema / properties / id / description
      Added value: +"The knowledge object to walk out from, by id."
  4. Changed1 schema field changed
    • addedOutput schema / properties / recovery
      Added value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "available": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "available_count": {
      +      "maximum": 9007199254740991,
      +      "minimum": -9007199254740991,
      +      "type": "integer"
      +    },
      +    "available_truncated": {
      +      "type": "boolean"
      +    },
      +    "did_you_mean": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "hint": {
      +      "type": "string"
      +    },
      +    "next_tool": {
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "available_count",
      +    "available",
      +    "next_tool",
      +    "hint"
      +  ],
      +  "type": "object"
      +}
  5. First observed

TDQS

A4.6/5.0
Behavior5/5

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

Annotations already declare readOnlyHint, idempotentHint, and destructiveHint. The description adds substantial behavioral detail beyond annotations: default limit (25), maximum (200), response budget (~64 KB), cursor behavior ('pass the next_cursor it returned'), and directional ordering ('outgoing first'). It also guarantees 'never truncated', which is a meaningful behavioral promise.

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 concise and free of fluff, but it repeats certain details (e.g., paging limits and cursor behavior appear in both the main text and parameter descriptions). It is slightly wordy but remains clear and well-structured.

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 is present, so the description does not need to enumerate return fields. It does mention key aspects of the response: relations with relation types, pagination via next_cursor, and directional ordering. The description gives enough context for an agent to understand what to expect and how to use the results.

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%: each parameter (id, limit, cursor) has a description with constraints. The main description adds some contextual detail (e.g., 'across both directions' and 'Opaque; do not construct one'), but these largely reflect information already present in the schema descriptions. Since the schema covers all parameters, the baseline of 3 applies; the description adds only minimal extra meaning.

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

Purpose5/5

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

The description clearly states the tool's function: 'Graph neighbours of an object: outgoing and incoming relations, each with its relation type.' It also distinguishes this tool from siblings by explicitly saying 'Use this after get_entity to widen an answer with adjacent objects' and contrasts with 'search when you have a question and no starting object.'

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

Usage Guidelines5/5

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

The description provides explicit when-to-use guidance: 'Use this after get_entity' and when-not-to-use: 'use search when you have a question and no starting object.' It also describes the paging behavior and direction order, leaving no ambiguity about how to invoke it correctly.

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.