MCP Server
topup
app.iomarkets/topup
What this MCP does
Lists and sells travel eSIMs, mobile top-ups, prepaid services, and international payment offers using user-approved USDC wallet payments.
Capabilities
Tools
9
tools
buy
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.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['quoteId'], 'properties': {'quoteId': {'type': 'string'}}}
create_pay_link
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 share of margin on each delivered order.
Input schema
{'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)'}}}
fx
Indicative USDC → local-currency rate at our sale price, with an estimate for an amount. The quote is the binding price.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['to'], 'properties': {'to': {'type': 'string', 'maxLength': 3, 'minLength': 3, 'description': 'ISO-4217, e.g. INR'}, 'type': {'enum': ['topup', 'bill', 'payout'], 'type': 'string', 'description': 'what the rate is for; default payout'}, 'amount': {'type': 'number', 'exclusiveMinimum': 0}}}
ledger
Public delivery ledger: totals, delivered-or-refunded %, volume, countries, recent orders.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
list_offers
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.
Input schema
{'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'}}}
lookup_phone
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.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['phone'], 'properties': {'phone': {'type': 'string', 'description': 'E.164, e.g. +919876543210'}}}
order_status
Check an order. Poll every ~3 s until `terminal` is true: delivered (confirmation + signed receipt), refunded (refund txid + signed receipt) or refund_failed.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['orderId'], 'properties': {'orderId': {'type': 'string'}}}
quote
Lock a price (10 minutes) for one purchase. Returns quoteId, exact USDC price and what will be delivered. Free. ALWAYS show the human the price and the recipient before buying.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['type', 'offerId'], 'properties': {'ref': {'type': 'string', 'description': "referrer's Algorand address — earns a share of margin if the order is delivered (GET /v1/referrals)"}, 'type': {'enum': ['topup', 'esim', 'bill', 'payout'], 'type': 'string'}, 'iccid': {'type': 'string', 'description': 'existing eSIM to top up (optional)'}, 'payer': {'type': 'string', 'description': 'the Algorand address you will pay from (required for payout compliance when this server holds no wallet)'}, 'phone': {'type': 'string', 'description': 'recipient phone for topup/bill (E.164)'}, 'amount': {'type': 'number', 'description': "for range offers: amount in the recipient's local currency", 'exclusiveMinimum': 0}, 'fields': {'type': 'object', 'description': 'bill-pay / payout recipient fields the offer lists in requiredFields (account_number, bank_code, full_name, vpa, iban…)', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': 'string'}}, 'sender': {'type': 'object', 'required': ['name', 'country'], 'properties': {'name': {'type': 'string'}, 'country': {'type': 'string', 'maxLength': 2, 'minLength': 2}, 'reference': {'type': 'string'}}, 'description': 'payouts only: the principal (legal name + country); reference = partner KYC id, required above $100/day'}, 'offerId': {'type': 'string'}}}
verify_receipt
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.
Input schema
{'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'}}}
History
Recent tool changes
Added
ledger
Sept. 17, 2026, 7:57 a.m.
Added
fx
Sept. 17, 2026, 7:57 a.m.
Added
verify_receipt
Sept. 17, 2026, 7:57 a.m.
Added
order_status
Sept. 17, 2026, 7:57 a.m.
Added
buy
Sept. 17, 2026, 7:57 a.m.
Added
create_pay_link
Sept. 17, 2026, 7:57 a.m.
Added
quote
Sept. 17, 2026, 7:57 a.m.
Added
list_offers
Sept. 17, 2026, 7:57 a.m.
Added
lookup_phone
Sept. 17, 2026, 7:57 a.m.
Discover
Similar MCP servers
Award Travel Finder
com.awardtravelfinder/mcp
Searches award flights and hotels, tracks bookings and loyalty balances, evaluates points and credit cards, and monitors travel r…
Cancun4me — Reservas de Hotel
me.cancun4/reservas
Searches, quotes, books, tracks, cancels, and provides vouchers for hotels in Cancun and Riviera Maya, with Stripe payment links.
x402card: Virtual Cards + Freeland eSIM
org.x402card/freeland-esim
Supports x402 virtual-card issuance and top-ups and lists prepaid travel eSIM plans payable with Base USDC.
esimker eSIM store
com.esimker/esim
Searches travel eSIM plans and enables purchases, top-ups, wallet funding, and checkout through card, crypto, or prepaid balance.
Hotel Booking AI MCP
io.github.tourmind-com/hotel-booking-ai-mcp
Searches hotels and live room rates, checks availability, creates and manages bookings, and generates payment requests.
booking
com.mydriverparis/booking
Resolves travel locations, flights, and trains; obtains private-driver quotes; and creates payment links for Paris transfers and …
Gitsim Chat
com.gitsim/chat
Searches, orders and manages international eSIM data packages and provides Stripe checkout links for purchases and top-ups.
pifini
net.pifini/pifini
Searches events and places across the Caribbean and Latin America, provides listings and reviews, and creates hosted ticket payme…