Skip to main content
Glama

Read the assistants' answers

visibility_answers
Read-onlyIdempotent

The answers behind the latest check, page by page. named=true keeps answers that named the business, named=false the ones that did not (the gaps to work on). Free. Free.

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": {
      "website": "<website>"
    },
    "name": "visibility_answers"
  }
}

Input Schema

NameRequiredDescriptionDefault
limitNo
namedNo
cursorNo
websiteYesThe business website, e.g. https://acme.com

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

B3.2/5.0
Behavior3/5

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

Annotations already carry readOnlyHint, idempotentHint, destructiveHint=false and openWorldHint=false, so safety is covered. The description adds two genuinely new facts: results are paginated, and there is no cost ('Free'). Beyond that it says nothing about what happens when no check exists, what the default page size is, or how the response is shaped — and the duplicated 'Free. Free.' wastes the one behavioral claim it does make.

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

Conciseness3/5

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

Front-loading is good — the resource comes first, the filter semantics second. But the duplicated 'Free. Free.' is pure noise and the whole definition is only two sentences, so the redundancy is proportionally large. The filter explanation is the strongest sentence and earns its place.

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?

There is no output schema, so an agent might want to know the shape of an answer row, which the description does not give. Still, for a read-only paginated list with annotation coverage of the safety profile, the definition supplies the essentials: what is returned, how paging works, and what 'named' selects. The missing prerequisite/cost-free confirmation and default page size are the notable gaps.

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 only 25% (only 'website' is documented), so the description is expected to compensate. It does well on 'named', spelling out both branches (true = answers that named the business, false = the gaps), which the schema gives no hint of. 'cursor' is only obliquely covered by 'page by page', and 'limit' plus its 1–50 bounds are left entirely to the schema.

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 names a specific resource — the assistants' answers behind the latest visibility check — and the paginated framing ('page by page') tells an agent this is a read/list operation. Paired with the title 'Read the assistants' answers', it is clearly distinguishable from visibility_check, visibility_report and visibility_improve. It stops short of a 5 because the description itself is a noun phrase with no explicit verb and never defines what a 'check' is.

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

Usage Guidelines2/5

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

There is no explicit statement of when to call this versus visibility_report or visibility_check, and no mention that a check must already exist (only the oblique 'latest check' hints at a prerequisite). The one piece of routing guidance is implicit: named=false points at 'the gaps to work on', which faintly gestures at visibility_improve, but the agent has to make that leap itself.

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