Skip to main content
Glama

Wisely x402 Agent-Payment Infrastructure

Server Details

Self-facilitated x402/MCP payments for hosted endpoints, rail proofs, receipts, and agents.

Status
Healthy
Last Tested
Transport
Streamable HTTP
URL
Repository
WiselyEnterprisesLLC/pablito-settlement-sentinel
GitHub Stars
0

Glama MCP Gateway

Connect through Glama MCP Gateway for full control over tool access and complete visibility into every call.

MCP client
Glama
MCP server

Full call logging

Every tool call is logged with complete inputs and outputs, so you can debug issues and audit what your agents are doing.

Tool access control

Enable or disable individual tools per connector, so you decide what your agents can and cannot do.

Managed credentials

Glama handles OAuth flows, token storage, and automatic rotation, so credentials never expire on your clients.

Usage analytics

See which tools your agents call, how often, and when, so you can understand usage patterns and catch anomalies.

100% free. Your data is private.
Tool DescriptionsC

Average 3.1/5 across 65 of 65 tools scored. Lowest: 2.3/5.

Server CoherenceD
Disambiguation1/5

The tool set is riddled with aliases and duplicates (e.g., start_here, wisely_start_here, get_playbook, agent_instructions, readme, wisely_get_playbook, wisely_agent_instructions all serve the same purpose). Dozens of status tools and setup aliases overlap heavily, making it nearly impossible for an agent to select the right tool without testing.

Naming Consistency2/5

There is a mix of x402_ and wisely_ prefixes, plus unprefixed generic tools like start_here, connect_wallet, and readme. Alias names diverge from their canonical names (e.g., connect_wallet vs x402_wallet_handoff), and while snake_case is consistent, the pattern is not predictable across the full set.

Tool Count1/5

65 tools is far beyond what is typically appropriate for an MCP server (3-15). The count is inflated by aliases and many near-identical status/check tools, creating a bloated surface that is unnecessarily heavy and confusing for agents.

Completeness3/5

Core payment, wallet, receipt, and quote workflows are well covered. However, there are significant gaps in actual builder endpoint management (only handoff instructions, no direct create/update/delete tools) and creator catalog lifecycle (preview and onboarding handoff but no publish/update/delete tools), leaving some workflows as dead ends.

Available Tools

65 tools
agent_instructionsCInspect

Generic alias for start_here. Useful for agents and probes looking for instructions before using paid tools.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior2/5

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

With no annotations, the description carries the full burden for behavioral disclosure. It only says 'generic alias' and 'instructions', implying a read-like, non-destructive operation, but it does not describe what the tool actually returns, whether it forwards parameters, or any side effects. This is a significant gap given zero annotation coverage.

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

Conciseness5/5

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

The description is a single, compact sentence that immediately names the tool as an alias and states its use case. Every word earns its place; there is no fluff or repetition.

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

Completeness1/5

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

Given the overwhelming parameter count (43), no output schema, and a very large sibling set, a one-sentence alias description is grossly inadequate. The agent is left without any guidance on invocation, return shape, parameter selection, or how this alias relates to the nearly identical start_here tool. The description fails to compensate for the structural complexity.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The description provides no parameter information whatsoever. With 43 parameters and only 33% schema description coverage, the tool is highly complex and the description adds nothing to help an agent understand which parameters are relevant or how they map to the underlying start_here tool. The schema itself is largely opaque.

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

Purpose4/5

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

The description clearly states this is a 'generic alias for start_here', giving a specific resource and identifying its role as an entry point for instructions. It distinguishes itself as an alias, though it does not elaborate on the content or scope of the instructions.

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

Usage Guidelines3/5

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

It provides a useful context cue: 'useful for agents and probes looking for instructions before using paid tools'. However, it does not explicitly compare against sibling tools like start_here, wisely_start_here, or wisely_agent_instructions, nor does it state when not to use this alias.

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

connect_walletBInspect

Plain-English alias for x402_wallet_handoff. Use when a user asks how to connect a wallet to ChatGPT or another MCP agent for Wisely x402 payments. Returns a hosted signing URL with wallet-app links and provider selection.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior3/5

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

With no annotations, the description must carry the burden of behavioral disclosure. It does state that it returns a hosted signing URL with wallet-app links and provider selection, which indicates a read-ish operation. But it does not disclose whether a session must already exist, potential side effects, or authentication requirements, leaving several behavioral aspects unclear.

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

Conciseness4/5

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

The description is concise, with three short sentences that front-load the essential facts: what it is, when to use it, and what it returns. It avoids fluff and is easy to parse, though it could be slightly more comprehensive without losing conciseness.

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

Completeness2/5

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

For a tool with a massive 43-parameter schema and no output schema, this description is insufficient. It tells the agent the purpose and output but not which parameters are required, how to construct the handoff request, or what the hosted URL workflow entails. The alias relationship to x402_wallet_handoff is stated, but the agent still lacks information to invoke it correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is only 33% with 43 parameters, so the description must compensate. It does not mention any parameters, their purpose, or how they relate to the handoff. The sole hint about 'provider selection' vaguely relates to preferredNetwork but fails to explain the input requirements. This is a critical gap for correct invocation.

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

Purpose5/5

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

The description explicitly states it is a plain-English alias for x402_wallet_handoff, names the exact use case (connecting a wallet for Wisely x402 payments), and describes the output (hosted signing URL). This clearly distinguishes it from other wallet-related sibling tools.

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

Usage Guidelines4/5

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

It gives an explicit trigger: 'Use when a user asks how to connect a wallet...' This provides clear context for when to invoke the tool. However, it does not mention exclusions or alternatives, such as when to use the local bridge setup tools instead.

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

download_skillBInspect

Alias for install_skill. Use when an agent or user asks how to download, install, or add Wisely abilities without ClawMart.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior2/5

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

Annotations are empty, so the description carries the full burden. It only discloses that the tool is an alias for install_skill, but gives no details on side effects, prerequisites, return values, or anything about how install_skill behaves. This is minimal transparency for a 43-parameter tool.

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

Conciseness3/5

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

The description is very concise (two short sentences) and front-loaded with the alias and usage trigger. However, given the tool's complexity (43 parameters), it is under-specified, making it more 'under-descriptive' than appropriately concise.

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

Completeness1/5

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

With 43 parameters, no output schema, no annotations, and a description that only covers the alias and usage trigger, the tool is severely under-specified. The description is far from complete enough for an agent to invoke the tool correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema has 43 parameters with only 33% description coverage, so the description needs to compensate. It provides zero additional parameter semantics. No explanation of any of the many parameters, which is inadequate.

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

Purpose4/5

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

The description clearly identifies the tool as an alias for install_skill, which conveys its core purpose. It also specifies the exact trigger context ('asks how to download, install, or add Wisely abilities'), making the intent unambiguous. However, it does not describe any standalone behavior beyond being an alias.

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

Usage Guidelines5/5

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

The description explicitly states when to use this tool: 'when an agent or user asks how to download, install, or add Wisely abilities without ClawMart.' It also implies a contrast with ClawMart-based installations, giving clear guidance on when not to use it.

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

get_playbookCInspect

Generic alias for start_here. Useful for agents and probes looking for an MCP server playbook.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior2/5

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

Annotations are empty, so the description carries the full burden of behavioral disclosure. It only states that the tool is a 'generic alias for start_here' and that it is 'useful for agents and probes looking for an MCP server playbook,' but it does not describe what the tool does, what it returns, whether it has side effects, or any constraints. This is minimal context but not misleading; it lacks substantive behavioral detail.

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

Conciseness5/5

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

The description is two short sentences and is front-loaded with the core fact ('Generic alias for start_here' followed by the audience). Every sentence adds value: one defines the relationship and one states the intended use case. There is no filler or redundancy, making it appropriately concise for the information it conveys.

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

Completeness1/5

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

This tool has 43 parameters, no annotations, no output schema, and nested objects, yet the description provides almost no contextual guidance. It does not explain what an 'MCP server playbook' is, how an agent should choose parameters, what the response looks like, or how this relates to the many sibling playbook/instruction tools. The description is far too sparse for the tool's complexity, leaving agents to guess or rely on the schema alone.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 43 parameters with only 33% description coverage, so the description must compensate by explaining parameter usage. The description mentions zero parameters and provides no parameter-level guidance. Saying it is an 'alias for start_here' may imply the same parameters exist, but it does not explain which of the 43 parameters are relevant or how to use them. This is a critical gap.

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

Purpose4/5

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

The description clearly identifies the tool as a 'Generic alias for start_here' and states its use case: 'agents and probes looking for an MCP server playbook.' It names the primary sibling (start_here) and uses 'generic' to imply a broad-purpose alias, which distinguishes it from more specialized siblings like wisely_get_playbook or wisely_start_here. However, it does not explain what 'playbook' means or what the tool actually returns, so it is clear but not fully specific.

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

Usage Guidelines3/5

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

The description provides a usage context ('useful for agents and probes looking for an MCP server playbook') and identifies the canonical tool it aliases (start_here), giving some guidance on when to use it. However, it does not explicitly say when not to use it or how it compares to alternatives such as agent_instructions, readme, or wisely_get_playbook. The guidance is implied rather than explicit, so it meets the minimum viable bar but lacks exclusions.

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

gift_card_wallet_bridge_setupBInspect

Alias for setup_local_wallet_bridge. Use for crypto-to-gift-card flows where the user signs locally and wants receipts or gift-card records saved locally.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior2/5

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

With no annotations, the description carries the full burden. It only hints at local signing and local record-saving behavior, but does not disclose prerequisites, side effects, required permissions, or what the setup entails. This is minimal for a setup tool that likely mutates local state.

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

Conciseness5/5

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

Two short sentences deliver the essential alias relationship and usage context with no filler. The description is front-loaded and every word earns its place.

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

Completeness2/5

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

For a tool with 43 parameters, no annotations, and no output schema, this description is too sparse. It omits setup steps, required inputs, return values, and any behavioral details beyond the high-level flow. The alias reference helps but does not make the description self-sufficient.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is only 33% across 43 parameters. The description does not compensate by explaining any parameters or how the gift-card flow maps to the schema. It adds no parameter-level meaning beyond what is already in the schema.

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

Purpose4/5

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

The description identifies the tool as an alias for setup_local_wallet_bridge and specifies a concrete use case: crypto-to-gift-card flows with local signing and saved receipts/gift-card records. This clearly indicates what the tool is for, though it relies on the alias relationship rather than stating an independent verb-resource action.

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

Usage Guidelines4/5

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

The description explicitly says 'Use for crypto-to-gift-card flows where the user signs locally and wants receipts or gift-card records saved locally.' This gives clear when-to-use context, but it does not mention when not to use it or alternatives beyond the alias reference.

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

install_skillCInspect

Plain-English install/download alias. Returns the portable Wisely package profile, GitHub install command, MCP URL, CLI commands, and local bridge setup path for OpenClaw, Hermes-style agents, ChatGPT MCP clients, and generic MCP clients.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior2/5

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

Annotations are empty, so the description carries the full burden of behavioral disclosure. It says the tool 'returns' information, which hints at a read-only alias, but it never explicitly states that it does not install or download anything, nor does it mention side effects, authentication needs, or response format. For a tool named install_skill with no annotation safety hints, this ambiguity is a notable gap.

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

Conciseness4/5

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

The description is one sentence, front-loaded with the core idea ('Plain-English install/download alias'), and efficiently lists the returned items. It is compact and readable, though the enumerated client list adds some length without much differentiation. Still, it earns a strong score for economy of words.

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

Completeness2/5

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

This is a high-complexity tool—43 optional parameters, no output schema, no annotations—yet the description gives only a high-level list of outputs. It lacks information about return structure, which parameters are essential, how client-specific outputs vary, or how to choose among sibling tools. For a tool with this complexity, the description is incomplete and leaves the agent without enough context to invoke it correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema has 43 parameters with only 33% description coverage, so the description should compensate by explaining which parameters matter and how they map to the stated outputs. It does not. It only lists output categories (package profile, GitHub command, MCP URL, CLI commands, bridge path) without linking any to inputs like platform, localPort, or client type. This provides zero additional parameter-level meaning.

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

Purpose4/5

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

The description clearly says it is a 'Plain-English install/download alias' and enumerates the returned artifacts (package profile, GitHub install command, MCP URL, CLI commands, bridge setup path). This makes the primary purpose understandable. However, the word 'alias' is slightly ambiguous about whether the tool actually installs something or only returns instructions, and it does not explicitly distinguish itself from sibling tools like download_skill or wisely_install_profile.

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

Usage Guidelines2/5

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

The description provides no explicit guidance on when to use this tool versus alternatives. It mentions target clients (OpenClaw, Hermes-style agents, ChatGPT MCP clients, generic MCP clients) but does not explain when to choose this over download_skill, wisely_install_profile, or any bridge setup tool. There are no exclusions, prerequisites, or alternative recommendations.

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

local_browser_bridge_setupCInspect

Alias for wisely_local_commerce_bridge_setup. Use for local browser, DoorDash, merchant checkout, or user-owned session setup.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior2/5

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

With no annotations provided, the description carries the full burden of behavioral disclosure but only reveals that it is an alias. It does not describe what the setup entails, whether it is read-only or mutating, what side effects occur, or what the return value looks like.

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

Conciseness3/5

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

The description is only two sentences with no wasted words, but its extreme brevity is disproportionate for a tool with 43 parameters and no other context. It is under-specified rather than effectively concise, so it earns a mid-range score.

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

Completeness1/5

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

Given the tool's high complexity (43 params, nested objects, no output schema, empty annotations), the description is drastically incomplete. It fails to explain the tool's behavior, expected inputs, or outcomes beyond its alias and general use cases, making it inadequate for an agent.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The description offers no parameter-level guidance. With schema coverage at only 33%, the description should compensate for undocumented parameters, but it ignores all 43 parameters entirely, leaving the agent to rely on sparse schema information.

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

Purpose4/5

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

The description clearly identifies this tool as an alias for wisely_local_commerce_bridge_setup and specifies distinct use contexts (local browser, DoorDash, merchant checkout, user-owned session setup). It gives a clear sense of what the tool is for, though it lacks an explicit action verb like 'sets up' or 'configures.'

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

Usage Guidelines4/5

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

It explicitly states when to use the tool by listing specific scenarios and indicates the alias target as an alternative. However, it does not provide exclusions or compare with other sibling setup tools like wallet_bridge_setup, so it falls short of full guidance.

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

readmeCInspect

Return the MCP-native README/playbook summary with docs links, workflows, safety rules, and recommended next calls.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior3/5

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

Annotations are empty, so the description carries the full transparency burden. The verb 'Return' implies a read-only operation and the description lists output contents, but it does not disclose side effects, network behavior, auth needs, or safety profile beyond the content list.

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

Conciseness5/5

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

The description is a single, front-loaded sentence that efficiently communicates the tool's deliverable and its main components. No filler or redundant wording.

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

Completeness2/5

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

The tool has a huge parameter schema, no output schema, no annotations, and many sibling tools with overlapping names. The description provides only the basic content list and no usage context, parameter relevance, or disambiguation, making it minimally viable but not complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With 43 parameters and only 33% schema description coverage, the description needed to explain which parameters are relevant to readme. It mentions none, leaving the agent to guess among a large, mostly irrelevant-looking set of optional parameters. This is a critical gap.

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

Purpose4/5

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

The description uses a specific verb ('Return') and names a concrete resource ('MCP-native README/playbook summary'), along with key contents. It is clear, but it does not explicitly differentiate from sibling tools like get_playbook, start_here, or agent_instructions.

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

Usage Guidelines2/5

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

There is no guidance on when to use this tool versus the many similarly purposed siblings, such as start_here, get_playbook, wisely_get_playbook, or agent_instructions. The usage is only implied, not stated with exclusions or alternatives.

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

setup_local_commerce_bridgeBInspect

Plain-English alias for wisely_local_commerce_bridge_setup. Use when a ChatGPT/OpenClaw/Hermes-style agent needs to help the user install the localhost bridge for DoorDash, merchant checkout, local wallet signing, and local receipt/gift-card storage.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior2/5

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

With annotations empty, the description carries the full burden of disclosing side effects, prerequisites, or system changes. It only states that it installs a bridge but does not mention what files, processes, ports, or configuration changes occur, nor whether the operation is reversible or requires elevated privileges. This is a significant gap for a setup tool.

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

Conciseness5/5

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

Two short sentences, front-loaded with alias status, no redundancy, and every phrase earns its place. It is appropriately sized for the limited information it conveys.

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

Completeness1/5

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

This is a high-complexity tool (43 params, no output schema, no annotations) but the description only provides a one-line purpose. It omits setup steps, expected outcomes, relevant parameters, and behavioral caveats. The description is inadequate for an agent to invoke the tool correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is only 33% across 43 parameters, so the description must compensate for the undocumented parameters. It does not mention any parameter, recommend which ones to use, or clarify the meaning of the generic fields. The description adds zero value for parameter selection.

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

Purpose5/5

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

The description clearly states this is an alias for wisely_local_commerce_bridge_setup and names the specific resource: installing a localhost bridge for DoorDash, merchant checkout, local wallet signing, and receipt/gift-card storage. This is a specific verb+resource+scope, and it distinguishes itself from sibling setup tools like setup_local_wallet_bridge.

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

Usage Guidelines4/5

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

The description provides an explicit 'Use when' condition, specifying the agent style and the installation scenario. It does not explicitly list exclusions or alternative tools, but naming the alias target and the use case gives adequate context for routing. A clear when-to-use with no exclusions is slightly above 'clear context'.

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

setup_local_wallet_bridgeAInspect

Alias for wisely_local_commerce_bridge_setup focused on local wallet signing and proof storage. Returns setup instructions for wallet_open_signing_url, wallet_payment_session_status, local_vault_save, and local_vault_list.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior3/5

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

Annotations are empty, so the description carries the full burden. It discloses that this is an alias and that it returns setup instructions, which is useful. However, it doesn't mention side effects, permissions, or output format beyond the list of tools. This is partial but not exhaustive transparency.

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

Conciseness5/5

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

The description is a single, front-loaded sentence that efficiently communicates the alias relationship and the specific focus. Every word contributes value, with no fluff or redundancy.

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

Completeness2/5

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

Given the tool's complexity (43 params, no annotations, no output schema) the description is too sparse. It doesn't explain invocation details, which parameters are relevant, or what the setup instructions will contain beyond the tool names. This is inadequate for an agent to confidently use the tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema has 43 parameters with only 33% description coverage, and the description provides no parameter guidance at all. Since coverage is low, the description should compensate by explaining which parameters matter for this tool (e.g., platform, localPort), but it does not, leaving the agent to guess.

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

Purpose5/5

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

The description clearly states the tool is an alias for wisely_local_commerce_bridge_setup focused on local wallet signing and proof storage, and explicitly lists the setup instruction targets (wallet_open_signing_url, wallet_payment_session_status, local_vault_save, local_vault_list). This provides a specific verb+resource+scope and distinguishes it from the broader parent tool and other bridge setup siblings.

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

Usage Guidelines4/5

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

The description implies usage context by indicating this is a focused alias for local wallet signing and proof storage and listing the specific tools it covers. This gives clear context for when to choose this tool, but it does not explicitly state when-not-to-use or name alternative tools beyond the parent alias, so it falls 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.

start_hereAInspect

Call this first after connecting. Returns the operating playbook, first-call order, safe payment rules, tool routing map, examples, and links for using this MCP server without installing a separate skill.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior3/5

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

With no annotations provided, the description carries the burden of explaining behavior. It describes the tool as a read-only informational call ('Returns...'), which implies no side effects. However, it does not explicitly disclose whether any parameters are ignored, whether network access is required, or what the output structure looks like. The description adds some value by mentioning 'safe payment rules' and 'links,' but stops short of full transparency.

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

Conciseness5/5

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

The description is a single, well-structured sentence that front-loads the critical instruction ('Call this first after connecting') and then lists the return contents efficiently. Every phrase adds value, with no fluff or repetition.

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

Completeness4/5

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

Given that this is a simple entry-point tool with no required parameters and no output schema, the description covers the essentials: what it returns, when to call it, and how it differs from installing a skill. It could be more complete by stating that parameters are likely unused or directing to the playbook for next steps, but it is adequate for a first-call tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is low (33%) with 43 optional parameters, and the description does not mention any parameters or clarify which, if any, are relevant to start_here. Since no parameters are required and the tool appears to be a simple entry point, the lack of parameter guidance is a gap, especially when the schema lists many unrelated fields. The description provides no added meaning beyond the schema.

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

Purpose5/5

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

The description clearly states the tool's purpose: 'Call this first after connecting' and 'Returns the operating playbook, first-call order, safe payment rules, tool routing map, examples, and links.' It uses a specific verb ('returns') and names a distinct resource, differentiating it from siblings like get_playbook and readme by emphasizing it's the entry point and avoids installing a separate skill.

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

Usage Guidelines4/5

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

The description explicitly tells the agent when to use this tool: 'Call this first after connecting.' This is clear usage guidance and implies precedence over other tools. It does not explicitly name alternatives or exclusions, but the 'first after connecting' instruction is sufficient context for typical usage.

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

wallet_bridge_setupBInspect

Alias for setup_local_wallet_bridge. Use when the user wants their wallet to stay local while the agent uses Wisely x402 payment sessions.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior2/5

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

With empty annotations, the description carries full burden for behavioral disclosure. It only labels the tool as an alias and gives a use case. It does not disclose side effects, local setup requirements, state changes, or return behavior. The agent cannot infer what actually happens when invoking this tool.

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

Conciseness5/5

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

The description is extremely concise: two sentences, each earning its place. It names the alias and gives the key usage condition. No filler or repetition.

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

Completeness1/5

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

For a tool with 43 parameters, no output schema, and empty annotations, this description is severely incomplete. It does not explain the setup process, required inputs, expected outcomes, or how to use the alias effectively. The agent would need to rely on the sibling tool's documentation, which is not mentioned beyond its name.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is only 33%, and the description provides zero parameter information. The tool has 43 parameters, but the description does not map any of them or point to the canonical tool's parameter docs. The agent has no guidance on which parameters to supply for the alias.

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

Purpose5/5

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

The description states a specific verb+resource: 'Alias for setup_local_wallet_bridge.' It clearly differentiates by adding the use case: 'Use when the user wants their wallet to stay local while the agent uses Wisely x402 payment sessions.' This distinguishes it from other bridge setup tools and gives a concrete purpose.

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

Usage Guidelines5/5

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

The description provides an explicit condition for use: 'Use when the user wants their wallet to stay local.' It also names the canonical sibling tool (setup_local_wallet_bridge), giving the agent a clear alternative to consult for canonical behavior. This is strong guidance.

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

wisely_agent_instructionsAInspect

Alias for wisely_start_here. Returns concise instructions an AI agent should follow before quoting, paying, invoking, creating endpoints, or handling receipts through Wisely.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior3/5

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

With no annotations, the description carries the burden. It discloses the primary behavior (returning concise instructions) and implies a read-only, instructional operation, but doesn't detail auth requirements, parameter effects, or any side effects. This is adequate but not thorough.

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

Conciseness5/5

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

The description is a single, front-loaded sentence that clearly names the tool as an alias and explains its purpose without waste.

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

Completeness2/5

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

Despite having 43 parameters and no output schema, the description only gives a high-level purpose. It doesn't explain how parameters like audience, platform, or includeExamples affect the returned instructions, or what format the instructions take. For such a complex tool, this is insufficiently complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The description provides no parameter information, and schema coverage is only 33% with many undocumented properties. With 43 optional parameters, the description fails to clarify which are relevant to this alias, leaving the agent to guess.

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

Purpose5/5

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

The description states the tool returns concise instructions for an AI agent before specific Wisely operations (quoting, paying, invoking, creating endpoints, handling receipts) and identifies itself as an alias for wisely_start_here, distinguishing it functionally from sibling tools like get_playbook.

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

Usage Guidelines4/5

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

It provides explicit context for when to use (before quoting, paying, invoking, creating endpoints, or handling receipts), but doesn't mention exclusions or explicitly compare to alternative tools beyond noting it's an alias for wisely_start_here.

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

wisely_builder_eventsCInspect

Search builder-owned endpoint events by time range, endpoint, type, or receipt id.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior2/5

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

Annotations are empty, so the description carries the full burden of behavioral disclosure. It reveals the basic searching action but omits return format, pagination behavior, result limits, permissions required, or any operational constraints. This is minimal transparency for a tool with zero annotation support.

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

Conciseness5/5

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

A single well-structured sentence that front-loads the action and key filter dimensions. There is no wordiness, redundancy, or extraneous detail—every word earns its place.

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

Completeness2/5

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

Given the tool has 43 optional parameters, no output schema, and empty annotations, the description is far too sparse. It does not explain what fields to return, how filters combine, or the nature of the events. The context is insufficient for an agent to invoke the tool with confidence.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The description lists filter concepts (time range, endpoint, type, receipt id) but does not map them to concrete schema parameters like since, endpointSlug, type, or receiptId. With 43 parameters and only 33% schema description coverage, the description fails to compensate adequately, leaving the agent uncertain which of the many optional fields to populate.

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

Purpose4/5

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

The description uses a specific verb 'Search' and identifies the resource as 'builder-owned endpoint events', with clear filter dimensions (time range, endpoint, type, receipt id). It is unambiguous about the tool's function, though it does not explicitly differentiate from the similar sibling tool x402_builder_events.

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

Usage Guidelines2/5

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

There is no guidance on when to use this tool versus alternatives such as x402_builder_events, nor any exclusions, prerequisites, or contextual triggers. The description only states the action without indicating preferred use cases.

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

wisely_builder_revenueBInspect

Read builder-owned endpoint revenue, fees, estimated payable balance, receipt IDs, and settlement notes with a saved builder key.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior4/5

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

With no annotations, the description carries the burden of disclosing behavior. It explicitly says 'Read', implying a non-mutating operation, and mentions the requirement of a 'saved builder key'. It also lists the types of data returned, offering useful behavioral context. However, it does not discuss what happens if the key is missing or invalid, or whether the operation has any side effects beyond reading.

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

Conciseness5/5

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

The description is a single, well-structured sentence that leads with the action verb 'Read' and conveys the core functionality efficiently. Every part earns its place, with no redundant or extraneous detail.

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

Completeness2/5

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

Given the tool's complexity (43 parameters, no output schema, no annotations), the description is too sparse to fully guide an agent. It does not clarify how to specify the builder or endpoint, what 'saved builder key' entails, or how to interpret the returned data. The description covers only the high-level purpose, leaving significant gaps.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema has 43 parameters with only 33% description coverage, and the tool description does not explain which parameters are relevant or how they map to the listed data outputs. For example, 'receipt IDs' likely corresponds to receiptId, but no mapping or usage is provided. The description fails to compensate for the low schema coverage.

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

Purpose4/5

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

The description clearly states the tool reads builder-owned endpoint revenue, fees, estimated payable balance, receipt IDs, and settlement notes, specifying both the action and the resource. It is specific and informative, but does not differentiate from the similarly named x402_builder_revenue sibling.

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

Usage Guidelines2/5

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

The description provides no guidance on when to use this tool versus alternatives such as x402_builder_revenue or wisely_builder_events. It does not mention any prerequisites, exclusions, or preferred use cases beyond the implicit 'saved builder key'.

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

wisely_builder_statusBInspect

Read builder account and owned endpoint status with a saved builder key.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior2/5

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

Annotations are empty, so the description carries the full burden. The verb 'Read' implies a safe, non-mutating operation, and the mention of a saved builder key indicates an authentication requirement. However, no details are provided about what the status output contains, potential errors, or behavior if the saved key is invalid.

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

Conciseness5/5

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

The description is a single, front-loaded sentence: 'Read builder account and owned endpoint status with a saved builder key.' Every word adds useful information, and there is no redundancy or filler. It is appropriately concise for the limited information it conveys.

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

Completeness2/5

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

Given the large parameter set, many sibling tools, no annotations, and no output schema, the description is too minimal. It does not explain what 'status' includes, how the saved key is used, what the response looks like, or how this differs from other status tools like x402_dashboard_status. The tool is under-described for its complexity.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema has 43 parameters with only 33% description coverage, so the description must compensate. It does not mention any specific parameters or clarify which of the many optional fields apply to this tool. The only semantic hint is 'with a saved builder key', which implies the key is not a parameter but rather a preconfigured credential.

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

Purpose5/5

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

The description uses a specific verb 'Read' and clearly identifies the resource: 'builder account and owned endpoint status'. It also mentions the authentication mechanism ('with a saved builder key'), distinguishing it from sibling tools like revenue or events tools. The name and description together leave no ambiguity about what this tool does.

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

Usage Guidelines2/5

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

No explicit guidance is given on when to use this tool versus alternatives such as x402_dashboard_status, wisely_builder_events, or wisely_builder_revenue. The description implies usage for status checking but does not mention when not to use it or which sibling tools cover related but different concerns.

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

wisely_creator_catalog_fetchCInspect

Fetch a creator catalog item. Paid items return a paid endpoint URL and payment instructions instead of protected content.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior3/5

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

With empty annotations, the description must carry the full behavioral disclosure. It adds one useful trait: paid items return a paid endpoint URL and payment instructions rather than protected content. However, it says nothing about read-only nature, authentication, errors, or side effects, so transparency is partial.

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

Conciseness5/5

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

The description is a single sentence that is front-loaded with the core action and includes a critical behavior (paid item handling). It is concise, well-structured, and every word contributes.

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

Completeness1/5

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

For a tool with 43 parameters, empty annotations, and no output schema, this description is severely incomplete. It does not explain what a creator catalog item is, what return values look like, how to handle free items, or which parameters are required. The one behavioral note about paid items is insufficient given the tool's complexity.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema has 43 parameters with only 33% description coverage, and the description provides no guidance on which parameters are relevant (e.g., url or itemId) or how to structure input. This is a major gap; the description adds no semantic value beyond the sparse schema.

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

Purpose4/5

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

The description clearly states the tool fetches a creator catalog item, using a specific verb and resource. It distinguishes from siblings like list/search/recommend by the verb 'fetch', though it does not explicitly contrast with them or mention that it retrieves a single item.

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

Usage Guidelines2/5

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

There is no guidance on when to use this tool versus alternatives like wisely_creator_catalog_search or list. No mention of prerequisites, typical use cases, or when to choose fetch over other catalog operations.

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

wisely_creator_catalog_listAInspect

List public creator catalogs that expose approved lessons, worksheets, and paid tools to AI agents.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior3/5

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

With empty annotations, the description carries the burden. It adds meaningful context by specifying 'public' catalogs and the inclusion of 'approved lessons, worksheets, and paid tools.' However, it does not disclose whether the operation is read-only, whether authentication is needed, or any pagination or rate-limit behavior.

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

Conciseness5/5

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

A single, front-loaded sentence with no filler. Every word contributes to the purpose and scope of the tool.

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

Completeness2/5

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

Given the large parameter surface (43 parameters) and lack of output schema/annotations, the description is too sparse. It does not explain what the returned list looks like, how to filter, or what 'approved' means in practice. This is inadequate for a tool with such complexity.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is only 33% and the description does not compensate by explaining which of the 43 parameters are relevant for listing catalogs. No parameter behavior or usage is mentioned, leaving agents guessing about filtering or other options.

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

Purpose5/5

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

The description uses the specific verb 'List' with a clear resource: 'public creator catalogs that expose approved lessons, worksheets, and paid tools to AI agents.' This precisely distinguishes it from sibling tools like fetch, search, and recommend.

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

Usage Guidelines3/5

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

The description implies usage by the verb 'List' (for enumerating catalogs) but does not explicitly mention when to use this tool versus alternatives such as search or recommend. No exclusions or alternative tool names are given.

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

wisely_creator_catalog_recommendCInspect

Recommend the next creator-catalog action for a subscriber situation, including fetch instructions or paid endpoint 402 probe instructions.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior2/5

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

With no annotations, the description must carry the full behavioral burden. It does not disclose whether the tool executes requests, performs 402 probes, or merely returns instructions; it also says nothing about side effects, safety, or reversibility. The advisory language is ambiguous and insufficient.

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

Conciseness4/5

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

The description is a single front-loaded sentence with no filler and clearly identifies the core action. However, its brevity comes at the expense of necessary behavioral and usage detail, making it efficient but not fully developed.

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

Completeness1/5

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

Given the tool's complexity (43 parameters, no output schema, empty annotations), this one-sentence description is dramatically incomplete. It does not explain return values, how recommendations are structured, which inputs matter, or how this recommendation relates to the many sibling tools, leaving agents without enough context to invoke it correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With 43 parameters and only 33% schema description coverage, the description adds no parameter-level guidance. It never explains how 'subscriber situation' maps to any input field, nor does it indicate which of the many URL, payment, wallet, or catalog parameters are relevant for a given recommendation request.

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

Purpose4/5

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

The description uses a specific verb ('Recommend') and resource ('next creator-catalog action'), and it clarifies scope by mentioning fetch instructions and paid endpoint 402 probe instructions. This differentiates it from sibling fetch/list/search tools, though it does not explicitly name alternatives.

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

Usage Guidelines3/5

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

The phrase 'for a subscriber situation' implies a clear use context, and the mention of fetch/402 probe instructions hints at what the tool returns. However, there is no explicit guidance on when to prefer this over sibling tools like wisely_creator_catalog_search, start_here, or get_playbook, and no exclusions are stated.

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

wisely_creator_onboarding_handoffCInspect

Explain how to publish creator catalogs with entitlement rules, paid actions, and builder-key controlled paid endpoint creation.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior2/5

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

With no annotations, the description carries the full burden of behavioral disclosure. It implies an informational/instructional tool, but does not say what the output looks like, whether it invokes other tools, requires authentication, or has side effects. The word 'handoff' hints at a transfer or delegation, but this is never clarified.

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

Conciseness4/5

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

The description is a single concise sentence, front-loaded with the verb 'Explain' and the resource 'publishing creator catalogs.' It wastes zero words, but its extreme brevity borders on under-specification rather than efficient clarity.

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

Completeness1/5

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

Given the tool's complexity (43 parameters, no output schema, no annotations, many siblings), a one-sentence description is grossly incomplete. It does not explain what a handoff involves, which parameters are essential, what result to expect, or how to identify when this tool is the right choice. The description fails to provide enough context for an agent to use it effectively.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is only 33% with 43 parameters, so the description must compensate, but it adds no parameter-specific meaning. It references high-level topics like 'entitlement rules' and 'paid actions' but does not map them to any of the many unstructured parameters such as content, paymentRequirements, or defaultEntitlement. This leaves nearly all parameters semantically opaque.

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

Purpose4/5

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

The description clearly states the tool explains how to publish creator catalogs with entitlement rules, paid actions, and builder-key controlled paid endpoint creation. It names specific topics, giving a clear purpose. However, it does not distinguish itself from similar sibling tools like wisely_creator_onboarding_preview or wisely_endpoint_handoff, so it stops short of a 5.

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

Usage Guidelines2/5

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

The description provides no guidance on when to use this tool versus the many similar alternatives. There is no mention of prerequisites, exclusions, or recommended contexts. Users must infer its use from the generic 'explain how to publish' phrasing, which is insufficient given the large sibling set.

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

wisely_creator_onboarding_previewAInspect

Preview a creator catalog import from Markdown, CSV, JSON, or item arrays. Does not persist content or create paid endpoints.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior3/5

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

With no annotations, the description carries the full burden and does disclose the key non-persistence and no-endpoint-creation traits, which is valuable safety context. Yet it lacks details about return values, validation outcomes, or error behavior, leaving partial ambiguity about what the agent should expect after invoking.

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

Conciseness5/5

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

The description is two sentences, front-loaded with the primary action and resource, and adds only essential caveats. Every word serves a purpose with no filler or redundant schema repetition.

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

Completeness2/5

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

Given the tool's 43-parameter schema, empty annotations, and lack of output schema, a two-sentence description is insufficient. It clarifies the safety guarantee but does not explain how to construct the input, what the preview response looks like, or how to interpret success/failure. The pairing with wisely_creator_onboarding_handoff is not explored, leaving a significant gap for an agent trying to use this complex tool correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema has 43 parameters with only 33% described, so the description must compensate. It adds the allowed input sources (Markdown, CSV, JSON, item arrays), which guides selection of contentType or items, but it does not explain how to choose between url, content, or other input fields for a given source. Many unrelated parameters remain unexplained, which is risky at this low coverage.

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

Purpose5/5

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

The description uses a specific verb 'Preview' paired with a clear resource 'creator catalog import' and enumerates input formats (Markdown, CSV, JSON, item arrays). This clearly distinguishes it from sibling fetch/list/search/onboarding tools, making its purpose unmistakable.

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

Usage Guidelines4/5

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

The phrase 'Does not persist content or create paid endpoints' informs the agent that this is a dry-run and not the committing action, implying an alternative like an import or handoff tool. However, it does not explicitly name when to use this versus a specific sibling, so some inference is required.

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

wisely_doctorCInspect

Return public-safe endpoint wiring, discovery, and verifier readiness checks.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior3/5

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

The description discloses that the tool returns only 'public-safe' data, implying no secrets are exposed, and the verb 'Return' hints at a read-only operation. But with empty annotations, the agent has no information about side effects, network calls, auth needs, or error behaviors.

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

Conciseness2/5

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

The description is a single sentence, but it is drastically under-specified for a tool with 43 optional parameters and no output schema. The brevity is not effective conciseness; it omits essential usage context.

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

Completeness1/5

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

Given the large parameter space, empty annotations, and no output schema, the description is far from complete. It does not explain the nature of the checks, expected inputs, or the shape of the return value, leaving the agent to guess.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is only 33%, and the description does not reference any of the 43 parameters. The agent cannot infer which parameters are relevant for a diagnostic invocation, nor how to construct a valid request.

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

Purpose4/5

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

The description uses a specific verb ('Return') and identifies the resource as 'public-safe endpoint wiring, discovery, and verifier readiness checks.' However, the phrasing is jargon-heavy and doesn't clearly differentiate from several sibling status/check tools like x402_rail_status or x402_state_status.

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

Usage Guidelines2/5

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

No guidance is provided about when to use this tool. It does not mention alternatives, prerequisites, or exclusions, leaving the agent without context for selecting this over sibling checklist tools.

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

wisely_endpoint_handoffCInspect

Return portable endpoint-factory instructions and buyer handoff guidance for agents that create or manage paid x402 endpoints.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior2/5

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

With no annotations, the description carries full burden for behavioral disclosure. It only says 'Return... instructions' without explaining whether the operation is read-only, whether it requires authentication, or what side effects (if any) it has. The return format and payload structure are also undisclosed.

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

Conciseness5/5

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

A single, front-loaded sentence with no filler. Every word contributes to the core purpose, making it efficient and easy to parse.

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

Completeness2/5

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

Given the complexity (43 params, no output schema, no annotations), a one-sentence description is insufficient. It doesn't explain how the input parameters relate to the returned instructions, what the handoff guidance actually contains, or how to interpret the response.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is only 33% and the description adds no parameter-level meaning. With 43 parameters and no guidance on which are relevant for endpoint handoff, agents have no assistance in choosing or filling parameters correctly.

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

Purpose4/5

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

The description clearly states it returns portable endpoint-factory instructions and buyer handoff guidance, with a specific target audience. It distinguishes itself from most siblings by focusing on guidance rather than direct endpoint management, but it doesn't explicitly differentiate from the similarly named x402_endpoint_create_handoff.

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

Usage Guidelines3/5

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

Provides a clear context: for agents that create or manage paid x402 endpoints. However, it lacks explicit guidance on when to choose this tool over alternatives like x402_endpoint_create_handoff or x402_endpoint_catalog, and offers no exclusions.

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

wisely_get_playbookCInspect

Alias for wisely_start_here. Returns the Wisely agent-payment playbook for MCP-only clients and registry probes.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior2/5

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

With empty annotations, the description carries the full burden. It only says the tool 'returns' a playbook, with no mention of side effects, permissions, rate limits, or whether it is a read-only operation. No behavioral traits are disclosed beyond the basic function.

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

Conciseness5/5

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

The description is exactly two sentences, front-loaded with the essential alias information and no fluff. It is extremely concise and well-structured for the tiny amount of information it conveys.

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

Completeness1/5

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

A tool with 43 parameters, no output schema, and empty annotations requires far more explanation. The description does not explain what the playbook contains, how to pick parameters, or what the response looks like. It is a stub that fails to give the agent enough context to use it correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 43 parameters with only 33% schema description coverage, so the description should compensate but does not. It provides no information about how parameters affect the playbook output, which parameters are relevant, or how to construct a valid request. The one-line description adds no semantic value beyond the schema.

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

Purpose4/5

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

The description clearly states the tool 'Returns the Wisely agent-payment playbook' and identifies itself as an alias for wisely_start_here. It adds a specific audience context ('MCP-only clients and registry probes'), which differentiates it somewhat from siblings like get_playbook, though not from wisely_start_here itself.

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

Usage Guidelines2/5

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

The description gives no explicit guidance on when to use this tool over alternatives. It only says 'Alias for wisely_start_here' and mentions a narrow use case, but does not explain when to prefer this over wisely_start_here, get_playbook, or other playbook-related tools.

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

wisely_install_profileCInspect

Return portable install metadata for OpenClaw, Hermes-style agents, Codex/CLI agents, MCP clients, and Bankr-style skill registries.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior2/5

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

With empty annotations, the description carries the full burden for behavioral disclosure, but it only states that it 'returns' metadata, implying a read-only operation. It does not mention whether it performs any network calls, whether it has side effects, or what happens to the many input parameters, leaving significant behavioral ambiguity.

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

Conciseness4/5

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

The description is a single, concise sentence that front-loads the core verb and object. It contains no redundant words, though its brevity is insufficient for a tool with 43 parameters, which is more a completeness concern than a conciseness one.

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

Completeness2/5

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

Given the tool's complexity (43 parameters, no output schema, no annotations), the description is far from complete. It explains the high-level output but fails to define 'portable install metadata', clarify inputs, or cover any edge cases, leaving agents without enough context to invoke it reliably.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is only 33%, and the description adds no parameter semantics whatsoever. It does not mention any of the 43 parameters or explain how inputs relate to the returned metadata, failing to compensate for the schema's low coverage.

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

Purpose4/5

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

The description clearly states the action ('Return portable install metadata') and specifies the target consumers (OpenClaw, Hermes-style, Codex/CLI, MCP clients, Bankr-style), which gives the tool a distinct identity. However, it does not explicitly differentiate from sibling tools like install_skill or download_skill, so it falls short of a 5.

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

Usage Guidelines2/5

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

No guidance is provided on when to use this tool versus alternatives such as install_skill, download_skill, or get_playbook. The description implies it is relevant for installing into specific agent frameworks, but there is no explicit context, prerequisites, or exclusion criteria.

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

wisely_local_bridge_setupAInspect

Alias for wisely_local_commerce_bridge_setup. Returns the local browser bridge setup guide for agents connecting by MCP without ClawMart.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior3/5

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

Annotations are empty, so the description carries the burden. It discloses that the tool returns a setup guide (a read-only, safe operation), which is useful. However, it does not describe any additional behavior such as output format, prerequisites, or whether it modifies state. For a simple guide-returning tool, this is acceptable but not richly transparent.

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

Conciseness5/5

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

The description is a single sentence that immediately identifies the tool as an alias and explains what it does. It is maximally concise with no wasted words, and the key information is front-loaded.

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

Completeness2/5

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

Given the tool has no output schema, no annotations, and a very large parameter set, the description is far too brief to be complete. It does not explain what the returned guide contains, which parameters to use, or any edge cases. As an alias, it redirects to another tool, but it lacks enough context for an agent to invoke it correctly without additional investigation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With 43 parameters and only 33% schema description coverage, the description needed to clarify which parameters are relevant for this setup guide. The description adds no parameter information at all, leaving the agent to guess which of the many fields apply. It does not compensate for the low schema coverage.

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

Purpose5/5

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

The description clearly states the tool 'Returns the local browser bridge setup guide' and identifies itself as an alias for wisely_local_commerce_bridge_setup, which differentiates it from siblings. The verb 'returns' and the resource 'local browser bridge setup guide' are specific and unambiguous.

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

Usage Guidelines4/5

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

The description specifies the exact context: 'for agents connecting by MCP without ClawMart'. This tells when to use this tool and implicitly distinguishes it from the canonical commerce bridge tool and other setup guides. It lacks explicit exclusions or 'when not to use' guidance, but the intended scenario is clear.

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

wisely_local_commerce_bridge_setupBInspect

Call this when a user wants DoorDash or another merchant flow to run from their own local browser instead of Wisely's server. Returns a clear novice setup guide, local MCP config, credential policy, expected local tools, and step-by-step install/start/test instructions. Do not ask for merchant passwords in chat.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior3/5

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

With no annotations, the description carries the full burden of behavioral disclosure. It does add useful context by stating what the tool returns (novice setup guide, local MCP config, credential policy, instructions) and includes a behavioral rule ('Do not ask for merchant passwords in chat'). However, it does not disclose potential side effects, prerequisites, network calls, or operational details like port defaults, leaving gaps in transparency.

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

Conciseness5/5

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

The description is two sentences, front-loaded with the trigger condition, and every word earns its place. It avoids redundancy and clearly communicates purpose and important caveats ('Do not ask for merchant passwords') without unnecessary detail.

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

Completeness3/5

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

Given the tool's complexity (43 parameters, no output schema, empty annotations), the description provides a solid summary of the output contents and the high-level use case. However, it does not address parameter selection, differentiate from sibling tools, or explain any constraints/edge cases. It is adequate but incomplete for a tool of this complexity.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is only 33% (low), so the description must compensate by clarifying which of the 43 parameters are relevant. It does not mention any parameters or provide guidance on what to pass. The description adds no meaning beyond the schema, leaving the agent with little help on how to invoke the tool correctly.

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

Purpose4/5

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

The description clearly identifies the tool's purpose: setting up a local commerce bridge for DoorDash or other merchant flows running from the user's local browser. It states a specific verb ('Call this when') and resource ('DoorDash or another merchant flow'), which makes the intent clear. However, it does not explicitly differentiate from overlapping sibling tools like setup_local_commerce_bridge or wisely_local_bridge_setup, so it loses a point.

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

Usage Guidelines3/5

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

The description provides an explicit trigger condition: 'Call this when a user wants DoorDash or another merchant flow to run from their own local browser instead of Wisely's server.' This tells the agent when to use the tool, but it does not mention alternatives or when not to use it. Given the large number of sibling bridge/setup tools, this lack of exclusion guidance makes it a 3 rather than a 4 or 5.

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

wisely_start_hereBInspect

Namespaced alias for start_here. Returns the agent operating playbook, safe payment flow, first-call order, tool routing map, and examples for using x402 payments, hosted endpoints, creator catalogs, conversion handoffs, receipts, and builder controls.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior3/5

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

Annotations are empty, so the description carries the full burden. It states the tool 'Returns' a playbook, implying a read-only operation without side effects. However, it does not disclose any limitations, required permissions, or whether there are any side effects. For a retrieval-style tool, this is adequate but not rich in behavioral context.

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

Conciseness4/5

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

The description is a single sentence that is dense but not overly long. It front-loads the key fact that this is a namespaced alias for start_here, then lists the content areas efficiently. Every phrase contributes to describing the tool's output, with minimal wasted text.

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

Completeness2/5

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

With 43 parameters, no output schema, and no annotations, the description is relatively sparse. It gives a high-level summary of what is returned but does not explain how to invoke the tool (e.g., whether parameters like 'audience' are relevant), nor what the response structure looks like. For a complex schema, this is insufficient for an agent to know how to correctly use the tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is only 33%, and the description adds no parameter-specific guidance. The tool has 43 optional parameters, and the description does not explain which are relevant for this tool or how they affect the returned playbook. Since coverage is low, the description should compensate, but it does not, leaving parameter semantics largely unexplained.

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

Purpose4/5

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

The description clearly states the tool 'Returns the agent operating playbook' and lists specific content areas, giving a specific verb and resource. It identifies itself as a 'Namespaced alias for start_here', which helps distinguish it from sibling tools. However, it doesn't explicitly differentiate from other playbook-related tools like wisely_get_playbook, so it loses a point.

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

Usage Guidelines3/5

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

Usage is implied by the name and the mention of 'first-call order', suggesting this is the entry point. The description lists what is returned but does not explicitly state when to use this tool over alternatives or provide exclusions. It says it is an alias, which implies using the wisely-namespaced version, but no direct 'use this when' guidance is given.

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

x402_alert_statusCInspect

Return public-safe alerting status and recent rail/provider operational notices.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior2/5

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

There are no annotations, and the description only adds the phrase 'public-safe', which hints at safety but does not disclose behavior like read-only semantics, what exactly constitutes an 'alert', how recent the notices are, or whether any state is mutated. The description carries the full burden for transparency but remains minimal.

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

Conciseness4/5

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

The description is a single concise sentence with no wasted words. It front-loads the action and resource, but the term 'public-safe' is slightly vague and the sentence could carry more useful detail without losing conciseness.

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

Completeness2/5

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

Given the absence of annotations, an output schema, and the tool's complex context (43 params, many siblings), this one-line description is severely insufficient. It does not explain return format, alert categories, providers covered, or how to interpret the status. The agent lacks essential operational context.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With 43 parameters and only 33% schema description coverage, the description provides no parameter guidance. It does not indicate which of the many schema properties (e.g., network, platform, input) are relevant for this tool, leaving the agent to guess which optional filters or inputs are expected.

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

Purpose4/5

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

The description uses a specific verb ('Return') and names a clear resource ('public-safe alerting status and recent rail/provider operational notices'). It conveys the tool's core function, but it does not differentiate from sibling tools like x402_rail_status or x402_worker_status, which likely provide overlapping status information.

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

Usage Guidelines2/5

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

No guidance is provided on when to use this tool over alternatives. Given the large set of sibling status tools (x402_rail_status, x402_integration_status, x402_dashboard_status), the description lacks any context for selection or exclusion, leaving the agent without direction.

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

x402_builder_eventsAInspect

Search builder-owned endpoint events by time range, endpoint, type, or receipt id.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior3/5

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

With no annotations, the description carries the full transparency burden. It correctly implies a read-only search operation and lists filter dimensions, but does not disclose pagination behavior, whether any endpoint ownership is required, or what the returned events contain. The information is honest but minimal.

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

Conciseness5/5

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

The description is a single, tightly worded sentence that front-loads the action and resource. It avoids fluff and conveys the essential search capability efficiently.

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

Completeness2/5

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

Given the tool's complexity (43 parameters, no output schema, no annotations), the description is far from complete. It does not clarify which default filters apply, whether any are required, or how the tool relates to sibling tools like x402_get_receipt. The description provides only a surface-level summary.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The description mentions 'time range', 'endpoint', 'type', and 'receipt id' but does not map these to actual schema parameters like 'since', 'endpointSlug', 'type', and 'receiptId'. With 43 parameters and only 33% schema description coverage, the description fails to compensate for low coverage, leaving agents uncertain about which parameters are relevant.

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

Purpose5/5

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

The description clearly states the tool's function with a specific verb ('Search') and resource ('builder-owned endpoint events'), and identifies the main filtering dimensions (time range, endpoint, type, receipt id). This distinguishes it from related sibling tools like x402_builder_payouts and x402_builder_revenue.

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

Usage Guidelines3/5

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

Usage is implied—this tool searches events—but no explicit guidance is given on when to use it versus alternatives such as x402_get_receipt or wisely_builder_events. It does not mention exclusions or provide decision criteria.

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

x402_builder_payoutsAInspect

Read/update payout settings and create manual payout request packets without moving funds.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior3/5

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

With empty annotations, the description carries the full burden. It discloses a key behavioral trait—'without moving funds'—which is valuable safety-related context. However, it does not detail side effects, permissions, reversibility of updates, or the nature of 'payout request packets.'

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

Conciseness5/5

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

The description is a single, tightly worded sentence that front-loads the primary actions and includes a critical qualifier. There is no fluff or repetition.

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

Completeness2/5

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

Given the tool's complexity (43 parameters, nested objects, no output schema, no annotations), the description is far too sparse. It fails to explain what 'payout settings' include, what 'manual payout request packets' are, how the tool is invoked, or what the response looks like.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is only 33%, and the tool description does not compensate by explaining any of the 43 parameters. Many generic parameters like 'url', 'type', 'items', and 'query' are left ambiguous, and the description adds no meaning beyond the schema.

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

Purpose5/5

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

The description clearly states the tool's function: 'Read/update payout settings and create manual payout request packets without moving funds.' This uses specific verbs and a clear resource, and the qualifier 'without moving funds' distinguishes it from fund-moving tools among its siblings.

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

Usage Guidelines3/5

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

The description implies the tool is for managing payout settings and creating payout request packets, but it does not explicitly state when to use this tool versus alternatives, nor does it name any sibling tools or provide exclusions beyond the 'without moving funds' qualifier.

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

x402_builder_registerCInspect

Register for a builder key through x402, developer credit, or admin issue; returned key controls only that builder's endpoints.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior2/5

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

With no annotations provided, the description must carry the behavioral disclosure burden. It does mention one important constraint (the key only controls that builder's endpoints), but it omits side effects, authentication requirements, whether the operation requires prior credits, or what the returned key looks like. This is insufficient for a registration tool with no annotation safety clues.

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

Conciseness4/5

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

The description is a single sentence with no wasted words, front-loading the verb and object. It is concise and easy to scan. However, for a tool with 43 parameters and no other documentation, the brevity borders on under-specification, though the conciseness dimension rewards the lack of fluff.

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

Completeness1/5

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

Given the extreme complexity (43 parameters, no output schema, empty annotations), this description is severely incomplete. It only hints at the returned key's scope and says nothing about return values, error conditions, required versus optional parameters, or how registration initiates. This is far below the minimum viable contextual completeness for such a complex tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema has 43 parameters with only 33% description coverage, and the description adds no parameter-level guidance. Many parameters are undocumented, and the description does not indicate which are relevant for registration. The generic schema with additionalProperties true further compounds the confusion, leaving the agent without a map for selecting parameters.

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

Purpose5/5

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

The description clearly states the action (register), the object (builder key), and the methods (through x402, developer credit, or admin issue). It also adds a specific scope limitation ('controls only that builder's endpoints'), which distinguishes it from sibling tools like x402_builder_events or x402_purchase_credits.

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

Usage Guidelines2/5

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

The description gives no guidance on when to use this tool versus alternatives. It does not mention prerequisites (e.g., needing developer credit), nor does it contrast with related tools such as x402_credit_status or x402_endpoint_create_handoff. The implied use case is 'when you need a builder key,' but no explicit direction is provided.

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

x402_builder_revenueBInspect

Read builder-owned endpoint revenue, fees, estimated payable balance, receipt IDs, and settlement notes with a saved builder key.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior3/5

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 uses the verb 'Read' to signal a safe, non-mutating operation, and mentions 'estimated' payable balance, which hints at approximate values. However, it does not disclose details about return format, error conditions, or what happens if no saved builder key exists, leaving gaps for an agent.

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

Conciseness4/5

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

The description is a single, dense sentence that fronts the action 'Read' and the resource. It lists many data types without wasted words, though the long list makes it slightly harder to parse. Overall, it is appropriately sized for the amount of information conveyed.

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

Completeness2/5

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

Given the tool's high complexity (43 params, no output schema, no annotations), the description is too thin. It does not explain the return value structure, how to specify which endpoint, or the meaning of 'saved builder key' in operational terms. An agent would need additional context to select and invoke this tool reliably.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 43 parameters with only 33% description coverage, and the tool description does not compensate by explaining which parameters are relevant or how they map to the mentioned data (e.g., receipt IDs, settlement notes). It mentions some data types but provides no guidance on selecting or using the parameters, making it difficult to invoke the tool correctly.

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

Purpose5/5

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

The description clearly states the tool reads builder-owned endpoint revenue, fees, estimated payable balance, receipt IDs, and settlement notes. The verb 'Read' plus the specific resource list distinguishes it from sibling tools like x402_builder_events and x402_builder_payouts, which focus on other aspects.

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

Usage Guidelines3/5

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

The description implies the tool is used to retrieve financial data for builder-owned endpoints, but it does not explicitly state when to use this tool versus alternatives like x402_builder_payouts or wisely_builder_revenue. The mention of 'with a saved builder key' implies a prerequisite but does not elaborate on exclusions or alternatives.

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

x402_conversion_assetsCInspect

List supported and planned input assets for the Wisely casa de cambio conversion handoff layer.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior2/5

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

With empty annotations, the description carries the full burden of behavioral disclosure. It only states the listing action; there is no mention of output format, read-only behavior, or any side effects, so the agent gets minimal behavioral context.

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

Conciseness3/5

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

The description is a single sentence with no fluff, making it concise. However, it is under-specified: it lacks any structural breakdown of key information that would help the agent, so it earns only a mid-range score.

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

Completeness2/5

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

Given the tool's complexity (43 optional params, no output schema, no annotations), the one-line description is insufficient. It does not explain what inputs to provide, what the response will contain, or how this fits into the broader conversion workflow, leaving a significant completeness gap.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema has 43 parameters with only 33% description coverage, and the tool description adds no parameter information at all. It fails to clarify which of the many optional parameters are relevant for this listing operation, leaving the agent unable to select inputs correctly.

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

Purpose4/5

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

The description clearly states the verb 'List' and the specific resource ('supported and planned input assets' for the 'Wisely casa de cambio conversion handoff layer'), making the tool's purpose distinct. However, it does not explicitly differentiate from sibling list tools like x402_endpoint_catalog, so it stops short of a 5.

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

Usage Guidelines2/5

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

The description provides no guidance on when to use this tool versus alternatives. There are no context hints, prerequisites, or exclusions, leaving the agent to infer usage from the tool name alone.

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

x402_conversion_routes_statusCInspect

Return the current executable and planned conversion route status matrix.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior2/5

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

Annotations are empty, so the description carries full burden for behavioral disclosure. It only says 'Return' which implies a read-only operation, but it does not disclose what the matrix contains, whether external calls are made, if there are rate limits, or any side effects. No annotation exists to back up safety, and the description adds no meaningful behavioral context beyond the verb.

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

Conciseness5/5

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

The description is a single, front-loaded sentence with no wasted words. It directly states the action and the object, which is appropriate for a status-query tool. Conciseness is excellent, though it sacrifices detail.

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

Completeness2/5

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

Given the tool's complexity (43 parameters, no output schema, empty annotations) and the large sibling set, a one-sentence description is insufficient. It doesn't explain what 'executable and planned conversion routes' are, how the returned matrix is structured, or in what scenarios this tool is preferred over other status tools. The context is far too thin for reliable agent selection.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema has 43 mostly undocumented parameters with only 33% coverage, and the description mentions none of them. It does not clarify which parameters are relevant (e.g., network, asset, url) or whether any are needed. Since schema coverage is low (<50%), the description should compensate but does not, leaving the agent with an opaque parameter list.

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

Purpose4/5

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

The description uses a specific verb ('Return') and identifies a distinct resource ('current executable and planned conversion route status matrix'). It clearly states what the tool does, though the term 'conversion route status matrix' is jargon and doesn't explicitly distinguish it from other x402 status tools like x402_rail_status or x402_worker_status.

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

Usage Guidelines2/5

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

No guidance is provided on when to use this tool versus the many sibling status tools (e.g., x402_rail_status, x402_worker_status, x402_integration_status). There are no explicit use cases, prerequisites, or alternative references, leaving the agent to guess based on the name alone.

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

x402_credit_statusCInspect

Read developer-credit account status with a developer key.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior2/5

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

With no annotations, the description must carry the burden of behavioral disclosure. It only implies a read-only operation via 'Read' but does not disclose details like what 'status' includes, how to pass the developer key, failure modes, rate limits, or whether the operation is safe. The transparency is minimal.

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

Conciseness4/5

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

The description is a single, front-loaded sentence that is concise and easy to parse. It avoids redundancy but is arguably too terse, missing important usage and context details. Still, it is well-structured for its length.

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

Completeness1/5

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

For a tool with 43 parameters and no output schema, this one-line description is entirely insufficient. It does not explain what the response contains, how to construct a valid request, or any operational context. The agent would likely struggle to invoke this tool correctly without additional information.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 43 parameters with only 33% of them described, and the description provides no parameter guidance whatsoever. It does not mention which parameters are relevant for reading credit status, leaving the agent to infer from an overloaded schema. The description adds no value to parameter understanding.

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

Purpose5/5

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

The description uses a specific verb ('Read') and a distinct resource ('developer-credit account status'), making the tool's purpose immediately clear. It differentiates from sibling status tools like x402_alert_status or x402_dashboard_status by focusing on credit account status.

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

Usage Guidelines3/5

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

The phrase 'with a developer key' provides a hint about the required authentication context, implying the tool is for checking credit status. However, there is no explicit guidance on when to use this tool versus alternatives, nor any exclusions or alternative suggestions.

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

x402_dashboard_statusBInspect

Return public dashboard telemetry for traffic, receipts, fees, and endpoint usage.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior2/5

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

With empty annotations, the description carries the full burden of behavioral disclosure. It only hints at safety via the word 'public' but does not explicitly state that it is read-only, whether authentication is needed, or what data/return format to expect. No side effects, permissions, or rate limits are mentioned.

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

Conciseness5/5

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

The description is a single, tightly worded sentence that front-loads the verb and resource. Every word adds value and there is no redundancy.

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

Completeness2/5

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

The tool has a large, mostly undocumented schema, no output schema, and no behavioral context beyond a one-line purpose. The description does not explain what telemetry fields are returned, how to filter/scope them, or how to interpret results, leaving critical gaps for a tool with this complexity.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is only 33% and the description adds no parameter information whatsoever. The 43-parameter schema appears to be a shared/generic collection, but the description does not indicate which parameters are relevant to dashboard telemetry or how they affect the result.

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

Purpose5/5

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

The description uses a specific verb ('Return') and clearly defines the resource ('public dashboard telemetry') with concrete details (traffic, receipts, fees, endpoint usage). This distinguishes it from sibling status tools like x402_alert_status or x402_builder_revenue, making the purpose unambiguous.

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

Usage Guidelines2/5

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

The description provides no guidance on when to use this tool versus alternatives. It does not mention exclusions, prerequisites, or compare to any of the many sibling status/reporting tools, leaving the agent to infer usage context.

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

x402_doordash_gift_card_processAInspect

Return or run the full DoorDash gift-card-funded quote flow: cart totals, Bitrefill custom range, $15 minimum, crypto conversion/gas, $0.75 service fee, 1% fee, approval packet, and execution stages.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior4/5

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

Even without annotations, the description carries substantial behavioral detail: it lists the flow stages, fees, minimum, and the 'approval packet' stage, signaling a cautious path. It does not explicitly state whether execution moves funds, but the mention of approval and execution stages offers decent transparency for a financial tool.

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

Conciseness5/5

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

One dense sentence that front-loads the purpose and enumerates key details without padding. Every element contributes to explaining the tool's scope and stages.

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

Completeness2/5

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

For a tool with high parameter complexity, no output schema, and no annotations, the description is too thin. It explains the conceptual flow but omits practical invocation details, return value expectations, and how the approval/execution stages work in practice.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With 43 parameters and only 33% schema coverage, the description needed to map the flow to relevant inputs. It names no parameter names and gives no guidance on which fields (e.g., url, amountUsd, sessionId) are required. This leaves the agent without any parameter-level orientation.

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

Purpose5/5

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

The description clearly identifies the tool as the full DoorDash gift-card quote flow, listing specific components (cart totals, Bitrefill range, $15 minimum, fees, approval packet, execution). This distinguishes it from sibling tools like x402_gift_card_commerce_quote or x402_gift_card_merchant_quote by emphasizing the 'full' process.

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

Usage Guidelines4/5

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

The description frames the tool as the complete end-to-end flow, which implies it should be used when the full process is needed, complementing the more specific quote/status siblings. It provides clear context but does not explicitly mention alternatives or exclusions.

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

x402_endpoint_catalogCInspect

List hosted paid x402 endpoints under /tools/{slug}.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior2/5

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

With empty annotations, the description must disclose behavioral traits itself. It only says 'List', implying a read-only operation, but it does not state whether results are paginated, whether authentication is required, what the response structure looks like, or any side effects. This is insufficient for a tool with no annotation safety net.

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

Conciseness3/5

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

The description is a single, front-loaded sentence that efficiently conveys the core purpose. However, its extreme brevity borders on under-specification, especially given the tool's 43-parameter schema, so it is only minimally adequate rather than exemplary.

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

Completeness1/5

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

For a tool with 43 parameters, nested objects, no output schema, and no annotations, the one-line description is severely incomplete. It lacks any information about return values, required filters, pagination, error behavior, or how this catalog relates to other x402 endpoints, leaving the agent largely in the dark.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The description adds zero parameter-level meaning. Schema coverage is only 33% across 43 optional parameters, and the description references '/tools/{slug}' without mapping 'slug' to any actual property (e.g., 'endpointSlug'). The agent cannot infer which parameters are relevant for listing or filtering endpoints.

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

Purpose4/5

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

The description states a clear action ('List') and a specific resource ('hosted paid x402 endpoints') with a URL path location ('/tools/{slug}'). This distinguishes it from many sibling x402_* tools, though the 'slug' placeholder is not explicitly linked to a schema parameter, leaving minor ambiguity.

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

Usage Guidelines2/5

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

There is no guidance about when to use this tool versus alternatives like x402_manifest or x402_endpoint_create_handoff. No prerequisites, filtering intent, or scenarios are mentioned, so the agent receives no decision support.

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

x402_endpoint_create_handoffCInspect

Return endpoint-factory instructions for builder registration, create/update/pause/resume/delete/logs/secrets, CLI deploy, browser console, and request-response handlers.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior2/5

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

Annotations are empty, so the description carries the full burden. It does disclose that the tool returns instructions rather than performing endpoint mutations, which is useful, but it omits output format, side effects, prerequisites, or whether any remote state is accessed.

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

Conciseness4/5

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

The description is a single sentence, front-loaded with the core action ('Return endpoint-factory instructions'), and free of filler. It is concise, though it packs many topics into a compact list.

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

Completeness2/5

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

Given 43 parameters, no output schema, and no annotations, this one-sentence description is not enough. It does not explain the return structure, which parameters are relevant for which operation, or how this handoff relates to the surrounding workflow.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With 43 parameters and schema description coverage at 33%, the description needed to compensate by explaining which parameters matter. It names none and provides no mapping between the listed operations and input fields, leaving the agent to guess among many optional-looking properties.

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

Purpose3/5

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

The description states that the tool 'Return[s] endpoint-factory instructions' and enumerates covered areas (builder registration, CRUD, logs, secrets, CLI deploy, browser console, request-response handlers), so there is a clear verb and resource. However, it is broad and does not clearly differentiate from sibling tools like x402_endpoint_handoff or x402_builder_register.

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

Usage Guidelines2/5

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

There is no explicit guidance on when to use this tool versus alternatives. The only implied context is 'return endpoint-factory instructions,' but no exclusions or comparisons to the many sibling handoff/setup tools are provided.

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

x402_endpoint_secret_settingsBInspect

Explain how endpoint-scoped encrypted secrets are added and listed by name without returning secret values.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior3/5

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

The description adds a safety-relevant behavioral trait (does not return secret values), but with empty annotations, it lacks broader behavioral disclosure such as read-only guarantees, authentication requirements, or side effects. Some credit for the safety note, but not enough context.

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

Conciseness5/5

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

Single sentence, no filler, immediately states purpose. The description is concise and well-structured.

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

Completeness2/5

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

Despite the complexity (43 params, no output schema, no annotations), the description provides only a minimal statement. It doesn't explain invocation inputs, output format, or edge cases, leaving significant gaps for an agent to use it effectively.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With 43 parameters and only 33% schema coverage, the description offers no mapping or hint about which parameters are relevant. Users are left without guidance on how to invoke this tool, and the description does not compensate for the undocumented schema.

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

Purpose5/5

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

The description clearly states the tool's function with a specific verb ('Explain') and resource ('endpoint-scoped encrypted secrets'), and specifies the scope (added/listed by name without returning values). This distinguishes it from sibling endpoint tools.

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

Usage Guidelines2/5

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

No guidance is provided on when to use this tool versus alternatives, nor any mention of required context or prerequisites. The description only states what the tool does, not when to reach for it.

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

x402_get_receiptCInspect

Fetch a public-safe receipt by receipt id.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior2/5

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

With no annotations, the description carries the full burden of behavioral disclosure. 'Public-safe' hints that the returned receipt is safe for public exposure, but the description does not state return format, error behavior, idempotency, or whether the tool requires special permissions. This is minimal behavioral context.

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

Conciseness5/5

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

The description is a single, front-loaded sentence with no filler words. It efficiently communicates the primary action and the key input, making it highly concise and scannable.

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

Completeness1/5

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

The tool has 43 parameters, no annotations, and no output schema, yet the description provides almost no operational context. It does not explain what a 'receipt' contains, how the response is structured, or what to do with the result. This is inadequate for a tool of this complexity.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is only 33%, and the description must compensate. It does add meaning to one parameter ('receiptId' is the receipt id), but the remaining 42 parameters are not addressed, and no clarification is given about which other parameters matter for this operation.

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

Purpose4/5

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

The description clearly states the action ('Fetch') and the resource ('public-safe receipt') and identifies the key parameter ('receipt id'). However, it does not explicitly distinguish this tool from sibling tools like x402_payment_session_status that may also return receipt-like data.

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

Usage Guidelines2/5

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

The description gives no guidance on when to use this tool versus alternatives, nor does it mention any prerequisites, exclusions, or context in which this tool should be selected. The only implied usage is 'when you have a receipt id,' but this is not developed.

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

x402_gift_card_asset_ledger_handoffBInspect

Explain the admin-only encrypted gift-card asset ledger for residual balances and redemption material. Does not reveal secrets.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior3/5

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

With empty annotations, the description carries the full burden. It does add a useful safety disclosure ('Does not reveal secrets') and states the ledger is 'admin-only encrypted', but it does not describe side effects, output format, or confirmation behavior. For an explain-style tool this is acceptable but not rich.

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

Conciseness5/5

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

Two short sentences communicate the core purpose and a key safety guarantee with no filler. The structure is front-loaded and every word adds value.

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

Completeness1/5

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

Given the large open schema, empty annotations, and lack of output schema, this two-sentence description is severely under-specified. It fails to explain what the agent will receive, which parameters to provide, or how this handoff differs operationally from the many sibling 'handoff' tools.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The description provides zero parameter guidance, while the input schema has 43 optional, mostly generic parameters with only 33% schema-description coverage. No required parameters and additionalProperties:true further compound the ambiguity, leaving an agent without any clues about which params are relevant or how to form a call.

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

Purpose5/5

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

The description uses a specific verb ('Explain') and a specific resource ('admin-only encrypted gift-card asset ledger') with clear scope ('residual balances and redemption material'). This distinguishes it from sibling tools like x402_gift_card_commerce_status or x402_doordash_gift_card_process by naming the ledger's unique subject.

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

Usage Guidelines2/5

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

The description gives no explicit guidance on when to use this tool versus alternatives, nor does it mention prerequisites or exclusions beyond 'admin-only'. The only implied usage is that it explains a ledger, but there is no actionable direction for an agent deciding between this and the many related x402 gift-card tools.

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

x402_gift_card_commerce_intentAInspect

Create a public-safe gift-card commerce intent record for follow-through/status streaming without storing full address, password, or redemption-code secrets.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior3/5

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

With no annotations, the description carries the full burden of behavioral disclosure. It discloses an important safety behavior: the record is created 'without storing full address, password, or redemption-code secrets.' However, it omits other operational details such as what it returns, whether it requires a prior wallet session, or whether it makes network calls, leaving gaps in transparency.

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

Conciseness5/5

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

The description is a single, well-structured sentence that packs the action, target, purpose, and a security constraint in about 20 words. It is front-loaded with the verb and resource, and every phrase adds value without redundancy.

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

Completeness2/5

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

Given the tool's complexity (43 parameters, nested objects, no output schema, no annotations), this description is insufficient for reliable invocation. It provides a high-level purpose and safety guarantee but no guidance on key parameters, how they interact, or what the created intent record looks like, making it only marginally usable in practice.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is only 33%, and the description itself mentions no specific parameters or how to use them. The security constraint implies that certain fields like `input` or `sellerBody` should not include secrets, but this does not explain the meaning or usage of any of the 43 parameters, failing to compensate for the low coverage.

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

Purpose5/5

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

The description clearly states the verb 'Create' and the resource 'public-safe gift-card commerce intent record' with an explicit purpose of 'follow-through/status streaming.' It differentiates from sibling tools like x402_gift_card_commerce_quote and x402_gift_card_commerce_status by specifying the intent-record creation role.

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

Usage Guidelines4/5

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

The description gives clear context that this tool is used for creating a record that supports follow-through/status streaming, which signals when it should be invoked. It does not explicitly name alternative tools or exclusions, but the context is enough to infer its place among siblings.

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

x402_gift_card_commerce_quoteAInspect

Quote a gift-card-funded merchant purchase with a $0.75 direct commerce service fee, 1% Wisely fee, and explicit gas/network/route costs. No gift card is purchased and no order is placed.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior4/5

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

With no annotations, the description carries the transparency burden. It discloses the exact fee structure, including the $0.75 service fee, 1% Wisely fee, and gas/network/route costs, and clearly states the tool has no purchase/order side effects. It could add more on return values or prerequisites, but what it says is behaviorally meaningful.

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

Conciseness5/5

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

The description is two sentences, front-loaded with the action and fee information, followed by a crucial no-side-effect clarification. Every word earns its place and there is no redundant restatement of the tool name.

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

Completeness2/5

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

This is a complex tool (43 params, no output schema, many similarly named sibling tools), but the description is only one operational sentence. It omits required inputs, result shape, and differentiation from x402_gift_card_merchant_quote or x402_quote_conversion, leaving significant gaps for correct invocation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The description mentions none of the 43 parameters, and schema description coverage is only 33%, leaving most parameters undocumented. The agent cannot determine which parameters are relevant for a quote (e.g., url, amountUsd, merchant identifiers) or how they map to the quote operation.

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

Purpose5/5

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

Description uses a specific verb ('Quote') and a specific resource ('gift-card-funded merchant purchase'), plus the fee components. It also explicitly says 'No gift card is purchased and no order is placed,' which clearly distinguishes this quoting tool from purchase/intent/status sibling tools.

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

Usage Guidelines4/5

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

The description gives clear context: use this to obtain a quote for a gift-card-funded merchant purchase and it will not place an order. It does not explicitly name or exclude alternative quote tools like x402_gift_card_merchant_quote or x402_quote_service, so it stops short of a fully explicit when-to-use guide.

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

x402_gift_card_commerce_statusCInspect

Return the gift-card-funded commerce lane status, provider readiness, DoorDash disabled gate, pricing/reserve policy, and safe setup steps.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior3/5

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 a read/status operation via 'Return' and lists the specific status components. However, it does not explicitly state that it has no side effects, and the phrase 'safe setup steps' introduces ambiguity about whether it performs setup or merely describes it.

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

Conciseness4/5

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

The description is a single sentence that front-loads the main purpose and enumerates the key return items without unnecessary prose. It is concise and scannable, though the list is somewhat dense.

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

Completeness2/5

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

Given the high parameter count (43), lack of an output schema, and empty annotations, the description does not provide enough context for safe and correct invocation. It lists return contents but not input requirements, response structure, or behavioral guarantees.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The description provides no information about which of the 43 parameters are relevant or required. With schema description coverage at only 33%, the description does not compensate for the large, mostly undocumented parameter surface. The agent has no way to know what inputs to provide for a status query.

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

Purpose4/5

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

The description uses a specific verb ('Return') and identifies a distinct resource ('gift-card-funded commerce lane status') with additional facets (provider readiness, DoorDash disabled gate, pricing/reserve policy, safe setup steps). This differentiates it from sibling tools like x402_gift_card_commerce_intent or x402_gift_card_commerce_quote.

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

Usage Guidelines2/5

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

The description states what the tool returns but provides no guidance on when to use it versus alternatives. It does not mention exclusions, prerequisites, or which sibling tools to prefer for other scenarios. The context is solely about the output, not the usage context.

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

x402_gift_card_discover_optionsAInspect

Search Bitrefill-supported gift-card merchants by category or query, returning product IDs, countries, stock, minimums, maxes, custom/fixed denomination data, and quote endpoints.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior3/5

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

With no annotations, the description carries the full burden and does add some behavioral context by disclosing the return data. Yet it does not explicitly state whether this is a read-only operation, whether authentication is needed, or whether pagination or rate limits apply. The disclosure is helpful but incomplete.

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

Conciseness5/5

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

The description is a single, efficiently front-loaded sentence with a specific verb and resource, followed by a compact list of return fields. No redundant content exists; every phrase earns its place.

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

Completeness2/5

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

Despite the tool's high complexity (43 parameters, no annotations, no output schema), the description offers only a one-line overview. It lacks usage prerequisites, parameter recommendations, examples, or limitations, making it incomplete for an agent to confidently invoke the tool with correct parameters.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is only 33%, and the description mentions 'category or query' but does not map them to specific parameter names (e.g., 'type' or 'query'), nor does it address the other 41 parameters. It provides some semantic direction but insufficiently compensates for the large undocumented schema.

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

Purpose5/5

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

The description uses the specific verb 'Search' and identifies the resource as 'Bitrefill-supported gift-card merchants', with clear scope 'by category or query'. It also lists the key return fields (product IDs, countries, stock, minimums, maxes, denomination data, quote endpoints), which distinguishes this discovery tool from sibling quote/commerce tools.

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

Usage Guidelines4/5

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

The description clearly implies usage for discovering merchants by category or query, providing context for when this tool is appropriate. However, it does not explicitly state exclusions or point to alternatives like x402_gift_card_merchant_quote for actual quoting, leaving room for clearer differentiation.

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

x402_gift_card_merchant_quoteAInspect

Quote any Bitrefill-supported merchant gift-card purchase after product details are fetched, using $0.75 + 1% plus explicit route/network costs.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior4/5

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

With no annotations, the description carries the full burden. It discloses the cost structure ($0.75 + 1% plus route/network costs) and a prerequisite (product details fetched). This is meaningful behavioral context for an agent, though it does not mention side effects, return format, or authorization needs. The 'quote' semantics imply non-mutating behavior.

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

Conciseness5/5

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

A single sentence efficiently conveys purpose, precondition, and pricing. There is no filler, redundancy, or unnecessary detail, making it easy to parse.

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

Completeness2/5

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

Given the tool's complexity (43 parameters, no output schema, nested objects), the description is too terse. It does not explain input requirements, response shape, error conditions, or how this tool relates to other gift-card tools. The pricing and precondition are useful but insufficient for an agent to confidently invoke the tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is only 33% with 43 parameters, and the description provides no parameter-specific guidance. It does not indicate which fields are required for a quote (e.g., url, amountUsd, network), nor how the pricing formula maps to inputs. The phrase 'after product details are fetched' hints at a precondition but does not connect to any parameter, failing to compensate for the low schema coverage.

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

Purpose5/5

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

The description clearly states the tool's function: 'Quote any Bitrefill-supported merchant gift-card purchase' – a specific verb (quote), resource (merchant gift-card purchase), and a unique scoping (Bitrefill-supported). It also adds a condition ('after product details are fetched') and the pricing formula, distinguishing it from sibling quote tools like x402_gift_card_commerce_quote.

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

Usage Guidelines4/5

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

The description provides a clear context: use after product details are fetched, and it specifies the pricing model. It does not explicitly name alternatives or when not to use it, but the mention of 'Bitrefill-supported' and the sequencing condition imply the intended workflow.

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

x402_integration_statusBInspect

Return combined MCP, hosted endpoint, provider-method, rail, conversion, receipt, and alert readiness for outside agents.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior2/5

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

With empty annotations, the description must fully disclose behavior. It says 'Return' which suggests a read operation, but it does not explicitly state that it is read-only, describe side effects, auth requirements, or output shape. For an integration aggregate tool, this is a significant transparency gap.

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

Conciseness5/5

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

One sentence, front-loaded with the verb 'Return', and it enumerates all covered components compactly with no wasted words. The structure makes the purpose immediately visible.

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

Completeness1/5

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

The tool has no output schema, 43 parameters, and no annotations, yet the description only provides a one-line list of what it returns. It omits any info about the returned structure, which parameters matter, usage scenarios, or behavior. This is far from complete for such a complex tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is only 33% and there are 43 optional parameters with no required ones. The description provides no information about which parameters are relevant, how to scope the request, or what values are expected. It completely fails to compensate for the low schema coverage.

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

Purpose5/5

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

The description clearly states the tool returns combined readiness across MCP, hosted endpoint, provider-method, rail, conversion, receipt, and alert components. This distinguishes it from the many individual x402_*_status sibling tools by explicitly saying 'combined'.

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

Usage Guidelines3/5

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

The word 'combined' implies this is an aggregate alternative to individual status tools like x402_rail_status or x402_alert_status, but it does not explicitly say when to use it instead of those or provide any exclusions. Usage is only implied, not clearly guided.

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

x402_invoke_serviceCInspect

Invoke a paid service through /ai/invoke with x402 proof or developer credit.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior2/5

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

With no annotations at all, the description carries the full burden for behavioral disclosure. It mentions payment via 'x402 proof or developer credit' but says nothing about mutating state, required permissions, error behavior, rate limits, or return payloads. This leaves significant ambiguity for an invoking tool.

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

Conciseness2/5

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

The description is a single sentence, which is concise in length, but it is under-specified rather than truly concise. It conveys a basic idea without any structured or front-loaded context, so the brevity harms usefulness.

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

Completeness1/5

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

Given the tool's high complexity (43 parameters, nested objects, output schema absent, annotations empty), the description is severely incomplete. It provides no context about how the service invocation works, what parameters are essential, or what the response will look like, making successful invocation very unlikely without further documentation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is only 33%, and the description does not compensate by explaining any of the 43 parameters. It only references the endpoint path and payment method, offering no guidance on core fields like url, input, paymentPayload, or sellerUrl. Agents are left to guess parameter usage.

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

Purpose4/5

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

The description identifies a specific action ('Invoke a paid service') with a resource ('/ai/invoke') and payment mechanism ('x402 proof or developer credit'). This clearly states what the tool does, though it doesn't explicitly differentiate it from related invocation or quote tools.

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

Usage Guidelines2/5

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

No guidance is provided about when to use this tool versus alternative tools such as x402_quote_service, x402_endpoint_create_handoff, or x402_manifest. The description gives no context on prerequisites, exclusions, or recommended use cases.

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

x402_manifestCInspect

Return the public service/payment manifest.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior2/5

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

The annotations are empty, so the description alone must convey behavioral transparency. It only states that it returns a manifest, which implies a read operation, but it doesn't disclose any other behavioral details such as whether parameters alter the response, whether any auth is needed, or what the manifest structure is. This is insufficient for a tool with 43 optional parameters.

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

Conciseness2/5

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

The description is extremely brief (one sentence), which is concise, but it is under-specified rather than appropriately concise. It omits crucial information about the tool's purpose nuances and parameters, so it doesn't earn its place.

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

Completeness1/5

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

Given the tool has 43 parameters, no output schema, and a large sibling set, the description is completely inadequate. It doesn't explain the return format, how parameters influence the manifest, or any operational details, making it difficult for an agent to invoke the tool correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema has 43 parameters with only 33% description coverage, and the description provides no parameter information whatsoever. The description does not help the agent understand what any of the parameters (e.g., url, type, asset, input) do in the context of fetching a manifest, so it fails to compensate for the low schema coverage.

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

Purpose4/5

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

The description uses a clear verb 'Return' and a specific object 'public service/payment manifest,' indicating it fetches a manifest. However, it does not explain what the manifest contains or distinguish it from sibling tools like x402_endpoint_catalog or x402_quote_service, so it is clear but not differentiating.

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

Usage Guidelines2/5

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

No guidance is provided about when to use this tool versus the many sibling x402 tools. The description is a single sentence with no mention of prerequisites, alternatives, or contextual use cases.

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

x402_payment_session_statusAInspect

Check a wallet handoff session. After the user signs, returns the signed X-PAYMENT header and paid-retry instructions for the agent.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior3/5

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

With no annotations, the description gives some behavioral information: it returns the signed header after the user signs, implying a read-only status check. However, it does not disclose error behavior, prerequisites' handling, or side effects, leaving gaps.

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

Conciseness5/5

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

The description is two brief sentences, front-loaded with the primary action, and contains no unnecessary information.

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

Completeness2/5

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

Given the tool's 43 parameters, no output schema, and no annotations, the description is too minimal to fully guide an agent on how to invoke the tool correctly. It doesn't specify which params to set (e.g., sessionId, includeSignedPayment) or explain the retry instructions.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema has 33% coverage and 43 parameters, but the description does not explain which parameters are relevant or how to use them. It only implies that the signed X-PAYMENT header is returned, which relates to includeSignedPayment but is not explicit. This fails to compensate for low schema coverage.

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

Purpose5/5

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

The description clearly states the tool checks a wallet handoff session and specifies the return value (signed X-PAYMENT header and paid-retry instructions), distinguishing it from other x402 status tools.

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

Usage Guidelines4/5

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

The description provides a clear timing condition ('After the user signs') which indicates when to call the tool, but it does not mention alternative tools or when not to use it. That is clear context without explicit exclusions.

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

x402_proof_cache_statusCInspect

Return the latest cached public proof bundle for Base, Solana, manifests, receipts, and reconciliation.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior2/5

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

Annotations are empty, so the description carries full responsibility for behavioral disclosure. It mentions 'cached' and 'public', but does not explain caching freshness, whether the operation is read-only, security implications, or any side effects. Minimal transparency.

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

Conciseness5/5

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

The description is a single, front-loaded sentence with zero filler. Every word adds meaning, and it is concise to the point of being efficient. Structure is simple and clear.

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

Completeness1/5

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

Given the tool's complexity (43 parameters, no output schema, empty annotations), this one-sentence description is drastically insufficient. It does not explain what a 'proof bundle' entails, what 'reconciliation' covers, or how to specify inputs like network or manifest, making correct invocation unlikely.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With 43 parameters and schema description coverage at only 33%, the description adds no information about which parameters are relevant or how they affect the result. The schema's many parameters are entirely unaddressed, so the agent has no semantic guidance.

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

Purpose4/5

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

The description clearly states the action ('Return') and the resource ('latest cached public proof bundle') with specific categories. It is unambiguous, but it does not explicitly differentiate from many sibling *_status tools like x402_state_status, so it doesn't earn a 5.

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

Usage Guidelines2/5

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

No guidance is provided on when to use this tool versus alternatives. There is no mention of appropriate contexts, prerequisites, or exclusions, leaving the agent without decision criteria.

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

x402_purchase_creditsCInspect

Create or top up reusable developer credits through x402.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior2/5

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

Annotations are empty, so description carries full burden. 'Create or top up' indicates a state change, but the description omits critical behavioral details such as payment implications, irreversibility, or dependency on prior handoff sessions. For a financial tool, this is a significant transparency gap.

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

Conciseness4/5

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

The description is concise, one sentence, front-loaded with the action. No wasted words. However, given the tool's complexity, the brevity works against usefulness, but for conciseness alone it's strong.

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

Completeness1/5

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

With 43 parameters, no output schema, and no annotations, the description is drastically incomplete. It doesn't explain what credits are, how the purchase flow works, expected inputs, outputs, or error handling. This is completely inadequate for a complex tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 33%, and the description adds no parameter-specific meaning. It doesn't indicate which of the 43 parameters are relevant to purchasing credits, how they interact, or which are required. The few schema descriptions cover some fields but many remain unexplained.

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

Purpose4/5

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

The description clearly states the verb and resource: 'Create or top up reusable developer credits through x402.' This is specific and differentiates from status or quote tools, though it could be more explicit about what 'credits' are.

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

Usage Guidelines2/5

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

No guidance on when to use this tool versus alternatives. It doesn't mention prerequisites (e.g., wallet handoff), nor when to prefer it over x402_credit_status, x402_wallet_handoff, etc. No exclusions or context provided.

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

x402_quote_conversionCInspect

Quote a live executable conversion from the caller's crypto into required Base USDC x402 settlement.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior2/5

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

With no annotations, the description carries the full burden of disclosing behavior. It mentions 'live executable conversion' but does not clarify whether this triggers a transaction, any side effects, rate limits, or authorization requirements. The term 'live' hints at real-time pricing but lacks specifics.

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

Conciseness3/5

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

The description is a single concise sentence, but for a tool with 43 parameters it is under-specified and lacks any structural breakdown or examples. While efficient, it does not provide enough substance to be genuinely helpful.

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

Completeness2/5

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

Given the tool's complexity, the missing output schema, and the high parameter count, the description is incomplete. It does not explain what the quote returns, how the conversion is executed, or what inputs are required, leaving many critical unknowns.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The description only indirectly maps 'caller's crypto' to fromAsset and 'Base USDC' to a target asset, but with 43 parameters and only 33% schema coverage, it fails to clarify the vast majority of parameters. The description does not compensate for the low schema coverage.

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

Purpose4/5

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

The description clearly states the tool quotes a live conversion from the caller's crypto into Base USDC, specifying the resource and the target. It distinguishes itself from sibling quote tools like x402_quote_external and x402_quote_service by focusing on conversion, though 'live executable' is somewhat vague.

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

Usage Guidelines2/5

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

No guidance is provided on when to use this tool versus alternatives such as x402_quote_external or x402_quote_service. There are no mentions of prerequisites, exclusions, or specific scenarios, leaving the usage context unclear.

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

x402_quote_externalAInspect

Probe a third-party x402 seller URL or accept pasted paymentRequirements, then quote how to satisfy it from the caller's crypto.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior3/5

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

With no annotations, the description must carry the behavioral burden. It states the tool probes a URL or accepts pasted requirements and then returns a quote, which suggests it does not execute payment. It does not mention network behavior, authentication, rate limits, or that no funds are moved, but the core behavior is reasonably clear.

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

Conciseness5/5

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

The description is a single, efficiently phrased sentence. It is front-loaded with the action and resource, and every word adds meaning. No wasted content.

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

Completeness2/5

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

For a tool with 43 parameters, no output schema, and empty annotations, this description is far too thin. It does not explain what the returned quote contains, how the probe operates, or how to handle HTTP 402 semantics, leaving major gaps for complex real-world use.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema has 43 parameters and only 33% schema description coverage, so the description should compensate. It only maps to 'url' and 'paymentRequirements' but does not name the exact parameters (sellerUrl, paymentRequirements) or explain which of the many other parameters are relevant. With no required parameters, an agent is left guessing.

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

Purpose5/5

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

The description uses strong, specific verbs ('Probe', 'quote') and identifies the resource: a third-party x402 seller URL or pasted paymentRequirements. The words 'third-party' and 'external' clearly differentiate this from sibling tools like x402_quote_service and x402_quote_conversion.

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

Usage Guidelines3/5

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

The description implies when to use it: when you have a third-party seller URL or pasted paymentRequirements. However, it does not explicitly state exclusions or name alternatives such as 'use x402_quote_service for internal endpoints'.

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

x402_quote_serviceCInspect

Quote a Wisely-hosted AI/data service and payment route.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior2/5

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

With empty annotations, the description carries the full burden of behavioral disclosure. The single word 'Quote' implies a read-style operation but does not state whether it mutates state, requires authentication, or has rate limits. No side effects or permissions are disclosed.

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

Conciseness4/5

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

The description is a single sentence with no fluff, which is concise and front-loaded. However, it is so minimal that it lacks substantive structure or supplementary notes that could aid comprehension, though it earns credit for efficiency.

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

Completeness1/5

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

For a tool with 43 parameters, no output schema, and empty annotations, a one-sentence description is grossly inadequate. There is no explanation of return values, examples, or how the quoting process works, making it nearly impossible for an agent to use correctly without additional documentation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is only 33%, and the description adds no parameter information whatsoever. With 43 parameters and many undocumented in the schema, the description fails to compensate for the low coverage, leaving agents without essential guidance on what each parameter means or how to structure requests.

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

Purpose4/5

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

The description clearly states the action ('Quote') and the resource ('Wisely-hosted AI/data service and payment route'), providing a specific verb and target. However, it does not distinguish this tool from sibling quote tools like x402_quote_external or x402_quote_conversion, so it misses the highest level of differentiation.

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

Usage Guidelines2/5

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

No guidance is given about when to use this tool versus alternatives. The description does not mention use cases, prerequisites, or exclusions, leaving the agent without any context for selecting among many quote-related tools.

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

x402_rail_statusCInspect

Return proof-based readiness for Base, Solana, XRPL, Stellar, LINK, conversion, and scale gates.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior2/5

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

With no annotations, the description carries the full burden. 'Return proof-based readiness' implies a read-only status but does not disclose any state, side effects, or dependencies on other systems. It doesn't explain what 'proof-based' entails.

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

Conciseness5/5

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

The description is a single, front-loaded sentence with no redundant words, earning a top conciseness score.

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

Completeness2/5

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

Despite being concise, the description is insufficient given the tool's context: 43 parameters, no output schema, and many sibling status tools. It doesn't elaborate on the returned readiness structure or which inputs are used.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is only 33% and the description does not mention any parameters, leaving 43 potential properties unexplained. There is no hint about which parameters are relevant for this tool or how they affect the readiness check.

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

Purpose4/5

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

The description uses a specific verb ('Return') and identifies a unique resource ('proof-based readiness') with a clear scope of named gates (Base, Solana, XRPL, Stellar, LINK, conversion, scale). It distinguishes from siblings by the specific gate list, though it doesn't reference alternative tools.

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

Usage Guidelines2/5

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

No guidance is given on when to use this tool versus alternative status tools such as x402_worker_status or x402_proof_cache_status. The description solely states what it returns, not when to invoke it.

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

x402_rye_commerce_handoffCInspect

Return the Rye x402 checkout-intent flow for commerce URL checkout attempts, including DoorDash-via-Rye caveats, quote examples, and final-confirmation approval rules.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior2/5

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

With no annotations, the description carries the full burden. It mentions caveats and approval rules, but does not disclose whether the tool performs any side effects, requires authentication, or returns only informational content. The lack of detail on return format or side effects is a gap for a complex handoff flow.

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

Conciseness5/5

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

The description is a single concise sentence with no fluff. It front-loads the core purpose and includes key qualifiers (DoorDash caveats, quote examples, approval rules), making it easy to scan.

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

Completeness1/5

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

Given the tool's complexity (43 params, nested objects, no output schema), this description is severely under-specified. It does not explain what a 'handoff' returns, how to structure the invocation, or which parameters are essential. Agents would struggle to use this tool correctly without external knowledge.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is only 33% across 43 parameters, so the description must compensate. It gives minimal context by mentioning 'URL checkout attempts' and 'quote examples', which loosely implies the 'url' and maybe 'includeExamples' parameters, but it does not explain key parameters or guide selection. The description adds little value beyond the sparse schema.

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

Purpose5/5

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

The description clearly states the tool returns the Rye x402 checkout-intent flow for commerce URL checkout attempts, with a specific verb and resource. It further distinguishes scope by mentioning DoorDash-via-Rye caveats, quote examples, and approval rules, setting it apart from sibling tools like x402_gift_card_commerce_intent.

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

Usage Guidelines2/5

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

The description implies usage for commerce URL checkout attempts but provides no explicit when-to-use vs alternatives. It does not mention exclusions or name more suitable tools for related scenarios, leaving the agent to guess when to invoke this handoff.

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

x402_seller_report_statusBInspect

Return public-safe seller report freshness and totals without private payout secrets.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior3/5

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

With no annotations, the description carries the burden of disclosure. It reveals a key behavioral trait: the output will not include private payout secrets, indicating a filtered/sanitized report. It also calls the tool 'public-safe,' which hints at read-only or non-sensitive operation. However, it does not disclose whether network calls are made, auth requirements, or any side effects, so transparency is partial.

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

Conciseness5/5

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

The description is a single, compact sentence that front-loads the action and resource. It avoids filler and clearly communicates the core purpose without wasted words.

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

Completeness1/5

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

Given the tool's complexity (43 parameters, no output schema, no annotations, and many sibling tools), the description is far too sparse. It does not explain return structure, invocation prerequisites, which parameters to use, or how it compares to similar status tools. The brief mention of 'freshness and totals' is insufficient to orient an agent.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is only 33%, and the description provides no parameter guidance. With 43 parameters, zero required, and no hints about which parameters are relevant (e.g., which URL or seller identifier), the description adds no value for selecting or filling parameters. It fails to compensate for the low schema coverage.

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

Purpose5/5

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

The description clearly states the tool's function: returning seller report freshness and totals. The phrase 'public-safe' and 'without private payout secrets' adds a specific qualifier that distinguishes it from other x402 status tools. The verb 'Return' plus the concrete resource 'seller report freshness and totals' is specific and unambiguous.

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

Usage Guidelines3/5

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

The description implies when to use this tool: when one needs seller report data that is public-safe and excludes private payout secrets. However, it does not explicitly mention alternatives or provide clear 'when not to use' guidance. The 'without private payout secrets' suggests an exclusion, but the context is only implicit.

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

x402_signer_statusAInspect

Return public-safe signer gateway/custody status and KMS/HSM migration readiness for the Base facilitator relayer.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior3/5

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

With no annotations, the description carries the behavioral burden. 'Public-safe' usefully indicates the operation exposes no secrets, but the description does not disclose read-only nature, response format, or any operational caveats. It adds some context but remains thin.

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

Conciseness5/5

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

The description is a single focused sentence that front-loads the core action and resource. Every word contributes, with no filler or redundant restating of the tool name.

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

Completeness2/5

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

Despite having no output schema and a large ambiguous parameter schema, the description only states what status it returns. It omits how to interpret the status, what parameters are relevant, or how this relates to other x402 status tools, leaving the agent under-informed for correct invocation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 43 parameters with only 33% description coverage, and the tool description adds no parameter-specific guidance. The description does not clarify which schema fields apply to signer status or what values like 'url' or 'network' mean in this context, so it fails to compensate for low schema coverage.

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

Purpose5/5

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

The description uses a specific verb ('Return') and identifies a distinct resource: public-safe signer gateway/custody status and KMS/HSM migration readiness for the Base facilitator relayer. This clearly distinguishes it from sibling x402_*_status tools like x402_rail_status or x402_worker_status.

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

Usage Guidelines3/5

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

The description implies use when needing signer gateway/custody status for the Base facilitator relayer, but it does not explicitly state when to use it versus alternatives or mention any exclusions. Though the target is clear, no sibling differentiation or when-not guidance is provided.

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

x402_state_statusCInspect

Return public-safe durable-state status, migration metadata, DB counts, and JSON compatibility status.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior2/5

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

Annotations are empty, so the description carries the full burden. The phrase 'public-safe' hints that it is safe to call, but it does not explicitly state read-only behavior, side effects, auth needs, or rate limits. No additional behavioral disclosure is provided.

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

Conciseness4/5

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

The description is a single, front-loaded sentence with no wasted words. It is concise, though the concision sacrifices useful detail for such a complex tool.

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

Completeness2/5

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

For a tool with 43 parameters, no output schema, and empty annotations, the description is far too sparse. It lists return categories but fails to explain what 'durable-state' means, how the output is structured, or which parameters influence results.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is only 33%, and the description provides zero parameter guidance. With 43 parameters, the agent is left to guess which are relevant for this status call. The description adds no meaning beyond the raw schema.

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

Purpose4/5

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

The description uses a clear verb ('Return') and names a specific resource ('public-safe durable-state status, migration metadata, DB counts, and JSON compatibility status'). However, it does not differentiate this status tool from the many similar sibling status tools like x402_rail_status or x402_worker_status.

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

Usage Guidelines2/5

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

There is no guidance on when to use this tool versus alternatives. The description does not state a typical use case, prerequisites, or situations where this tool should be preferred over related status tools.

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

x402_wallet_handoffAInspect

Create a short-lived hosted wallet signing session for ChatGPT/MCP clients. The user opens a signing URL, chooses an injected wallet, mobile wallet app, or configured WalletConnect, signs in their own wallet, then the agent polls status and retries with X-PAYMENT. No private keys or seed phrases are accepted.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior4/5

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

With no annotations, the description must disclose behavior itself, and it does: the session is short-lived, the user signs in their own wallet via injected/mobile/WalletConnect, and the agent polls/retries. It also adds a key security constraint that no private keys or seed phrases are accepted. It omits expiration/side-effect details but covers the most critical behavioral expectations.

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

Conciseness5/5

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

The description is two sentences and immediately states the core action and flow. Every phrase adds meaningful context, and the final security note is high-value, making it efficient and well-structured.

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

Completeness2/5

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

Given the large parameter surface, nested objects, and no output schema, the description provides only a high-level flow and leaves the agent guessing about required arguments, return shape, and error behavior. It does not mention that a sessionId would be returned or how to map params. This is insufficient for a tool of this complexity.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema has 43 parameters with only 33% described, and the description does not map any of these to the signing flow or explain which ones are relevant. It mentions the signing URL and retry concepts but offers no parameter-level semantics beyond the schema. With such low coverage, the description should compensate but does not.

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

Purpose5/5

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

The description opens with a specific verb and resource: 'Create a short-lived hosted wallet signing session,' and clearly frames the intended clients and sign-in flow. This distinguishes it from polling/status siblings like x402_payment_session_status and from connect_wallet by focusing on creating a session rather than connecting.

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

Usage Guidelines4/5

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

It clearly describes the intended context—ChatGPT/MCP clients needing a user wallet signature—and the post-sign flow of polling and retrying with X-PAYMENT. However, it does not explicitly name alternatives or state when not to use this tool, so it stops short of full guidance.

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

x402_worker_statusBInspect

Return public-safe maintenance worker status for reconciliation, alerts, and state migration checks.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo
typeNo
assetNo
inputNoPublic-safe request body/input for a hosted service or endpoint. Never include secrets, raw cards, wallet keys, passwords, or private account tokens.
itemsNo
queryNo
sinceNo
itemIdNo
acceptsNo
contentNoPublic-safe creator content for preview/import. Do not include secrets, private student data, or copyrighted material you do not own.
networkNo
audienceNoOptional audience hint for wisely_start_here / wisely_get_playbook / wisely_agent_instructions.
payoutIdNo
platformNoOptional OS/platform hint for local bridge setup, e.g. windows, mac, linux.
amountUsdNo
creatorIdNo
fromAssetNo
localPortNoOptional localhost port for the local commerce bridge MCP server. Defaults to 4027.
receiptIdNo
sellerUrlNoThird-party x402 paid resource URL to probe for HTTP 402 payment requirements.
serviceIdNo
sessionIdNoWallet handoff/payment session id returned by x402_wallet_handoff/connect_wallet.
toAddressNo
sellerBodyNoPublic-safe POST body for an external x402 seller. Never include cookies, bearer tokens, wallet secrets, private keys, card data, or account passwords.
contentTypeNo
fromAddressNo
fromNetworkNo
manifestUrlNo
paidActionsNo
endpointSlugNo
sellerMethodNoUse POST for paid APIs that need a public-safe body before returning 402.
payoutAddressNo
serverJsonUrlNo
idempotencyKeyNoStable retry key for paid invokes and wallet handoff sessions.
paymentPayloadNo
includeExamplesNoSet false to request a shorter playbook response.
fromTokenAddressNo
preferredNetworkNoPreferred payment network for wallet handoff, e.g. eip155:8453 or base.
defaultEntitlementNo
paymentRequirementNo
paymentRequirementsNo
returnSignedPaymentNoAlias for includeSignedPayment.
includeSignedPaymentNoFor x402_payment_session_status, include the signed X-PAYMENT payload when the user has signed.
Behavior3/5

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

With empty annotations, the description carries the full burden. It discloses that the output is 'public-safe' and uses 'Return', implying a read-only operation, but it does not describe the response format, caching behavior, or potential side effects. This is minimal but slightly helpful.

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

Conciseness5/5

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

The description is a single, front-loaded sentence with no filler. It efficiently states the action, resource, and use cases, earning its place.

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

Completeness1/5

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

The tool has a very large generic schema, no annotations, and no output schema, yet the description gives no information about return values, parameter filtering, or differentiation from similar status tools. This is far from adequate 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.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Despite 43 parameters, the description provides no guidance on which parameters (if any) are relevant for this tool. Schema coverage is only 33%, and many parameters appear unrelated to worker status, so the agent is left without direction. This is a critical gap.

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

Purpose5/5

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

The description uses a specific verb ('Return') and identifies a distinct resource ('public-safe maintenance worker status') with explicit use cases (reconciliation, alerts, state migration checks). This clearly differentiates it from sibling status tools like x402_alert_status and x402_state_status.

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

Usage Guidelines4/5

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

It provides clear context by listing three specific purposes for using the tool. However, it does not explicitly name alternative tools or state when not to use it, which is a minor gap given the large sibling set.

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

Discussions

No comments yet. Be the first to start the discussion!

Related MCP Servers

  • A
    license
    -
    quality
    C
    maintenance
    Dual-rail MCP server for initiating and verifying MPP and x402 payments, plus MPP-attested identity claims, enabling agent-native financial settlement.
    MIT
  • A
    license
    -
    quality
    C
    maintenance
    A generic MCP and REST payments gateway enabling agents and services to accept payments via x402 USDC and XMR/ZEC top-ups, and make outbound ZEC payments with human co-signing, all without holding spending keys.
    MIT

View all MCP Servers

Try in Browser

Your Connectors

Sign in to create a connector for this server.