Server Quality Checklist

Tool Scores

• x402_place_orderB
  3.2/5.0
  Behavior2/5

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

  With no annotations, the description carries full burden. It discloses response structure (status, headers, body, original request) but omits side effects, financial implications, or order placement behavior hinted by the name. The description presents a benign HTTP call while the name suggests a mutating financial action, which is misleading.

  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 purpose, and contains no redundant information. It 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?

  The description enumerates return values but fails to address the broader payment/order context, error handling, or integration with sibling x402 tools. Given the complexity implied by the name and sibling set, it is incomplete and leaves significant operational gaps.

  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?

  Schema coverage is 100%, with all parameters (url, body, method) described including the method enum. The description adds no additional parameter meaning beyond the schema, so it meets the baseline for high schema coverage but doesn't elevate understanding.

  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 sends an HTTP request and returns complete response details, which is a specific verb+resource. However, it is misaligned with the tool name 'x402_place_order', which implies a business order placement rather than a generic HTTP client, and it doesn't distinguish itself from payment-focused 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 Guidelines3/5

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

  It provides a general usage context ('Use this for any HTTP request where you need full response details') but no explicit when-not-to-use guidance or alternatives. It doesn't explain how this tool relates to siblings like x402_submit_payment, leaving the agent without clear selection criteria.

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

• x402_create_signatureA
  3.8/5.0
  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 describes the operation (parse, create signature) and the return value (payload and header), and lists supported signing modes. However, it does not disclose potential prerequisites (e.g., wallet configuration), failure modes, or authentication requirements, leaving some behavioral gaps for a signing 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 three sentences, front-loaded with the primary action and returns. It efficiently states the purpose, supported modes, and downstream usage without wasted words. Every sentence adds value.

  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 4 optional parameters, no output schema, and no annotations, the description covers the main outcomes (returned payload and header) and integration with x402_submit_payment. It also lists signing modes. It could be more complete by describing the exact return structure or edge cases, but it is adequate for the tool's complexity.

  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 provides 100% parameter description coverage, so the baseline is 3. The description adds minimal semantics beyond the schema by mentioning signing modes, which aligns with the sign_mode enum, but it does not add deeper meaning for the other parameters (e.g., how payment_required_header interacts with response_body).

  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+resource: 'Parse X402 payment requirements and create a signed payment authorization.' It clearly states what the tool does and what it returns (payload with signature and PAYMENT-SIGNATURE header). It does not explicitly differentiate itself from the sibling x402_sign_payment, but the mention of parsing requirements and returning a complete payload adds specificity.

  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?

  Clear context is provided by stating the output can be used with x402_submit_payment to complete the payment request, which implies when to use this tool (before submission). However, it does not mention exclusions or explicitly contrast with alternative sibling tools like x402_sign_payment, so it lacks full 'when not to use' guidance.

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

• x402_sign_paymentA
  4.3/5.0
  Behavior4/5

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

  With no annotations, the description carries the full burden and discloses the complete workflow: parsing, signing, and submission. It explicitly notes that Gate Pay auth is not performed via MCP calls, a useful behavioral constraint. It does not detail potential side effects like actual fund transfer or failure modes, but the payment intent is clear.

  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?

  Four sentences, front-loaded with the main action. It efficiently covers purpose, signing modes, and an important exception for centralized payment. The inclusion of the Chinese phrase is slightly redundant but not harmful.

  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?

  The description covers the main workflow, input alternatives, and mode selection. It omits return value details, but with no output schema, some ambiguity remains. Overall, for a complex tool with 7 parameters, it is reasonably complete.

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

  Parameters4/5

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

  Schema coverage is 100%, so the baseline is 3. The description adds meaning by explaining that payment_required_header and response_body are alternative inputs and by clarifying the wallet types for sign_mode (local EVM wallet, custodial MCP wallet, browser extension wallet), which goes beyond the schema's brief descriptions.

  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 parses X402 payment requirements, creates a signed payment, and submits it to complete a 402-protected request. It lists specific signing modes, distinguishing it from siblings like x402_submit_payment, which is referenced for centralized payments.

  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 instructs that for centralized payment (中心化支付), users should obtain a Gate Pay access token via x402_gate_pay_auth and use x402_submit_payment instead, providing a clear alternative. It also specifies the two input sources (payment_required_header or response_body) and when to use each.

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

• x402_centralized_paymentA
  4.4/5.0
  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 key behaviors: automatic OAuth handling, amount conversion from smallest unit (divide by 10^6), specific fields parsed from the header, and a return value containing transaction details. It does not mention error conditions or side effects, but the core mutating action is 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 three sentences, front-loading the primary action and then adding only necessary details about auth and parsing. Every sentence contributes meaningful information without redundancy or verbosity.

  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?

  The tool has one parameter, no output schema, and moderate complexity. The description covers the input processing, the external API call, and the return type sufficiently. It lacks explicit sequencing guidance among sibling tools, but is otherwise complete for its scope.

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

  Parameters4/5

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

  The input schema describes the parameter as a Base64-encoded PAYMENT-REQUIRED header value, with high coverage. The description adds meaning beyond the schema by explaining what payment information is extracted (amount, currency, prepayId, orderId) and the amount unit conversion, which is valuable 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 clearly states a specific action ('Execute centralized payment') and specifies the mechanism (parsing PAYMENT-REQUIRED header and calling the Gate Pay API). It also distinguishes itself from sibling x402_gate_pay_auth by noting it handles the same auth automatically, making the tool's role 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 implies the tool is used when a PAYMENT-REQUIRED header is present and notes that OAuth is handled automatically, avoiding a separate call to x402_gate_pay_auth. However, it does not explicitly compare against other payment-related siblings like x402_submit_payment or x402_place_order, so exclusion criteria are not fully stated.

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

• x402_submit_paymentA
  4.4/5.0
  Behavior4/5

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

  With no annotations present, the description carries the full disclosure burden. It covers key behaviors: submitting the signed payment, conditional OAuth execution (local callback + remote token exchange), attaching the Bearer token, and returning the merchant's final response. It stops short of explaining error cases, idempotency, or failure modes, but the main behavioral traits 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.

  Conciseness5/5

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

  The description is three focused sentences. The purpose is front-loaded in the first sentence, and each subsequent sentence adds necessary detail about input source and conditional behavior. There is no fluff or repetition, making it appropriately sized for the complexity.

  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?

  For a tool with no output schema and moderate complexity, the description explains the return value (final response from merchant) and the conditional auth flow. It also ties into the sibling workflow by referencing x402_create_signature. It lacks explicit instruction on when NOT to use it or potential failure scenarios, but it is sufficient for correct summoning in a typical flow.

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

  Parameters4/5

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

  Schema coverage is 100%, so the baseline is 3. The description adds meaningful context beyond the schema by linking payment_signature to x402_create_signature and explaining that sign_mode=centralized_payment triggers OAuth and an Authorization header. This helps an agent understand the relationships between parameters, raising it above baseline.

  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: "Submit a signed payment to complete a 402-protected request." It clearly identifies the tool's role in the payment flow and distinguishes it from siblings by referencing input from x402_create_signature. The purpose is unmistakable and does not rely on the tool name alone.

  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 a clear workflow position: "Takes the payment_signature from x402_create_signature" indicates this is used after signature creation. It also notes the conditional handling of sign_mode when set to centralized_payment, aligning with x402_gate_pay_auth. However, it does not explicitly contrast with sibling x402_centralized_payment, so no direct alternatives or exclusions are stated.

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

• x402_quick_wallet_authA
  4.6/5.0
  Behavior5/5

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

  With no annotations provided, the description carries the full behavioral burden. It discloses that a valid MCP token short-circuits to ready status, otherwise a browser flow opens, and it reveals side effects such as post-login confirmation, session persistence until restart, and the need to restart to switch providers. These are substantial behavioral traits beyond a simple 'auth' label.

  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 appropriately sized and front-loaded, starting with the trigger and purpose. Each of the four sentences contributes unique information: trigger/purpose, valid-token behavior, fresh-login confirmation, and provider/session caveat. There is no filler or redundant wording.

  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?

  The tool has no output schema and no annotations, so the description must cover both normal and interactive flows. It covers the valid-token path, the browser-flow path, provider selection, post-login confirmation, and session/restart behavior. It does not detail failure modes or return structure, but for an auth handoff tool this is reasonably complete.

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

  Parameters4/5

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

  The schema already provides 100% coverage for wallet_login_provider with enum values and descriptions. The description adds the default value ('Gate by default') and explains how the parameter maps to the browser flow, plus the restart constraint for changing providers. This exceeds the baseline 3 for high 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 opens with a specific trigger ('when user selects sign_mode quick_wallet') and a clear action ('run this tool first to perform device-flow login/authorization'). It also states explicit outcomes (returns ready status and wallet addresses, or opens a browser flow), which distinguishes it from sibling tools. This is a specific verb+resource+scope, not a tautology.

  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 ('when user selects sign_mode quick_wallet, run this tool first') and gives sequencing context ('before continuing to payment'). It does not name sibling alternatives or provide when-not-to-use conditions, but the trigger is clear enough. This is clear contextual guidance without exclusions.

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

• x402_gate_pay_authA
  4.9/5.0
  Behavior5/5

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

  With no annotations provided, the description fully takes on the burden of behavioral disclosure. It thoroughly details the OAuth flow: browser opens the Gate authorize URL, redirect hits localhost callback, client exchanges code for access_token via the remote OAuth backend, and the token is stored in-process for later Authorization Bearer header. It even lists the success JSON fields, providing transparent operational 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 a compact paragraph of three sentences, front-loaded with the trigger condition and then systematically covering the OAuth flow, storage, downstream use, and success output. Every sentence contributes valuable information without redundancy or filler.

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

  Completeness5/5

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

  For a zero-parameter tool with no output schema and no annotations, the description is exceptionally complete. It covers the trigger, the full OAuth mechanism, the in-process storage side effect, downstream integration with x402_submit_payment, and differentiates from related tools. No important operational context is missing.

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

  Parameters4/5

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

  The tool has zero parameters, so the schema is trivially complete and the baseline score of 4 applies. While the description does not add parameter-level detail (there are none), it explains the overall process and side effects, which is sufficient for a parameterless tool.

  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 'run this tool to complete Gate Pay OAuth' and specifies the exact trigger condition ('When the user chooses centralized_payment'). It distinguishes itself from the sibling tool x402_quick_wallet_auth by clarifying that wallet MCP login is separate and not used for Gate Pay.

  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?

  It provides an explicit when-to-use rule: run when the user chooses centralized_payment. It also names an alternative (wallet MCP login) and explicitly excludes it from Gate Pay, giving the agent clear guidance on tool selection.

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