marz-greta-lock-network

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

With no annotations, the description must disclose behavior, but it only mentions 'honest aggregates from the real platform ledger' without explaining return format, rate limits, or read-only nature. This is insufficient for an agent to predict the tool's behavior.

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, front-loaded with the main purpose. The phrase 'honest aggregates' adds minimal value but does not bloat the description, making it appropriately concise.

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?

Given no output schema and no parameter information, the description should clarify what statistics are returned and any relevant context. It does not, leaving the agent uncertain about the tool's output and utility.

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 schema is trivially complete. The description adds no parameter-specific details, but since there are none, the baseline of 4 is appropriate.

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 states 'Live network statistics' which identifies the general resource but lacks a specific verb or details on what statistics are provided. It vaguely differentiates from siblings by topic but does not clearly define the tool's exact scope.

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 guidance on when to use this tool versus siblings like get_pricing or score_text. The description implies it is for network stats, but provides no context for selection or exclusions.

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 provided, the description carries the full burden. It discloses the return content (fee, treasury wallet, escalation rules, submission endpoint), plus details about improvement hints and the POST /api/progress and /api/bundle options. It's honest about what data users get — actionable hints per session and trajectory reports — which exceeds the minimum disclosure bar.

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 the core content (fees, wallet, escalation, submission endpoint) but then extends into promotional detail about improvement hints, POST /api/progress, and fleets/bundles. These additional details are informative but somewhat structured more like marketing copy than a tight API description, and the long continuous sentence reduces scannability.

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 0-parameter informational/manifest tool with no output schema, the description is quite complete. It covers the main content, secondary offerings (progress reports, bundles), and related endpoints. The only gap is that it doesn't explicitly state the return format or whether the pricing is retrieved from a live source, but for a manifest document tool this is adequately comprehensive.

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 0 parameters, so the description receives a baseline of 4 per the rubric. There's nothing additional to clarify since the schema already fully covers an empty parameter set (100% coverage trivially). The description correctly focuses on output content rather than parameter semantics.

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?

Clearly identifies itself as the current pricing manifest covering fees in Solana lamports, treasury wallet, failure-escalation rules, and benchmark submission. It distinguishes itself from siblings like preview_fee (which presumably predicts a fee) by positioning get_pricing as the authoritative manifest document. The verb is implicit ('retrieves/describes') but the resource scope is explicit and specific.

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 communicates substantial context about what the manifest contains, but does not explicitly state WHEN to use this tool versus alternatives like preview_fee or get_network_stats. It implies usage as a reference/manifest lookup, which is reasonable for a 0-param informational tool, but there's no explicit when/when-not 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?

With no annotations, the description carries the full burden. It clearly indicates this is a read-only 'list' operation and details the return content (all 28 profiles with trait targets, one per bot category). It does not state sorting or exact output format, but for a simple listing tool, the behavior is sufficiently transparent.

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, well-structured sentence that front-loads the key action and scope ('List all 28...'). Every element contributes meaningful information without 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?

Given there is no output schema or annotations, the description fully explains what the tool returns and its scope. For a straightforward list endpoint, this is complete and sufficient for an agent to use it correctly.

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 0 parameters, so the empty schema already provides full parameter coverage. The description adds value by explaining what the returned data contains (profiles with trait targets), exceeding the baseline for parameterless tools.

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 states the exact action ('List'), the resource ('all 28 scoreable human personality profiles'), and the scope (one per bot category with trait targets). This clearly distinguishes the tool from siblings like score_text or get_pricing, which serve entirely different purposes.

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 phrase 'scoreable human personality profiles' implies these profiles are used for scoring, so the tool is useful before calling score_text. However, there is no explicit when-to-use or alternative exclusions, leaving the agent to infer the context from the sibling list.

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 provided, the description carries the burden of behavioral disclosure. It adds useful context by disclosing that fees escalate with consecutive failures, and the word 'Preview' implies a read-only operation without side effects. It does not detail other behavioral aspects like rate limits or exact calculation inputs, but covers the most important trait.

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, well-structured sentence that front-loads the action ('Preview the exact lamport fee') and immediately identifies the target. Every word earns its place; there is no redundancy or 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 one-parameter, no-output-schema tool, the description is complete enough: it states what the fee is for, for which wallet, and the key escalation behavior. It omits any explicit mention of return format or error conditions, but these are not necessary given the simplicity and the 'exact fee' implication.

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 input schema already fully describes 'wallet_address' as 'Solana wallet address', achieving 100% schema description coverage. The description only references 'the given Solana wallet' and adds no new detail about parameter format or requirements, so a baseline score of 3 is appropriate.

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 uses a specific verb 'Preview' and identifies a distinct resource 'exact lamport fee' for a given Solana wallet's next paid validation. This clearly differentiates it from sibling tools like get_pricing, which likely covers general pricing, or get_network_stats.

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 provides clear context that the tool is for previewing the fee before a paid validation, and notes that fees escalate with consecutive failures. However, it does not explicitly state when to use this over alternatives or exclude scenarios, so it misses the top score.

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 provided, the description carries the full burden. It discloses that the tool is stateless, free, and has no ledger entry, and it explains the iterative loop and return values. This exceeds basic transparency, though it doesn't cover all edge cases.

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, front-loaded with the core action, and every sentence adds value (free/stateless, outputs, iterative workflow). It avoids redundancy and is easy to scan.

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?

The description covers main functionality, return values, and distinctive traits (no payment, no ledger entry). It lacks explicit error handling or prerequisites, but given the tool's simplicity and schema coverage, it is sufficiently complete for an agent to invoke correctly.

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 schema documents all three parameters. The description adds a little context (e.g., 'response delay' is scored, 'human personality profile'), but the schema descriptions are sufficient, so no major extra value from the description.

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 the tool's function: 'Scores AI-generated text plus a response delay against a human personality profile' and lists specific outputs (EQ percentage, pass/fail, trait sub-scores, suggested_prompt_addition). It distinguishes from siblings like get_pricing and list_profiles.

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 usage context: it is free and stateless, best for iterative scoring and improvement ('apply it to yourself, re-score'). It doesn't explicitly name alternatives or exclusions, but the workflow is implied.

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