query_projects
查 RWA 项目评分榜:人工核查的深度体检卡,含评分(0-100)/TVL/年化收益/链/合约地址/发行方/托管/审计/风险点。可按资产类别过滤。示例: query_projects(asset_class='treasury', limit=5)。按次计费 $0.03 USDC。
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| asset_class | No |
查 RWA 项目评分榜:人工核查的深度体检卡,含评分(0-100)/TVL/年化收益/链/合约地址/发行方/托管/审计/风险点。可按资产类别过滤。示例: query_projects(asset_class='treasury', limit=5)。按次计费 $0.03 USDC。
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| asset_class | No |
Changes observed during successful MCP inspections.
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 disclose two useful behavioral facts: the data is human-verified ('人工核查') and the tool is pay-per-call at $0.03 USDC. However, it says nothing about pagination, default result count, or failure behavior, leaving real gaps for a paid query tool.
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?
Content is front-loaded into one dense sentence covering purpose and fields, followed by the filter capability, an example call, and pricing. No filler, though the run-on field list is dense to parse.
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?
With no output schema, the description correctly enumerates the returned fields so the agent knows the return shape. Combined with the cost disclosure and example, it covers most of what is needed, missing only pagination/limit semantics.
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 0%, so the description must compensate. It clarifies asset_class (filter by asset category) and demonstrates both params via the example, but never explains what limit does or its default of 20, and gives no hint of valid asset_class values, leaving the filtering contract underspecified.
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+resource (查 RWA 项目评分榜) and enumerates the returned fields (评分/TVL/年化收益/链/合约地址/发行方/托管/审计/风险点), so an agent knows exactly what data it gets. It is distinguishable from sibling verify_rwa_project, though the difference from query_market is only implied.
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 explicit when-to-use or when-not guidance, and sibling tools like verify_rwa_project and query_market are never mentioned as alternatives. The only implicit signal is the example invocation and the note that results can be filtered by asset class.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Add one secure layer between your agents and this server.