{"serverId":"mcp-registry/app.iomarkets/topup","tools":[{"name":"buy","fixed":{"name":"buy","description":"Get the x402 payment challenge for a quote. This hosted server holds no wallet, so it does NOT spend your money: it returns the exact amount, asset, payTo address and facilitator for you to pay from your own Algorand wallet, then you POST the quote again with your payment signature. Requires prior human confirmation of the quote. Works the same for a quote from quote_vouchers; the paid response is the batch (batchId and claim links) rather than an order.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["quoteId"],"properties":{"quoteId":{"type":"string"}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: false (inferred from the name).","verify":true}],"tokensBefore":178,"tokensAfter":178},{"name":"create_pay_link","fixed":{"name":"create_pay_link","description":"Create a checkout link a HUMAN pays from their own Algorand wallet (Pera). Use this when you have no wallet, or when the person should approve and pay themselves: they open the link, see the exact price, sign in their wallet, and the result (the eSIM QR code, or the top-up confirmation) appears on the page. You never hold a key. A top-up link can be paid by anyone — send it to family as 'top up my phone'. An eSIM link delivers to whoever pays. Free. Add `ref` (your Algorand address) to earn a sh","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["type","offerId"],"properties":{"ref":{"type":"string","description":"your Algorand address, to earn referral share"},"note":{"type":"string","maxLength":140,"description":"shown on the link page, e.g. 'Your Tokyo trip data'"},"type":{"enum":["topup","esim"],"type":"string"},"phone":{"type":"string","description":"topup only: recipient phone, E.164"},"amount":{"type":"number","description":"for range top-up offers: amount in local currency","exclusiveMinimum":0},"offerId":{"type":"string"},"max_uses":{"type":"integer","maximum":1000,"minimum":0,"description":"0 = reusable until expiry; default 1 for topup, 0 for esim"},"ttl_hours":{"type":"integer","maximum":720,"minimum":1,"description":"default 168 (7 days)"}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: false (inferred from the name).","verify":true}],"tokensBefore":379,"tokensAfter":379},{"name":"list_offers","fixed":{"name":"list_offers","description":"Browse purchasable offers: mobile top-ups, travel eSIMs, prepaid bills, or international payment corridors (bank / mobile money / UPI) for a country. Free. Prices shown are indicative; the quote fixes them.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["type"],"properties":{"type":{"enum":["topup","esim","bill","payout"],"type":"string","description":"payout = international payment (bank / mobile money / UPI)"},"brand":{"type":"string"},"limit":{"type":"integer","maximum":500,"minimum":0,"description":"page size, default 100; 0 means all"},"offset":{"type":"integer","maximum":9007199254740991,"minimum":0,"description":"use next_offset from the previous page"},"country":{"type":"string","maxLength":2,"minLength":2,"description":"ISO-3166 alpha-2, e.g. IN"}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":238,"tokensAfter":238},{"name":"lookup_phone","fixed":{"name":"lookup_phone","description":"Identify the country and mobile operator of a phone number and list the top-up offers available for it. Free. The operator is DETECTED from the number range and is a guess: MVNOs (Tesco Mobile, Giff Gaff, Lebara, Voxi, Sky…) resolve to the host network they ride on. Read the detected brand back to the human and have them confirm it before buying, and use `other_brands` to correct it — a voucher bought for the wrong network delivers successfully and cannot be redeemed or refunded.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["phone"],"properties":{"phone":{"type":"string","description":"E.164, e.g. +919876543210"}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":198,"tokensAfter":198},{"name":"order_status","fixed":{"name":"order_status","description":"Check an order. Poll every ~3 s until `terminal` is true: delivered (confirmation + signed receipt), refunded (refund txid + signed receipt) or refund_failed.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["orderId"],"properties":{"orderId":{"type":"string"}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: false (inferred from the name).","verify":true}],"tokensBefore":97,"tokensAfter":97},{"name":"verify_receipt","fixed":{"name":"verify_receipt","description":"Verify an ed25519-signed receipt: the signature, and — unless you pass onChain:false — both txids against an Algorand indexer. Give it an orderId to check one of this service's own orders, or a receipt object to check ANY receipt in this format, including one issued by another server.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"onChain":{"type":"boolean","description":"confirm the txids on chain; default true"},"orderId":{"type":"string","description":"an order on this service"},"receipt":{"description":"a receipt {payload, signature}, or an order response containing one","type":"string"}}}},"changes":[{"kind":"schema","detail":"Added \"type\":\"string\" to untyped parameters: receipt. Change to number/boolean/array where that's what you accept.","verify":true}],"tokensBefore":189,"tokensAfter":193}],"toolsChanged":6,"tokensSaved":0,"todo":[{"tool":"buy","params":["quoteId"]},{"tool":"create_pay_link","params":["type","offerId"]},{"tool":"fx","params":["amount"]},{"tool":"list_offers","params":["brand"]},{"tool":"order_status","params":["orderId"]},{"tool":"quote","params":["type","offerId"]},{"tool":"voucher_batch","params":["batchId"]}],"note":"Deterministic fixes. Changes marked verify need a human look before shipping (renames, inferred annotations, inferred types, removed text). Parameter descriptions in `todo` need to be written by someone who knows the API."}