Skip to main content
Glama

site

The questions the enquiry asks

enquiry_fields

Every field of the TelescopeCompareHQ enquiry: key, label, type, whether required, help text and the allowed options where there are any. Pass answers to submit_enquiry keyed by field key.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A3.9/5.0
Behavior3/5

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

With no annotations, the description bears the full disclosure burden. It usefully reveals the shape of the returned field metadata and its role as input to submit_enquiry, but never states that this is a side-effect-free read, whether authentication is required, or what happens on error/empty results.

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, fully front-loaded: the returned content comes first, the actionable hand-off second. No filler, no restatement of the tool name.

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 the description correctly compensates by listing the fields returned and noting the conditional allowed-options list. It is complete enough to call and consume, though it omits error/empty-state behavior.

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?

Zero parameters, so the baseline is 4. The description nonetheless adds meaning about the returned 'key' by explaining that it is the identifier submit_enquiry expects for answers, which is useful semantics not implied by the empty 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 precisely enumerates what is returned (key, label, type, required flag, help text, allowed options) for the TelescopeCompareHQ enquiry, which makes the resource and payload unambiguous. The verb is only implicit ('Every field of the...'), and it does not explicitly contrast itself with the closely-named sibling enquiry_describe.

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 states a concrete downstream workflow: answers gathered against these fields should be passed to submit_enquiry keyed by field key, which tells the agent how this tool fits into the enquiry flow. It does not, however, say when to prefer this over enquiry_describe or what to do if the enquiry definition is absent.

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