site

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

With no annotations, the description carries the full burden and does add meaningful context: no purchase/payment, no guaranteed quote, free, and it returns recipient/consent/confirmation details. However, it never explicitly states that enquiry_describe itself is read-only and has no submission side effects; that must be inferred from the tool name and the 'Read first' instruction.

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

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

The description is compact and front-loaded with the crucial 'Read first' instruction, and each subsequent clause adds a distinct fact. Minor redundancy with the title—not a purchase, no guaranteed quote—prevents a top score.

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

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

For a zero-parameter informational tool, it is reasonably complete: it explains what submit_enquiry does, what it does not do, and what information the description returns. It does not specify output format, but the absence of an output schema and the low complexity make this a minor gap.

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

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

There are zero parameters and the schema is trivially complete, so the baseline is 4. The description correctly avoids inventing parameter details where none exist.

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

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

The description clearly identifies that this tool states what submit_enquiry does, distinguishing it from the actual submission action. It is somewhat indirect about its own operation—using 'States plainly' and 'Also returns' rather than an explicit 'This tool returns'—but the purpose is recoverable and not misleading.

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

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

'Read first' gives an explicit temporal cue: invoke this before submit_enquiry. This is clear usage context, but it does not contrast with enquiry_fields or state when not to use the tool, so it falls short of full alternative guidance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

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

There are no annotations, so the description carries the full burden. It discloses what fields are included and qualifies options with 'where there are any', giving a good sense of the return content. However, it never explicitly says the tool is read-only or what the output shape looks like beyond the attribute list.

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

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

Two sentences, no filler. The description front-loads the resource and then immediately lists the useful attributes and the relationship to submit_enquiry.

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

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

For a zero-parameter, simple introspection tool with no output schema, the description is complete: it specifies exactly what data will be returned and how that data is meant to be used with the sibling submit_enquiry tool.

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

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

The tool takes zero parameters, so the schema and description have no parameter semantics to document; the 0-param baseline is 4. The sentence about passing answers keyed by field key is not parameter documentation for this tool, but it does contextualize the returned keys.

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

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

The description clearly identifies the resource as 'Every field of the Forklift Course Finder enquiry' and enumerates the returned attributes (key, label, type, required, help text, allowed options). It does not use an explicit verb like 'list' or 'get', and it does not contrast with the sibling enquiry_describe, so it falls short of a 5.

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

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

The description gives clear context by telling the agent that answers should be passed to submit_enquiry keyed by field key, which implies when this tool is useful. It does not explicitly state when to use enquiry_describe instead, so it lacks the explicit exclusion needed for a 5.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

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

With no annotations, the description carries the full burden and does so: it discloses that this is not a purchase or quote, that step 1 validates and returns a summary/consent line/token, that the enquiry only reaches providers after the person clicks an emailed link, and it spells out exactly what consent means. This is rich behavioral context beyond anything the schema conveys.

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

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

Front-loaded with the scope disclaimers and the two steps, and every sentence is functional. It is long, partly because the full consent wording is reproduced verbatim even though the schema's consent description already contains it, which is mild redundancy rather than waste.

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

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

No output schema exists, yet the description explains what each step returns (summary, consent line, confirmation token) and what the end user experiences (an email with a click-through link). For a nested-answers, two-call mutation flow, nothing an agent needs is missing.

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

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

Schema description coverage is 100%, so the baseline is 3, but the description adds real semantic value by explaining each parameter's role in the two-step flow: answers keyed by field key from enquiry_fields, consent=true required at both steps, and confirmation being the token from step 1 used only after approval.

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

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

States a specific verb (submits) and resource (an enquiry to Forklift Course Finder) and immediately delimits scope with 'NOT a purchase, NOT a guaranteed quote'. It is clearly distinguishable from the sibling read-only tools enquiry_describe and enquiry_fields.

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

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

Gives an explicit two-step protocol: step 1 with answers + consent=true to validate, show the person the summary and consent line, then step 2 only if the person agrees, adding the confirmation token. The condition that gates the second call is stated outright, leaving nothing to inference.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.