Skip to main content
Glama

preflight_request

Check bounded capability readiness without returning the substantive result. Free.

Input Schema

NameRequiredDescriptionDefault
capability_idYes

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

C2.6/5.0
Behavior3/5

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

The description adds two traits beyond the annotations: it is a dry-run that does not return the substantive result, and it costs nothing ('Free') - neither is derivable from the structured fields. It does not, however, explain the surprising readOnlyHint=false, i.e. what side effect a 'check' has, nor what 'readiness' means operationally.

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?

It is short and front-loads the purpose, with no filler. But it is two terse fragments, the trailing 'Free.' lacks structural context, and the brevity is closer to under-specification than to disciplined conciseness.

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

Completeness2/5

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

An output schema exists, so return values need not be described. Still, for a tool whose readOnlyHint is false and whose only parameter is undocumented, the description omits the side-effect profile and the meaning/source of capability_id - both needed for correct invocation, especially with a sibling list that already offers get_capability and list_capabilities.

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

Parameters2/5

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

Schema description coverage is 0% and the single required capability_id is never mentioned in the description, so the agent gets no guidance on what identifier form is expected or that list_capabilities/get_capability supply it. One well-named parameter keeps this above the floor, but the description does not compensate for the coverage gap.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

The verb 'Check' and resource 'capability readiness' are identifiable, and 'preflight_request' does read as a distinct tool from siblings like get_capability and list_capabilities. However, 'bounded capability readiness' is undefined jargon that leaves the actual resource ambiguous, and there is no explicit differentiation from the sibling set.

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 when-to-use guidance, no stated alternatives, and no prerequisites. 'Free' implies a preflight-before-the-real-request pattern, which is weak implied usage context, but the description never says when to reach for this versus get_capability or aios_status.

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