site

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

With no annotations, the description carries the burden of behavior; it adds useful context by listing what the calculator returns and noting that missing inputs fall back to defaults. It doesn't explicitly state that this is a read-only, side-effect-free estimation (unlike submit_enquiry), but 'calculator' and the output-only framing make the lack of side effects reasonably inferable.

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 short sentences, with the core action front-loaded and the output categories compactly listed. The default-fallback note earns its place by protecting against assumption errors, and there is no redundant wording.

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 simple calculator with zero required parameters and fully documented inputs, the description covers what is calculated and the fallback behavior. It doesn't specify the return format or numeric rounding because there is no output schema, but the listed output categories give enough context for an agent to interpret the result.

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 schema already documents all four parameters at 100% coverage, so the description is not required to re-explain them. It adds only the general statement that missing inputs use defaults, which is a useful reminder but not parameter-specific meaning.

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 names the exact resource ('Settlement agreement estimator calculator') and the action ('Run'), and enumerates the specific outputs it produces, so an agent can tell it's the calculator rather than the enquiry/submission siblings. It doesn't explicitly point to a distinguishing sibling, but the verb and output list make the purpose unambiguous.

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?

There is no statement about when to choose this calculator over calculator_describe or the enquiry/submission tools, and no exclusion or alternative behavior. The only contextual hint is the output list, which implies calculation use but leaves the selection logic to inference.

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 it does well by disclosing what the tool returns: inputs with units/ranges/defaults, outputs, and assumptions/tables. It makes clear this is a descriptive, read-only operation, though it could be even more explicit that no calculation is performed.

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 a single sentence that efficiently covers all major content areas: inputs, outputs, assumptions, and tables. It is front-loaded and contains no filler.

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 no-parameter describe tool with no output schema, the description is complete: it tells the agent exactly what information will be revealed about the calculator. The presence of sibling tools does not create missing context because the describe-versus-calculate distinction is already clear from the tool name and description.

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 itself has zero parameters, so the baseline is 4. The description mentions the calculator's inputs, but that is the subject matter being described rather than parameters of this tool, so no additional parameter guidance is needed.

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 states that this tool provides the calculator's inputs, outputs, and underlying assumptions/tables. The title and description together identify the specific resource (Settlement agreement estimator) and the descriptive verb, distinguishing it from the sibling 'calculate' tool.

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?

Usage is implied rather than explicit: the name and title suggest using this tool to understand the estimator before performing calculations, but the description does not state when to choose it over 'calculate' or other siblings. No exclusions or alternative conditions are provided.

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?

No annotations are provided, so the description carries the behavioral disclosure burden. It clearly indicates the tool is descriptive and read-only ('States plainly', 'returns...'), and it discloses exactly what information is returned: recipients, consent wording, and confirmation method. It also removes risk by clarifying that nothing is bought, ordered, or paid.

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 front-loaded with 'Read first' and every sentence adds meaningful information: action, exclusions, cost, guarantee, and return contents. It is compact yet fully informative.

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 parameterless descriptive tool with no output schema, the description covers what the user receives and clarifies the boundary with submit_enquiry. It could be slightly more explicit about the exact format of the returned text, but it is otherwise complete.

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 has zero parameters and schema coverage is 100%, so the baseline is 4. There is nothing for the description to add about parameter behavior, and it does not mislead.

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 is specific: 'States plainly what submit_enquiry does on Settlement Calculator' uses a distinct verb and names its resource. It clearly separates itself from submit_enquiry by being a descriptive explanation rather than the actual action, and from calculator_describe by topic.

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' is a direct instruction to invoke this tool before using submit_enquiry, and the body explains the context in which it applies. It does not explicitly name exclusions or alternatives, but the usage intent is clear.

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 behavioral burden. It transparently discloses what the tool exposes: every enquiry field with its properties, and it implies a read-only metadata lookup by telling the agent to pass answers to submit_enquiry separately. It does not discuss edge cases or failure modes, but for a simple field-listing tool this is adequate.

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?

A single, information-dense sentence that front-loads the resource and immediately lists the output attributes. Every phrase earns its place, and the instruction about submit_enquiry is a useful addition without padding.

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, no-output-schema tool, the description is complete: it names the resource, enumerates all returned field attributes, and explains how to use the result with a sibling tool. No critical information 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?

The tool has zero parameters, so the baseline is 4. The description adds relevant semantic context by explaining that returned field keys are used to key answers when calling submit_enquiry, which is helpful even though no parameters need documenting.

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 ('Every field of the Settlement Calculator enquiry') and enumerates the available attributes (key, label, type, required, help text, allowed options). It is distinguishable from siblings like calculate and submit_enquiry, though it lacks an explicit verb such as 'returns' or 'lists'.

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 for use: it provides the field metadata needed to construct a payload for submit_enquiry, and explicitly says to pass answers keyed by field key. It does not explicitly exclude alternatives or state when not to use it, but the intended workflow is clear.

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 of behavioral disclosure and does so thoroughly. It explains validation in step 1, that the enquiry is only submitted in step 2, that the person must click an email link before providers see it, and the exact consent wording the person must have agreed to.

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 long but every sentence earns its place: it front-loads the key warning, then clearly separates the two steps with conditions and outcomes. The structure makes the multi-step flow easy to follow without unnecessary detail.

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?

Despite having no output schema or annotations, the description covers validation behavior, the summary/consent line/token returned in step 1, the condition for step 2, and the email-link requirement. An agent has enough context to invoke this tool correctly through both steps.

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 coverage is 100%, so the baseline is 3. The description adds meaningful context by linking answers to enquiry_fields, explaining that consent requires agreement to a specific statement, and clarifying that confirmation is the token returned in step 1 and reused in step 2.

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 states it submits an enquiry to Settlement Calculator and immediately differentiates it from a purchase or guaranteed quote. It also conveys the two-step nature up front, which distinguishes it from simpler sibling tools like calculate or 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?

The description gives an explicit step-by-step protocol: call once to validate, show the summary, then call again only if the person agrees. It clearly states when step 2 is appropriate and warns that this is not a purchase/quote, but it does not name sibling alternatives explicitly.

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