x402-is-luhn
Is Luhn: Check whether a number passes the Luhn checksum (used for credit cards and IDs). Provide value. 🆓 5 free trial calls per signed wallet
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| value | No |
Is Luhn: Check whether a number passes the Luhn checksum (used for credit cards and IDs). Provide value. 🆓 5 free trial calls per signed wallet
| Name | Required | Description | Default |
|---|---|---|---|
| value | No |
Changes observed during successful MCP inspections.
Input schema / properties / value / descriptionRemoved value: -"Value to process"Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are supplied, so the description carries the burden. It does disclose a real behavioral trait beyond the name: the pricing/access model ('5 free trial calls per signed wallet'), which tells the agent this is a paid x402 endpoint requiring a signed wallet. However, it says nothing about the return shape (presumably a boolean), how invalid or non-digit input is handled, or whether formatting characters are tolerated.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Purpose is front-loaded in the first clause and the whole thing is two short sentences plus a pricing note. The emoji and trial-call promo are mildly promotional but carry the only access-model information in the definition.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple boolean predicate tool with no output schema and one parameter, the core intent is conveyed. Missing pieces that matter for correct invocation are the expected input format (raw digits vs. formatted card number) and the return value, which an agent must guess.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0% for the single 'value' parameter, so the description must compensate. It only says 'Provide value' with no indication of expected format, whether digits-only is required, or whether separators like spaces or dashes are accepted — a meaningful ambiguity for checksum validation.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description names a specific algorithm (Luhn checksum) and the resource it operates on, plus parenthetical context that it's used for credit cards and IDs. That distinguishes it from generic validators like x402-credit-card-validate, though no sibling is named explicitly.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no when-to-use or when-not-to-use guidance and no mention of alternatives such as the credit-card or card-validator tools in the sibling list. 'Provide value' is an input instruction, not usage guidance, so an agent must infer applicability entirely.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Add one secure layer between your agents and this server.