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

注解已提供 readOnlyHint=true，覆盖了只读属性；描述额外列出了付费包并提及付费代币 (x402 Base USDC)，暗示调用付费包可能产生费用，但未明确说明调用此工具是否会触发交易或消耗。总体行为细节（如分页、错误处理）未披露，但在注解覆盖下，3分是合理基线。

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?

描述由两句组成，第一句开门见山说明用途和契约，第二句列出可用包，信息密度高且无冗余。包列表虽然较长，但属于必要信息，整体结构紧凑且前端加载了核心意图。

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?

该工具包含 8 个参数和多个嵌套对象，且无输出模式，描述仅提供用途和包列表，未说明如何组合参数（如 filters、metrics 的用法）、返回格式或使用示例。虽然 schema 内部覆盖参数描述，但对于这种复杂度的工具，缺少对查询构造和返回契约的整体指导，明显不完整。

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 中所有 8 个参数均有描述，覆盖率为 100%，因此描述无需重复参数含义。描述通过列举免费/付费包为 source_id 和 pack_id 提供了可用的值域示例，但未对 sort、filters、metrics 等嵌套对象给出额外用法说明，因此仅停留在基线水平。

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?

描述明确说明了该工具是用于按 source_id 或 pack_id 进行直接访问的通用结构化查询，并引用了 POST /api/v1/query/dataset 契约，这清晰地定义了它做什么。与兄弟工具 get_catalog、get_pack 相比，它明显是数据查询工具，区别基本可以推断，但未显式点名替代工具，所以未达到满分的清晰区分。

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?

描述列举了免费和付费的包，提供了使用背景；但未说明何时该用此工具而非 get_pack 或 get_catalog，也没有明确排除条件。缺少'当只需获取包元数据时使用 get_pack'之类的指引，使用场景全凭推断。

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