MCP server that lets Claude pay for APIs via px402 private payments on Solana
Two tools with minimal but present schemas and descriptions. px402_fetch has a complete input schema with 4 parameters (url, method, headers, body) and clear descriptions; px402_balance has an empty input schema. Both descriptions are concise (under 100 chars) but lack depth on error handling, prerequisites, and recovery guidance. No output schemas documented. No parameter constraints (e.g., enum for method is present but headers/body lack format guidance). No error classification or recovery hints. Tool names are action-oriented (fetch, balance) but descriptions do not explain WHEN to use them or what happens on 402 responses beyond 'automatically pays'. Missing idempotency guidance for a payment tool.
Read the agent wallet's base-chain USDC balance.
Call a paid API. Automatically pays with USDC on a 402 response and returns the final body.
px402_balance has no input schema (empty object). Tool is READ_ONLY but lacks output schema documentation.
No output schemas documented for either tool. LLMs cannot plan downstream calls or extract required fields (e.g., does px402_fetch return response body, status code, headers?). Does px402_balance return a number, object with balance+decimals, or string?
px402_fetch description does not explain error handling or recovery. What happens if the API returns a non-402 error? What if payment fails? How should the agent retry? No guidance on idempotency for a payment tool.
Parameter 'headers' (object type) lacks format guidance. Should it be a flat key-value map? Can values be non-strings? Parameter 'body' is a string but no guidance on encoding (JSON, form-data, raw bytes?).
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 50 | 2026-07-28+ | v2 |
Tool descriptions are under 100 chars and lack context on WHEN to use them vs alternatives. px402_fetch does not explain prerequisites (e.g., must have USDC balance? What if balance is insufficient?). px402_balance does not explain what chain or account it queries.