Skip to main content
Glama

Answers for AI search

answer_readiness
Read-onlyIdempotent

Whether a page answers the questions people ask AI and Google. Pick with mode: questions = Sub-questions AI Mode fans out to, and which the page answers. Needs url, topic, questions. passages = The passages that answer given questions, or the gaps. Needs url, question. format = Answer format against the pages that rank. Needs url, question, competitors.

Input Schema

NameRequiredDescriptionDefault
urlNoFull address of the page.
modeNoDefault questions.
topicNoThe topic or main query, for example 'passport renewal'.
detailNobrief = short summary.
questionNoThe question people ask, for example 'how long does shipping take to Germany'.
questionsNoThe sub-questions an AI search engine would ask for the topic.
memory_keyNosite_memory key, records this call.
competitorsNoOptional: up to 2 pages that rank for the topic.

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • removedOutput schema / description
      Removed value: -"The result as structured data; fields depend on mode."
  2. Changed2 schema fields changed
    • changedInput schema / properties / detail / description
      Previous value: -"brief returns a short summary, default full."New value: +"brief = short summary."
    • changedInput schema / properties / memory_key / description
      Previous value: -"Optional site_memory key, to record this call in the site memory."New value: +"site_memory key, records this call."
  3. Changed1 schema field changed
    • addedInput schema / properties / detail
      Added value: +{
      +  "description": "brief returns a short summary, default full.",
      +  "enum": [
      +    "full",
      +    "brief"
      +  ],
      +  "type": "string"
      +}
  4. Changed1 schema field changed
    • addedInput schema / properties / memory_key
      Added value: +{
      +  "description": "Optional site_memory key, to record this call in the site memory.",
      +  "maxLength": 80,
      +  "type": "string"
      +}
  5. Added

TDQS

A3.9/5.0
Behavior3/5

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

Annotations already declare readOnlyHint, idempotentHint, openWorldHint and destructiveHint=false, so the safety profile is covered. The description adds the mode-conditional invocation behavior but does not disclose anything further about cost, external calls, or output characteristics beyond what annotations and the output schema provide.

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?

One framing sentence followed by three compact mode clauses, each pairing a mode with what it returns and what it needs. Front-loaded and every clause earns its place; no filler.

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 not be restated, and the mode/parameter mapping gives the agent everything required to invoke correctly. Minor gap: no guidance on default mode behavior despite the schema noting 'Default questions', which the description could have confirmed.

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

Parameters4/5

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

Schema coverage is 100%, but the schema lists zero required parameters while the description supplies the conditional requirement logic per mode ('Needs url, topic, questions', 'Needs url, question', 'Needs url, question, competitors'). That is genuine semantic value the schema does not encode, and it also explains what each mode returns.

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 purpose: whether a page answers the questions people ask AI and Google, framed around an answer-readiness evaluation. It clearly separates this from generic scan/audit siblings, though the verb is somewhat implicit rather than a clean 'evaluate X against Y'.

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 explicitly tells the agent how to select a mode (questions vs passages vs format) and which parameters each mode requires. This is real invocation guidance. It stops short of naming when to prefer a sibling tool or when not to use this one, so it is not a full 5.

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.