Server Quality Checklist

Tool Scores

• listenD
  1.6/5.0
  Behavior1/5

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

  With no annotations, the description carries full responsibility for disclosing behavior. 'There is nothing here to hear' vaguely implies no output or no content, but does not state side effects, return values, errors, or what happens on success. This is nearly zero behavioral disclosure.

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

  Conciseness2/5

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

  The description is extremely short and front-loaded, but it suffers from under-specification rather than being appropriately concise. It uses words without carrying essential meaning, so the brevity is not an asset.

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

  Completeness1/5

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

  With no output schema, no annotations, and no behavioral detail, the description is entirely insufficient. An agent cannot determine what the tool returns, what side effects occur, or what constitutes a successful call.

  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?

  The tool has 0 parameters and the schema coverage is 100% by virtue of being empty. Per the 0-parameter baseline of 4, the description does not need to explain parameters since none exist.

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

  Purpose1/5

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

  The description 'Listen. There is nothing here to hear.' is poetic and tautological, restating the tool name without defining a concrete function or resource. It provides no actionable information about what the tool does, and does not distinguish it from siblings like look or touch.

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

  Usage Guidelines1/5

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

  There is no guidance on when to use this tool versus its siblings. No context, conditions, alternatives, or exclusions are mentioned, leaving an agent to guess whether or how this tool should be invoked.

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

• touchB
  3.1/5.0
  Behavior3/5

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

  With no annotations, the description carries the full behavioral disclosure burden. 'Most things do nothing' is a useful expectation-setting detail: it tells the agent that many targets are no-ops. However, it does not describe what happens when a target does respond, what the return value looks like, or whether the action has any irreversible consequences.

  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?

  The description is extremely concise: two short sentences, with the core action first and the most important behavioral caveat second. There is no redundancy or wasted wording.

  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?

  For a deliberately minimal game/toy tool with a single parameter, no output schema, and simple siblings, the description covers the essential behavior: touch a target and expect most things to be inert. It could be more complete by saying what a meaningful touch returns or how to detect interactive objects, but the low complexity keeps the gap small.

  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 100%, so the schema already documents the 'target' parameter and provides an example ('lantern'). The description adds essentially no semantic information beyond what the schema gives, so the baseline of 3 is appropriate.

  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 description states a clear verb ('touch') and the target resource is supplied via the parameter, but it does not define what the operation accomplishes beyond the action itself. 'Most things do nothing' hints at interaction but leaves the tool's exact purpose vague, and it does not clearly differentiate from look/listen beyond the physical modality.

  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?

  The description gives no explicit guidance on when to use touch versus look or listen. 'Most things do nothing' implies that touch is for probing interactivity, but there is no stated context, exclusion, or alternative recommendation an agent can rely on.

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

• lookA
  3.7/5.0
  Behavior2/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 only says 'Look at your surroundings' without specifying what the agent will receive (e.g., textual description, list of objects), whether the operation is read-only, or any limitations.

  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?

  The description is one short sentence with no filler or redundancy. It is front-loaded and every word contributes to the meaning.

  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?

  Given this is a simple, zero-parameter tool, the description conveys the basic action adequately. However, with no output schema or behavioral details, it remains unclear what the tool actually returns or how the agent should interpret 'surroundings'.

  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?

  The tool has zero parameters, so the baseline is 4. No parameter explanation is needed or possible; the description does not need to compensate for schema gaps.

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

  Purpose5/5

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

  The description states a specific verb ('Look') and resource ('surroundings'), clearly indicating a visual observation action. It naturally distinguishes itself from sibling tools 'listen' and 'touch' by sense modality, so an agent can tell them apart.

  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?

  No explicit when-to-use guidance or alternatives are mentioned, but the sibling names 'listen' and 'touch' imply this tool is for visual gathering of environmental information. The usage context is implied rather than explicitly stated.

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