Skip to main content
Glama

Answer a question, get the next step

checker_answer

Given a question id and the chosen option (its choice index), return the next question or the final verdict.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
choiceYes
questionYes

Schema Changelog

Changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. First observed

TDQS

A3.5/5.0
Behavior3/5

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

With no annotations provided, the description carries the full burden of behavioral disclosure. It does disclose the output contract—'return the next question or the final verdict'—which is helpful. But it stays silent on side effects (whether the answer is recorded or state advances), idempotency, validation of the question id, and behavior on an out-of-range choice index. For a state-advancing tool, this is a notable but not severe gap.

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?

A single 22-word sentence that is front-loaded with the inputs and ends with the output. There is no fluff, no repetition of the title, and no restating of schema contents. Every word earns its place.

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

Completeness3/5

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

The tool has only 2 parameters, no output schema, and no annotations, so the description must cover the essentials. It names the two possible returns (next question or final verdict) but not their structure, and it does not address error behavior or invalid inputs. For a simple tool in a checker trio this is workable but leaves the agent to infer the response format.

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 description coverage is 0%, so the description must compensate, and it does: it clarifies that question is an id, not a question string, and that choice is an index into the option list. The schema alone only offers type/minLength and type/minimum. The description stops short of specifying how choice aligns with the option list or confirming 0-based indexing, leaving a partial gap.

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 clear function: take a question id and a chosen option index, then return the next question or the final verdict. This distinguishes it from siblings like checker_start (which likely initiates the flow) and checker_tree (which likely shows the overall structure), though it does not explicitly contrast itself. The verb 'return' is slightly passive, but the input→output contract is unambiguous.

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?

The usage context is implied: the agent should call this when it has a question and a choice to advance one step in the flow. However, there is no explicit when-to-use vs when-not-to-use guidance, and no alternatives are named. The sibling names hint at the flow shape, but the description leaves the selection decision to inference.

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.

TDQS

A3.9/5.0
Disambiguation4/5

The checker_* and enquiry_* groups are clearly separated by domain, and within each group the tools serve distinct purposes: start, tree, and answer are interactive versus reference, while describe, fields, and submit map to explanation, schema, and action. The only slight ambiguity is between checker_answer and checker_tree, since both can determine next steps, but their intended usage contexts are different enough.

Naming Consistency4/5

Tools use consistent snake_case and group prefixes: checker_* and enquiry_*. However, the verb/noun ordering varies: checker_start and checker_answer are noun-verb, checker_tree and enquiry_fields are noun-noun, and submit_enquiry is verb-noun. This is a minor deviation rather than chaotic mixing.

Tool Count5/5

Six tools is well-scoped for the server's two clear workflows: an interactive decision guide and an enquiry submission flow. Each tool earns its place with no obvious redundancy or bloat.

Completeness5/5

The checker workflow is complete with a starting point, full tree, and step-by-step traversal. The enquiry workflow covers explanation, schema, and validated two-step submission with consent handling, so there are no obvious dead ends or missing operations.

Resources