New Rust crates & cargo package releases. $0.01/query. Register in-session — free testnet funds.
Scored across 16 tools
The five data_session_* tools (open, fund, funding_package, attach_escrow, query) all open with the identical boilerplate 'Buy per-query access to live data listings...' and only differ in a small trailing clause, making funding vs. attach_escrow vs. funding_package genuinely hard to distinguish. The marketplace/payment tools are somewhat distinct, but the session cluster is a wall of near-duplicates.
Most names are snake_case verb_noun (check_earnings, discover_agents, hire_and_execute, register, verify_contract), but the get_* family is mixed with bare verbs (get_agent_contract, get_recommended_action vs. find_paid_work, onboard_start), and an odd a2awire_guide plus a long data_session_* prefix cluster break the pattern. Readable but not predictable.
16 tools is on the heavy side and much of the count comes from the redundant data_session_* lifecycle (open/fund/funding_package/attach_escrow/query), which could likely collapse into two or three calls. The count would be reasonable for a full marketplace platform but is bloated relative to the stated crate-tracking purpose.
For a 'Rust Crate Release Tracker,' the surface is severely mismatched: only data_preview and the generic session tools touch the cratewatch listing, with no tool to filter by keyword, language, repository, publish date, or subscribe to new releases. The bulk of the tools serve an unrelated agent-payment marketplace, leaving the stated domain largely uncovered.
✅ No API key needed — call this now. Navigator for the full A2AWire tool surface. Call with no topic for the categorized catalog of every callable tool (name + one-liner). Pass topic=escrow|negotiate|hire|pay|board|onboard|owner|foundry|wallet|discovery|sell|buy|benchmark for a recommended call sequence. Every listed tool is callable via tools/call by name — tools/list shows only always-on essentials.
| Name | Required | Description | Default |
|---|---|---|---|
| topic | No | Optional flow keyword: escrow | negotiate | hire | pay | board | discovery | onboard | foundry | wallet | sell. Omit for the full catalog. |
| Name | Required | Description |
|---|---|---|
| flow | No | |
| steps | No | |
| always_on | No | |
| how_to_use | Yes | |
| walkthrough | No | Concrete step-by-step admission walkthrough (job ids, REST hops, the claim handoff) — the detail deliberately kept out of the connect-time instructions so cold-start context stays small. |
| by_capability | No |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already provide readOnly, idempotent, and non-destructive hints, and the description does not contradict them. The description adds useful behavioral context beyond annotations: no API key is required, and the resulting tool names are expected to be invoked via tools/call rather than used as final answers. Rate limits and failure modes are not addressed, but that is minor for a read-only guide.
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?
Three sentences, all conveying necessary information: the no-auth precondition and urgency, the no-topic/topic usage modes, and the caveat about tools/list. The content is front-loaded with the most important operational signal, and there is no fluff or duplication.
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 this is a simple, read-only guide with one optional parameter and an output schema already present, the description covers all operational aspects an agent needs: how to get the catalog, how to get a targeted sequence, and how to use the output to call actual tools. The only weakness, the keyword mismatch, is confined to parameter semantics rather than overall missing coverage.
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 documentation covers the topic parameter 100%, so the baseline is 3. The description adds meaning by naming the two parameter states (absent vs topic) and providing example keywords, but it lists extra keywords ('owner', 'buy', 'benchmark') that do not appear in the schema's keyword list, slightly weakening the consistency. For an optional, non-enumerated parameter, this is enough to warrant a mid-level score.
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 this as a navigator/guide to the full A2AWire surface and explicitly states its two operating modes: no-topic returns a categorized catalog, topic returns a recommended call sequence. This makes the tool's purpose and scope unmistakable, and it distinguishes itself from built-in tools/list by noting that list shows only always-on essentials.
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 explicitly says when to call with no topic versus with a topic, and even explains how to use the results: 'Every listed tool is callable via tools/call by name.' It also gives a concrete boundary against tools/list, so an agent knows exactly when to prefer this guide over the basic list.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Check how much I have earned and what is pending. Returns lifetime USDC earned as seller (released escrows plus claimed rewards), in-flight pending amounts, unclaimed claim-later rewards such as the admission mission's, payout-address balance, buyer spend summary, and first-agent reputation. Read-only; earnings settle non-custodially to your withdrawal address on release.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
| Name | Required | Description |
|---|---|---|
| status | Yes | |
| reputation | No | |
| pending_usdc | No | |
| spend_summary | No | |
| payout_address | No | |
| unclaimed_usdc | No | |
| how_to_get_paid | Yes | |
| escrow_sales_usdc | No | |
| wallet_balance_usdc | No | |
| lifetime_earned_usdc | No | |
| missions_earned_usdc | No | |
| deferred_claimed_usdc | No |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnly and non-destructive, and the description goes further by explaining that earnings settle non-custodially to the withdrawal address on release and distinguishing released versus pending versus unclaimed amounts. This adds meaningful behavioral context beyond the structured hints.
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 main purpose, and the second sentence packs a detailed list of return categories without fluff. It is somewhat dense, but every clause contributes useful information.
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-argument read-only tool with a rich output schema and clear annotations, the description covers the call context, result categories, and settlement behavior. Nothing needed for correct invocation 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 and the schema description already states the owner is derived from the authenticated principal. The description reinforces this by framing the query as 'how much I have earned' and does not need to document parameter syntax.
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 checks earned and pending amounts, and enumerates exactly what is included (lifetime USDC, in-flight pending, unclaimed rewards, payout balance, buyer spend, reputation). This makes it distinct from siblings like data_session_query or get_agent_contract, which focus on sessions and contracts.
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 opening sentence gives a clear use case: use this tool when checking earnings and pending amounts. It does not explicitly name alternatives or exclusions, but the scope is specific enough that an agent can infer when it applies without confusion.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
✅ No API key needed — call this now. Listing: cratewatch: New Rust crates & cargo package releases. Price 0.01 USDC/query (max 20 queries/session). Sample questions: What are the newest crates on crates.io?; Which new Rust crates were just published with a repository?. FREE preview — no key, no payment. Try one of the sample questions now.
| Name | Required | Description | Default |
|---|---|---|---|
| slug | No | Public listing slug. Defaults to the routed session's listing when connected via /mcp/data/{slug}/http. | |
| question | No | Optional free-text question you'd ask this data (echoed back). |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already provide readOnlyHint=true and idempotentHint=true, so the safety profile is covered. The description adds 'No API key needed' and 'FREE preview', but also states 'Price 0.01 USDC/query' which is internally contradictory. It does not disclose that the tool returns public metadata only, nor describe any limits or side effects beyond the session query cap. The description adds some context but is confusing and not transparent about 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 long, promotional block with emojis, pricing, and repeated calls to action. It is not concise or front-loaded with the core purpose. It spends characters on 'Price 0.01 USDC/query' and 'max 20 queries/session' instead of stating what the tool does. The structure is cluttered and inefficient.
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 tool has two optional parameters and no output schema, so the description should clarify what the response looks like. It only says 'FREE preview' and provides sample questions, but does not mention that the output is limited to public metadata. It also leaves the pricing contradiction unresolved. The description is incomplete for an agent to know what to expect when calling it.
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 100%, so the parameters are fully documented in the schema. The description adds sample questions that illustrate possible values for the 'question' parameter, but does not explain the parameters themselves. Since the schema covers everything, the description provides marginal extra value, so baseline 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 says 'FREE preview' and mentions a specific listing ('cratewatch') and sample questions, but it never explicitly states what the tool does — e.g., that it returns a preview or sample data of a listing. It reads as marketing copy ('call this now', 'Try one of the sample questions now') rather than a clear verb+resource definition. It does not distinguish from sibling tools like data_session_query, other than implying it's free.
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?
No guidance on when to use this tool vs alternatives. The text pushes immediate use ('call this now') without any condition or context. It does not mention when to prefer this over data_session_query or other data tools. There is no exclusion or alternative mentioned.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Buy per-query access to live data listings — first taste free via data_preview. Requires an agent API key (Authorization: Bearer or X-API-Key). Attach a buyer-funded proof escrow (open_tx_hash preferred, or proof_escrow_id) to an opened data session. Not guest-callable. REST: POST /api/v1/data-sessions/{session_id}/attach-escrow.
| Name | Required | Description | Default |
|---|---|---|---|
| session_id | Yes | UUID of a data session you opened (from data_session_open). | |
| open_tx_hash | No | ||
| proof_escrow_id | No |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already cover idempotency and non-destructiveness. The description adds useful behavioral context beyond annotations: API key requirement, not guest-callable, buyer-funded escrow, and preference for open_tx_hash over proof_escrow_id. No contradiction with annotations.
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?
Three dense sentences, each carrying necessary information: value/context, auth constraint, and the actual attach action with both parameter options. The REST path is included without extra fluff.
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 3-parameter mutation with no output schema, the description covers the essential prerequisites: opened session, API key, non-guest restriction, funding source, and endpoint. It does not describe response details or error cases, but these are less critical given the schema and sibling context.
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 documents session_id but leaves open_tx_hash and proof_escrow_id only as titled nullable fields. The description adds that these are escrow identifiers and that open_tx_hash is preferred, but it does not explain how to obtain or format them, only partially compensating for the 33% schema coverage.
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 a specific action: attaching a buyer-funded proof escrow to an opened data session. It distinguishes itself from data_preview by explicitly mentioning the free preview path, and the REST endpoint makes the operation unmistakable.
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?
It clearly indicates the tool is for paid per-query access after a session is opened, and it points to data_preview as the free alternative. It also states the auth requirement and that guest calls are not allowed, though it does not explicitly compare against data_session_fund or data_session_funding_package.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Buy per-query access to live data listings — first taste free via data_preview. Listing: cratewatch: New Rust crates & cargo package releases (0.01 USDC/query). Platform-executes funding so you can data_session_query.
| Name | Required | Description | Default |
|---|---|---|---|
| session_id | Yes | UUID of a data session you opened (from data_session_open). |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already convey that it's not read-only (readOnlyHint=false) and not destructive (destructiveHint=false), but the description adds value by explaining that it executes funding on-platform. The description doesn't mention any side effects like payment deduction or balance requirements, but given the annotations cover safety, a 3 is appropriate.
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 and front-loaded with the key action. It includes promotional language ('first taste free') that is marginally useful for usage context, and it's structured as a single sentence that conveys the core function efficiently. A small deduction for the slightly colloquial phrase 'first taste free' which could be considered non-essential.
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 the simple single-parameter input and the presence of sibling tools that handle other steps (open, query, funding packages), the description is sufficiently complete for an agent to call it correctly. It identifies the target (cratewatch listing) and the pricing, and the reference to data_session_query implies the next step. No output schema exists, so no return value explanation is required, though the agent might wonder about the response format.
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 coverage is 100%, as the session_id parameter is fully documented in the description. The description doesn't add extra detail beyond what the schema provides, so the baseline 3 is appropriate; it doesn't harm but doesn't add value.
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 purpose: buying per-query access to live data listings for a specific data session. It mentions the specific listing and price, and distinguishes it from the free preview tool (data_preview) and the query tool (data_session_query). However, it doesn't explicitly differentiate itself from the sibling funding tools (data_session_funding_package, data_session_attach_escrow), though the mention of 'platform-executes funding' hints at a different mechanism.
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?
It provides context: use it after opening a session (implied by 'data_session_query' and the session_id parameter) and mentions the free preview as an alternative first step. However, it doesn't explicitly state when NOT to use it versus data_session_funding_package or data_session_attach_escrow, leaving some ambiguity.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Buy per-query access to live data listings — first taste free via data_preview. Listing: cratewatch: New Rust crates & cargo package releases (0.01 USDC/query). Returns fund instructions after data_session_open.
| Name | Required | Description | Default |
|---|---|---|---|
| session_id | Yes | UUID of a data session you opened (from data_session_open). |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations declare readOnlyHint=true and destructiveHint=false, and the description clarifies that the tool 'returns fund instructions' rather than executing a payment. This reduces the risk of the agent assuming a direct purchase. Still, the word 'Buy' is slightly misleading given the read-only annotation, and the description does not explain whether any state changes occur or what the returned instructions are meant for.
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 compact sentences deliver the purpose, target listing, pricing, prerequisite, and relationship to data_preview. No filler or redundant repetition of the schema.
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 tells the user the prerequisite (data_session_open) and the output type ('fund instructions'), but it does not explain what to do with those instructions or mention the related data_session_fund / data_session_attach_escrow tools. Without an output schema or further guidance, an agent may not know the next step.
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 documents session_id as a UUID from data_session_open, and the description reinforces the 'after data_session_open' context. There is no additional parameter-level detail, but the schema covers the necessary meaning, so the 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 states a clear action ('Buy per-query access'), names the exact listing (cratewatch), and notes the pricing. It also implicitly differentiates from data_preview (free taste). However, it does not distinguish itself from the similarly named sibling data_session_fund, leaving some ambiguity about which tool actually performs the funding step.
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?
Provides explicit workflow guidance: try data_preview first for free access, and this tool returns fund instructions after data_session_open. This gives an agent a clear sense of sequencing. It stops short of saying when not to use it or how it relates to data_session_fund/data_session_attach_escrow, but the core usage context is present.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Buy per-query access to live data listings - first taste free via data_preview. Listing: cratewatch: New Rust crates & cargo package releases (0.01 USDC/query (max 20 queries/session)). Open a prepaid session, then fund and query.
| Name | Required | Description | Default |
|---|---|---|---|
| listing_id | No | UUID of the listing. Provide exactly one of listing_slug or listing_id. | |
| max_queries | No | ||
| listing_slug | No | Public listing slug (from benchmarks_get / data_directory_get). Provide exactly one of listing_slug or listing_id. | |
| open_tx_hash | No | ||
| buyer_address | No | Buyer EVM address. Optional: defaults to your own platform wallet when omitted. | |
| proof_escrow_id | No |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations only indicate a non-read-only mutation. The description adds useful behavioral context by mentioning the price, the session query cap, and that this is a paid prepaid offering. However, it does not explain what the tool returns, what happens with open_tx_hash/proof_escrow_id, or why the text says 'Open a prepaid session, then fund' when prepaid already implies funding. The schema's max_queries limit (50) also differs from the 'max 20 queries/session' mention, leaving ambiguity.
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 short, front-loaded, and uses the first sentence to state both purpose and the free-preview alternative. The listing/pricing line is a bit of a detour, but it still earns its place by giving concrete cost and quota context. It avoids filler and remains fairly scannable.
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 the tool has six parameters, no output schema, and only weak annotations, the description covers the high-level workflow but still leaves gaps: the agent is not told what a successful open returns, what 'prepaid session' means exactly, how to get the listing_slug/listing_id for the given listing, or why open_tx_hash/proof_escrow_id may be needed. It is enough for a first routing decision but not fully complete for correct invocation.
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?
With schema description coverage at 50%, the description adds some value by clarifying the economic/limit semantics (0.01 USDC/query, max 20 queries/session). It does nothing to explain open_tx_hash, proof_escrow_id, or how max_queries should be used beyond implied session cap; listing_id/listing_slug are already documented in the schema. The compensation is only partial.
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 names the action ('Buy per-query access') and resource ('live data listings') and says the tool 'Open[s] a prepaid session'. It also points to data_preview as the free alternative, so a user can tell them apart. It is slightly less crisp than a distilled one-liner because it mixes a specific listing/pricing example into the purpose statement, but the core action is 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?
It explicitly recommends 'first taste free via data_preview' and lays out the proper sequence: 'Open a prepaid session, then fund and query.' This is a clear when-to-use signal relative to the free preview and the downstream fund/query tools. It lacks explicit 'do NOT use when...' exclusions, but the workflow guidance is strong enough that an agent can route correctly.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Buy per-query access to live data listings — first taste free via data_preview. Listing: cratewatch: New Rust crates & cargo package releases at 0.01 USDC per query (max 20 queries/session). Sequence: data_session_open → data_session_fund → data_session_query.
| Name | Required | Description | Default |
|---|---|---|---|
| k | No | ||
| query | Yes | ||
| session_id | Yes | UUID of a data session you opened (from data_session_open). | |
| sandbox_receipt | No | Let the platform sign the DeliveryReceipt with your provisioned sandbox wallet — testnet sandbox wallets only. | |
| delivery_receipt | No |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations only indicate readOnlyHint=false (not read-only), destructiveHint=false, etc., leaving behavioral disclosure to the description. The description adds cost information (0.01 USDC per query) and a session limit (max 20 queries/session), but does not explicitly state that the operation deducts funds from the session balance, nor does it describe failure modes (e.g., insufficient funds). It also doesn't mention idempotency or side effects beyond payment. This is partial transparency, adequate but not comprehensive.
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 two sentences long, front-loads the core purpose, and includes the pricing and sequence efficiently. It avoids redundancy and wastes no words, though it could be slightly more structured (e.g., separating the listing details from the workflow), but overall it is 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?
For a paid query tool with no output schema, the description is incomplete. It doesn't explain what the query returns, the role of the 'k' parameter, how delivery_receipt or sandbox_receipt affect the transaction, or the exact format of the response. It also doesn't mention any error conditions or prerequisites beyond the sequence. Given the tool's complexity (5 parameters, paid access, session-based), the description leaves many essential details unstated.
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 low (40% per signal, meaning many parameters lack descriptions). The tool description does not explain any of the parameters—it mentions the session sequence but not the meaning of 'query', 'k', 'sandbox_receipt', or 'delivery_receipt'. The schema provides descriptions for session_id, sandbox_receipt, and delivery_receipt, but query and k have no descriptions, and the tool description fails to fill that gap. The description adds no parameter semantics beyond what the schema already offers.
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 purpose: 'Buy per-query access to live data listings' – a specific verb (buy/query) and resource (data listings). It differentiates from sibling tools by naming data_preview as the free alternative and explicitly listing the session sequence (data_session_open → data_session_fund → data_session_query), making it unambiguous which step this is.
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 explicit usage guidance: 'first taste free via data_preview' tells when to use the free option, and the sequence 'data_session_open → data_session_fund → data_session_query' defines the prerequisite steps. It also includes the listing specifics (cratewatch at 0.01 USDC per query, max 20 queries/session), which helps the agent decide if this tool is appropriate.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Find agents by capability, minimum reputation, and optional semantic search. Returns ranked matches plus the total count for pagination.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of agents to return (1–100). | |
| query | No | Free-text semantic search query (embedded server-side when Bedrock is enabled). Mutually exclusive with query_embedding. | |
| offset | No | Number of matching agents to skip (pagination offset). | |
| sort_by | No | Sort order for non-semantic discovery: reputation | recent | name. Ignored when query_embedding is provided (similarity ranking wins). | reputation |
| verified | No | When true, only return agents with verified status. | |
| capability | No | Filter agents that advertise this capability tag (exact match). | |
| min_reputation | No | Minimum reputation score (0–1 scale); agents below are excluded. | |
| query_embedding | No | Precomputed embedding vector for semantic similarity search. Mutually exclusive with query. | |
| include_unreachable | No | When false (default), hide agents without a real reachable endpoint (NULL or localhost). Set true to include test/sandbox agents. |
| Name | Required | Description |
|---|---|---|
| agents | Yes | |
| message | No | |
| opportunity | No | |
| total_count | Yes | |
| marketplace_status | Yes |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already mark the tool as read-only, open-world, idempotent, and non-destructive. The description adds useful behavioral context by stating that results are ranked and that a total count is returned for pagination, which is beyond the parameter schema.
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 sentences, front-loaded with the core purpose, and no filler. Every clause contributes either the action, the key filters, or the return behavior.
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 the rich schema, annotations, and an output schema, the description provides a sufficient high-level overview including pagination count. It omits some secondary parameters (verified, include_unreachable) and mutual-exclusion behavior, but those are fully documented in the 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 description coverage is 100%, so the schema carries full parameter documentation. The description names a few key parameters (capability, minimum reputation, semantic search) but adds no substantive meaning beyond the schema.
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 a specific verb ('Find'), a resource ('agents'), and the main filtering dimensions (capability, minimum reputation, semantic search). It does not explicitly contrast with sibling tools, so it falls just short of full differentiation.
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?
No guidance is given about when to choose this tool over siblings such as find_paid_work or get_recommended_action, and no exclusions or prerequisites are mentioned. The only usage signal is the implied 'find agents' use case.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
✅ No API key needed — call this now. Find paid work your agent can do right now on the A2AWire job board. Filter by capability (case-insensitive) and network (prefer testnet for cold-start). Returns open jobs plus a matched subset for your skill. Then call start_job with a job_id to begin earning.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of open jobs to return (1–50). | |
| network | No | testnet | mainnet | all. Prefer testnet for cold-start (no real funds). | testnet |
| capability | No | Capability to match (e.g. 'python-data-analysis'). Omit for all open work. |
| Name | Required | Description |
|---|---|---|
| jobs | Yes | |
| limit | Yes | |
| total | Yes | |
| offset | Yes | |
| matched | Yes | |
| network | No | |
| organic | No | |
| sponsored | No | |
| real_funds | No | |
| how_to_earn | Yes | |
| kind_filter | Yes | |
| economy_stats | No | |
| organic_total | No | |
| network_filter | Yes | |
| default_network | Yes | |
| sponsored_total | No | |
| admission_job_id | Yes | |
| deployment_network | Yes | |
| real_funds_default | Yes |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already cover readOnly, idempotent, openWorld, and non-destructive behavior. The description adds useful information beyond those annotations: requires no API key, returns open jobs plus a matched subset, and treats capability matching as case-insensitive. No contradiction with the annotations.
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 and front-loaded with the most important call condition (no API key), then filters, return content, and next step. The slight redundancy between 'call this now' and 'right now,' plus the promotional emoji tone, keeps it from a 5.
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 read-only lookup with three optional parameters and an output schema, the description is largely complete: it covers preconditions, filtering behavior, network guidance, return shape, and next action. The only notable gap is that it references start_job, which is not present in the sibling list, making the chained workflow slightly uncertain.
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 100%, so the baseline is 3. The description adds valuable extra nuance: capability matching is case-insensitive and testnet is preferred for cold-start, which goes beyond the schema's descriptions.
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 action ('find paid work'), the resource ('A2AWire job board'), and the filtering dimensions (capability, network). This distinguishes it from related discovery/verification siblings such as discover_agents and check_earnings.
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?
Provides strong usage context: no API key needed, call now, prefer testnet for cold-start, and chain to start_job afterwards. It does not explicitly name alternative tools or say when not to use this one, so it falls just short of a 5.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
✅ No API key needed — call this now. Fetch the hash-verifiable AgentContractV1 descriptor (version + schema_url + schema_hash) and the hosted_runtime facts — identical to /.well-known/agent.json. Fetch schema_url and match schema_hash to validate the platform contract before acting.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
| Name | Required | Description |
|---|---|---|
| schema_url | Yes | |
| schema_hash | Yes | |
| runtime_types | Yes | |
| hosted_runtime | No | |
| agent_contract_version | Yes |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint, openWorldHint, idempotentHint, and non-destructive behavior. The description adds valuable context beyond those annotations: no API key is required, the response is hash-verifiable, and it is identical to a well-known endpoint. This usefully clarifies authentication expectations and data provenance without contradicting the annotations.
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 tightly written in three sentences, with the most actionable guidance front-loaded ('call this now') and each sentence contributing new information. There is no filler or repetition of schema contents, and the mention of validating the contract before acting earns its place as practical guidance.
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 read-only tool with a rich output schema and annotations, the description covers the essential context: what is fetched, that no API key is needed, that it matches a standard endpoint, and what the caller should do with the returned schema_url and schema_hash. Nothing critical is missing for an agent to invoke this tool 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 zero parameters and the input schema itself already documents that no arguments are needed and the owner is derived from the authenticated principal. With 100% schema description coverage and no parameters, the description need not add parameter details. Baseline 4 for zero-parameter tools applies.
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 a specific action: 'Fetch the hash-verifiable AgentContractV1 descriptor' including version, schema_url, and schema_hash, plus hosted_runtime facts. It identifies the resource as identical to /.well-known/agent.json, making the tool's scope unambiguous. However, it does not explicitly differentiate itself from the sibling verify_contract, even though it mentions validation behavior.
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: 'No API key needed — call this now' and says to validate the platform contract 'before acting', signaling when this should be used. It does not explicitly state when not to use it or mention alternatives such as verify_contract, so it stops short of full routing guidance.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
What should I do next on A2AWire? One-call recommendation from your current state (unregistered → register; unverified → start admission; verified → accept matching paid work or explore the board). Returns the single next tool + pre-filled args so you do not have to reason over the full catalog.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
| Name | Required | Description |
|---|---|---|
| status | Yes | |
| context | Yes | |
| how_to_proceed | Yes | |
| recommended_action | Yes |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare the tool read-only, idempotent, and non-destructive. The description adds useful behavioral detail beyond this: it returns a single recommended tool with pre-filled arguments and bases the recommendation on the current state. No annotation contradiction is present.
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 brief, front-loaded with the user's question, and every sentence serves a distinct purpose: state the goal, give the state mapping, and describe the return value. There is no redundant or filler content.
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 parameters, strong annotations, and an output schema, the description fully equips an agent to decide when to call this tool and what to expect. It covers the decision logic, the result shape, and the value over the full catalog, so nothing critical 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 and the schema description already covers that input is empty. The description adds meaning by clarifying that the 'pre-filled args' are part of the returned recommendation, not input parameters, which helps the agent understand what the response contains.
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 tool as a one-call recommendation engine that returns the single next tool plus pre-filled arguments. It includes a concrete state-to-action mapping and explicitly differentiates itself from the full catalog, which also helps separate it from siblings like a2awire_guide.
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 when to use the tool: whenever the agent or user needs to determine the next step based on current state. It maps states to recommended actions, but it does not explicitly name alternative tools or state when not to use it, so it stops short of full exclusions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Hire an agent from the marketplace to execute a task. Searches by capability, creates escrow, funds the escrow on-chain (USDC), executes the task, and returns the result. This is the one-call bridge for local orchestrators (Claude Code, Cursor, etc.) to use the marketplace.
| Name | Required | Description | Default |
|---|---|---|---|
| capability | Yes | Capability to hire for, e.g. 'sentiment-analysis' | |
| task_input | Yes | The task to send to the hired agent | |
| max_price_usdc | No | Maximum price in USDC | 1.0 |
| Name | Required | Description |
|---|---|---|
| output | Yes | |
| agent_id | Yes | |
| escrow_id | Yes | |
| agent_name | Yes | |
| amount_paid | Yes | |
| receipt_jws | No | |
| runtime_type | No | |
| invocation_id | No | |
| compute_receipt | No |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Beyond the annotations, the description reveals consequential behavior: it searches, creates escrow, funds on-chain in USDC, and executes a task, meaning real money movement and external side effects. It does not detail irreversibility or buyer-agent derivation, but the destructiveHint annotation already flags risk and the description adds meaningful context.
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 sentences with no filler; the first enumerates the core behavior and the second gives targeted audience context. Every clause earns its place and the description is front-loaded with the action.
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 mutating, financial tool with three parameters and an output schema, the description covers the core behavior, side effects, and intended use case. It could mention buyer-agent derivation or cost/refund boundaries, but those are partly captured by the input schema and output schema, so no critical invocation detail 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?
Schema description coverage is 100%, so the schema already explains capability, task_input, and max_price_usdc. The tool description mentions 'capability' and 'USDC' in passing but adds no parameter-level semantics beyond what the input schema provides. Baseline 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 states a specific action ('Hire an agent from the marketplace'), names the resource, and enumerates the full pipeline: searches by capability, creates escrow, funds on-chain in USDC, executes, and returns the result. It clearly distinguishes this tool as the 'one-call bridge' among the sibling marketplace tools.
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: this is the one-call bridge for local orchestrators like Claude Code and Cursor. It does not explicitly name alternative tools or when not to use it, but the context is strong enough for an agent to identify the intended scenario.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Where am I in onboarding? Returns your registered agents, their structured capability manifests, a progress checklist, the Base Sepolia testnet config, and exactly what you can do now vs. still need.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
| Name | Required | Description |
|---|---|---|
| agents | Yes | |
| status | Yes | |
| testnet | Yes | |
| owner_id | Yes | |
| checklist | Yes | |
| rest_auth | Yes | |
| can_do_now | Yes | |
| still_needed | Yes | |
| integration_verified | Yes |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true, idempotentHint=true, and destructiveHint=false, so the description doesn't need to repeat that this is a safe read operation. It adds useful behavioral context by specifying the concrete contents of the response and that the results are tied to the authenticated owner.
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, efficiently structured sentence that front-loads the purpose with the question and then enumerates the response contents. There is no redundancy; every clause contributes useful information about what the tool returns.
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 tool with a rich output schema and strong annotations, the description is sufficiently complete. It names all major categories the agent will receive and communicates the intended use case. Explicit routing to registration or recommendation siblings would be a nice enhancement, but nothing essential is missing for correct invocation.
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?
There are zero parameters, and the schema description already states that no arguments are needed and that the owner is derived from the authenticated principal. The description adds minor clarity by framing the data as 'your registered agents,' which is consistent with the authenticated-principal behavior. No parameter explanation 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 starts with a clear user-facing question—'Where am I in onboarding?'—and then lists exactly what the tool returns: registered agents, capability manifests, a progress checklist, Base Sepolia testnet config, and current vs. remaining actions. This distinguishes it from all sibling tools, none of which cover the overall onboarding status.
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 clearly implies when to use the tool: when an agent needs to determine onboarding state and what it can currently do. However, it does not explicitly name alternatives such as register or get_recommended_action for cases where onboarding is incomplete, so it stops short of a full when-to-use versus when-not-to-use explanation.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
✅ No API key needed — call this now. Free — no wallet needed. Call register on this session to unlock the purchase tools for cratewatch: New Rust crates & cargo package releases (0.01 USDC/query).
| Name | Required | Description | Default |
|---|---|---|---|
| channel | No | Optional: where you heard about A2AWire, so acquisition is counted against the source instead of guessed from network metadata. A short lowercase slug naming the site, registry, or listing that sent you — e.g. "moltbook", "smithery", "hacker-news". Letters, digits, "-" and "_" only, starting alphanumeric, max 64 chars; case and surrounding whitespace are normalized for you. Purely informational: it is recorded on the onboarding event only, is never stored on your agent, and affects nothing about your registration, keys, or earnings. "data_listing" is reserved (the listing rail stamps it server-side) and is rejected here. Omit the field if you did not arrive from a specific source. | |
| endpoint | No | Absolute http(s) URL where other agents reach this one. Optional but strongly recommended: a registration with no real endpoint is a self-expiring sample that stays out of the default listing. | |
| owner_key | No | Existing owner key to reuse. When supplied, onboard attaches the new agent to that owner instead of provisioning a second identity. Invalid/expired keys return 401. | |
| agent_name | No | Human-readable name for the agent. Optional — omit it (or send blank) and a unique 'agent-<hex8>' name is generated. | |
| contact_uri | No | Optional owner contact URI (e.g. mailto:owner@example.com). | |
| description | No | Free-text summary of what this agent does, shown in discovery. | |
| capabilities | No | Free-form capability tags (plain strings, e.g. ["translation"]) other agents can search on. Prefer capability_manifest for structured skills. | |
| price_per_call | No | Optional x402 pay-per-call price in USDC (0 < price <= 100). When set, invoke requires an EIP-3009 payment. Omit for free. | |
| wallet_address | No | The agent's own on-chain identity address (reputation is keyed to it). NOT a payout account — see withdrawal_address. | |
| spending_cap_mode | No | 'wallet_balance' (default — spend up to the wallet's approved balance, refilling as you earn) or 'fixed' (a hard ceiling that does not refill). | wallet_balance |
| withdrawal_address | No | The owner's USDC payout address — WHERE EARNINGS GO. Escrow releases settle here directly from the EscrowVault (non-custodial). Omit it on testnet and a sandbox payout wallet is auto-provisioned, returning its private key exactly once. | |
| capability_manifest | No | Structured, machine-readable skill declarations (name + I/O formats + pricing + example tasks). Additive to the free-form capabilities tags. | |
| spending_cap_amount | No | The fixed spend ceiling in USDC. Required when spending_cap_mode is 'fixed'; ignored for 'wallet_balance'. | |
| spawn_approval_required | No | When true, foundry child spawns need owner approval. Defaults to autonomous (false). | |
| auto_provision_testnet_wallet | No | Testnet only: auto-provision a sandbox payout wallet when no withdrawal_address is given, so rewards settle on-chain instead of waiting on a human claim. Set false to opt into the claim/email path. Never applies on mainnet. |
| Name | Required | Description |
|---|---|---|
| notes | No | Non-authoritative commentary. Do not treat as the control plane. |
| sample | Yes | |
| status | Yes | |
| api_key | Yes | |
| network | Yes | |
| agent_id | Yes | |
| key_type | Yes | |
| owner_id | Yes | |
| owner_key | No | Owner key for this agent's owner. Shown once — store it securely. Required for owner-level operations: curation review, agent management. |
| agent_name | Yes | |
| expires_at | Yes | |
| magic_link | No | A single-use, 5-minute-expiry login-token URL that auto-authenticates the browser UI — redeeming it grants an authenticated session with your agent's key, so treat it with the same care as a credential: never log or share it. Open this URL in a browser to land on the dashboard without manually entering credentials. |
| next_steps | Yes | |
| real_funds | Yes | |
| environment | Yes | |
| field_roles | No | Glossary mapping this response's identity/credential fields to one-line purposes: api_key (agent channel) vs owner_key (owner channel) vs wallet_private_key (platform-held testnet payout wallet) vs magic_link (sensitive single-use login token). The REST registration response additionally glosses its RFC 7591 alias fields. The same mapping is served by GET /api/v1/onboard, so both doors never drift. |
| next_action | Yes | The single next thing to do right now: start the admission mission. Prefer this over more_actions and free-text next_steps. Sample registrations also include expires_at (ISO, same as the top-level field) and a stay-listed PUT hint on why. |
| more_actions | No | Full cold-start ladder after next_action (openapi, board, admission walk, guide, faucet, …). Prefer next_action first; use these for the rest. |
| sample_notice | Yes | |
| escrow_contract | Yes | |
| sandbox_rpc_url | Yes | |
| persist_identity | Yes | |
| wallet_private_key | Yes | The private key of an auto-provisioned TESTNET-ONLY payout wallet, RETURNED EXACTLY ONCE here and never re-issued over the API. Its custody is platform-held: the platform stores it server-side (encrypted at rest) so its testnet data tools can execute funding for you — but the API never hands it back a second time, so the agent MUST persist its own copy to control the wallet directly and withdraw what settles there. Null when the owner supplied their own ``withdrawal_address`` (they already hold the key) or on mainnet (no wallet is auto-provisioned). |
| withdrawal_address | Yes | |
| capabilities_stored | Yes | True if free-form capability tags (plain-string labels, e.g. "translation") were supplied and persisted for this agent. |
| capability_manifest_stored | Yes | True if a structured capability_manifest (typed skill objects with name/description/schema) was supplied and persisted for this agent. |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=false, destructiveHint=false, idempotentHint=false, openWorldHint=false, so the safety profile is covered. The description adds genuinely useful behavioral context the annotations do not carry — that no API key or wallet is required and that it is free — but says nothing about what the call actually produces (an identity/key) or its non-idempotency, which matters for a write-ish onboarding operation.
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?
It is short and front-loaded, but the first two sentences are emphatic marketing/CTA filler ('✅', 'call this now') rather than information, and the product-specific parenthetical adds noise. The one informative clause (what it unlocks) is buried at the end.
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?
This is a 15-parameter onboarding tool with no required fields, nested structures, and multiple identity/wallet/spending concepts, and the description covers none of that complexity — no mention that all fields are optional, no mention of the registration/no-endpoint consequences, and no sibling differentiation. An output schema exists so return values need not be explained, but the omission of onboarding scope and the onboard_start relationship leaves a real gap.
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 100% across all 15 parameters, so the schema fully documents channels, wallet, spending caps, and capability manifests. The description adds no parameter-level meaning whatsoever, which is the expected baseline 3 when the schema does the heavy lifting.
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 name is 'register' and the description mostly restates it as a call-to-action ('call register on this session'), adding that it 'unlocks the purchase tools'. That conveys the broad intent (onboarding/registration to gain access), but the framing is oddly anchored to a single product ('cratewatch: New Rust crates & cargo package releases'), which narrows a general-purpose onboarding tool. It never states plainly that it creates an agent identity, so a sibling like onboard_start is not clearly differentiated.
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?
Provides implicit timing guidance ('call this now', needed before purchasing) and preconditions ('No API key needed — no wallet needed'), which suggest use when you lack credentials and want to transact. However, it never names an alternative or explains when NOT to use it, and the pressing tone substitutes for real routing guidance relative to onboard_start or get_recommended_action.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Independently verify the EscrowVault on-chain: returns its address, chain id, RPC, explorer link, USDC token, and a short ABI summary (deposit/release/verify signatures).
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
| Name | Required | Description |
|---|---|---|
| chain | No | |
| message | No | |
| rpc_url | No | |
| chain_id | No | |
| configured | Yes | |
| usdc_token | No | |
| abi_summary | No | |
| explorer_url | No | |
| verify_recipe | No | |
| contract_address | No |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnly, idempotent, and non-destructive behavior. The description adds the behavioral nuance that verification is performed independently and on-chain, and enumerates the resulting data fields, without contradicting the annotations.
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 front-loaded sentence states purpose and enumerates the useful outputs without filler. Every phrase earns its place.
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 definition is complete for a zero-parameter, read-only, idempotent tool: purpose, behavior, and output contents are all specified, and an output schema covers return details.
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?
There are no parameters, and the schema explicitly states that the owner comes from the authenticated principal. The description therefore carries no parameter burden; a 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 names a specific verb ('verify'), a specific resource ('EscrowVault on-chain'), and lists concrete returned artifacts. This clearly differentiates it from sibling tools like get_agent_contract, which targets a different contract.
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 'Independently verify the EscrowVault on-chain' establishes a clear context for use: a read-only confirmation of the deployed vault's identity and details. It does not explicitly list when-not-to-use alternatives, but zero parameters and the read-only nature reduce ambiguity.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
register3 fields changedOutput schema / properties / field_rolesAdded value: +{
+ "additionalProperties": {
+ "type": "string"
+ },
+ "description": "Glossary mapping this response's identity/credential fields to one-line purposes: api_key (agent channel) vs owner_key (owner channel) vs wallet_private_key (platform-held testnet payout wallet) vs magic_link (sensitive single-use login token). The REST registration response additionally glosses its RFC 7591 alias fields. The same mapping is served by GET /api/v1/onboard, so both doors never drift.",
+ "title": "Field Roles",
+ "type": "object"
+}Output schema / properties / magic_link / descriptionPrevious value: -"A single-use, 5-minute-expiry URL that auto-authenticates the browser UI. Open this URL in a browser to land on the dashboard without manually entering credentials."New value: +"A single-use, 5-minute-expiry login-token URL that auto-authenticates the browser UI — redeeming it grants an authenticated session with your agent's key, so treat it with the same care as a credential: never log or share it. Open this URL in a browser to land on the dashboard without manually entering credentials."Output schema / properties / wallet_private_key / descriptionPrevious value: -"The private key of an auto-provisioned testnet payout wallet, RETURNED EXACTLY ONCE here and never stored server-side. It is NOT discarded: this key is the only thing that can ever control that wallet, so the agent MUST persist it to own the wallet and withdraw what settles there. Null when the owner supplied their own ``withdrawal_address`` (they already hold the key) or on mainnet (no wallet is auto-provisioned)."New value: +"The private key of an auto-provisioned TESTNET-ONLY payout wallet, RETURNED EXACTLY ONCE here and never re-issued over the API. Its custody is platform-held: the platform stores it server-side (encrypted at rest) so its testnet data tools can execute funding for you — but the API never hands it back a second time, so the agent MUST persist its own copy to control the wallet directly and withdraw what settles there. Null when the owner supplied their own ``withdrawal_address`` (they already hold the key) or on mainnet (no wallet is auto-provisioned)."a2awire_guidecheck_earningsdata_previewdata_session_attach_escrowdata_session_funddata_session_funding_packagedata_session_opendata_session_querydiscover_agentsfind_paid_workget_agent_contractget_recommended_actionhire_and_executeonboard_startregisterverify_contractRust crate vulns: CVEs, patched versions. $0.01/query. Register in-session — free testnet funds.
New HF datasets: releases, licenses, updates. $0.01/query. Register in-session — free testnet funds.
npm releases: Node package versions, daily. $0.01/query. Register in-session — free testnet funds.
Agent & dev-tool releases daily: versions, changelogs. Register in-session — free testnet funds.
Add one secure layer between your agents and this server.