Skip to main content
Glama

Get answer

get_answer
Read-onlyIdempotent

One AI answer in full, with the brands it mentions, its recommendations, ranked list, outcome, and citations. Use it to read an answer_id from list_answers; to scan many answers use list_answers.

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": {
      "answer_id": "<answer_id>"
    },
    "name": "get_answer"
  }
}

Input Schema

NameRequiredDescriptionDefault
answer_idYesAnswer ID from list_answers.

Output Schema

NameRequiredDescriptionDefault
dataYes
generated_atYesRFC 3339 time the response was made.
schema_versionYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedOutput schema / properties / data / properties / claims
      Added value: +{
      +  "description": "Claims the answer makes about the brand, in answer order, when the plan includes reputation.",
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "kind": {
      +        "description": "The narrative kind the claim feeds; empty when it forms none.",
      +        "type": "string"
      +      },
      +      "narrative_id": {
      +        "description": "Narrative ID for get_narrative; empty when unassigned.",
      +        "type": "string"
      +      },
      +      "quote": {
      +        "type": "string"
      +      },
      +      "verdict": {
      +        "description": "accurate, false, outdated, confusion, unchecked, not_checkable, contact_wrong, or contact_unverified.",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "quote",
      +      "verdict",
      +      "kind",
      +      "narrative_id"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
  2. Changed1 schema field changed
    • addedOutput schema / properties / data / properties / citations / items / properties / position / description
      Added value: +"Character offset of the citation in the answer text; null unless the provider gave spans."
  3. Changed3 schema fields changed
    • addedInput schema / additionalProperties
      Added value: +false
    • addedInput schema / properties / answer_id / minLength
      Added value: +1
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "data": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "brands_mentioned": {
      +          "items": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "brand_id": {
      +                "type": "string"
      +              },
      +              "context": {
      +                "type": "string"
      +              },
      +              "name": {
      +                "type": "string"
      +              },
      +              "position": {
      +                "description": "Order among mentioned brands, 1 = first.",
      +                "type": "integer"
      +              },
      +              "sentiment": {
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "brand_id",
      +              "name",
      +              "position",
      +              "sentiment",
      +              "context"
      +            ],
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "captured_at": {
      +          "type": "string"
      +        },
      +        "citations": {
      +          "items": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "domain": {
      +                "type": "string"
      +              },
      +              "ownership": {
      +                "description": "own, competitor, or third_party.",
      +                "type": "string"
      +              },
      +              "position": {
      +                "type": [
      +                  "null",
      +                  "integer"
      +                ]
      +              },
      +              "title": {
      +                "type": "string"
      +              },
      +              "url": {
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "url",
      +              "domain",
      +              "title",
      +              "ownership",
      +              "position"
      +            ],
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "id": {
      +          "type": "string"
      +        },
      +        "model": {
      +          "description": "Model family key.",
      +          "type": "string"
      +        },
      +        "model_name": {
      +          "type": "string"
      +        },
      +        "model_version": {
      +          "description": "The exact model that answered.",
      +          "type": "string"
      +        },
      +        "outcome": {
      +          "additionalProperties": false,
      +          "description": "null until classified.",
      +          "properties": {
      +            "labels": {
      +              "items": {
      +                "type": "string"
      +              },
      +              "type": "array"
      +            },
      +            "outcome": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "outcome",
      +            "labels"
      +          ],
      +          "type": [
      +            "null",
      +            "object"
      +          ]
      +        },
      +        "prompt_id": {
      +          "type": "string"
      +        },
      +        "ranked_list": {
      +          "description": "The answer's own numbered list, when it has one.",
      +          "items": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "brand_id": {
      +                "description": "Set when the entry is a tracked brand.",
      +                "type": "string"
      +              },
      +              "name": {
      +                "type": "string"
      +              },
      +              "position": {
      +                "type": "integer"
      +              }
      +            },
      +            "required": [
      +              "position",
      +              "name",
      +              "brand_id"
      +            ],
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "recommendations": {
      +          "items": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "brand_id": {
      +                "type": "string"
      +              },
      +              "context": {
      +                "type": "string"
      +              },
      +              "name": {
      +                "type": "string"
      +              },
      +              "rank": {
      +                "description": "Position in the answer's ranking; null when unranked.",
      +                "type": [
      +                  "null",
      +                  "integer"
      +                ]
      +              },
      +              "status": {
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "brand_id",
      +              "name",
      +              "status",
      +              "rank",
      +              "context"
      +            ],
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "text": {
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "id",
      +        "prompt_id",
      +        "model",
      +        "model_name",
      +        "model_version",
      +        "captured_at",
      +        "text",
      +        "brands_mentioned",
      +        "recommendations",
      +        "ranked_list",
      +        "outcome",
      +        "citations"
      +      ],
      +      "type": "object"
      +    },
      +    "generated_at": {
      +      "description": "RFC 3339 time the response was made.",
      +      "type": "string"
      +    },
      +    "schema_version": {
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "schema_version",
      +    "generated_at",
      +    "data"
      +  ],
      +  "type": "object"
      +}
  4. Added

TDQS

A4.2/5.0
Behavior3/5

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

Annotations already declare readOnlyHint, idempotentHint, destructiveHint=false and openWorldHint, so the safety profile is covered. The description adds that the payload is the full answer with derived artifacts (ranked list, outcome, citations), but says nothing about behavior on an unknown or expired answer_id, permission requirements, or latency/limits.

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

Conciseness5/5

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

Two sentences, zero waste: the payload description comes first, then the routing guidance. The critical 'use list_answers to scan' rule is front-loaded rather than buried.

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?

An output schema exists, so the description needn't explain return values, and it correctly focuses on scope and routing instead. The only gap is failure behavior for an invalid answer_id, a minor omission for a single-parameter read tool.

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?

Only one parameter and schema description coverage is 100% – the schema already documents answer_id as coming from list_answers. The description restates the same origin rather than adding new semantics such as format or validity constraints, so the baseline 3 applies.

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?

States a specific verb and resource ('One AI answer in full') and enumerates exactly what the record contains: brands, recommendations, ranked list, outcome, citations. That enumeration also distinguishes it from the sibling list_answers, which returns a collection rather than a full record.

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?

Explicitly names when to use this tool (to read an answer_id) and when not to (to scan many answers, use list_answers). The alternative and the selecting condition are both stated, leaving nothing to infer.

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