Topup

Working · 2.2 s

app.iomarkets/topupv0.2.8 Domain verified

Travel eSIMs and mobile top-ups paid in USDC via x402. A technology demonstration, limited pilot.

Commerce

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://iomarkets.app/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

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. Works the same for a quote from quote_vouchers; the paid response is the batch (batchId and claim links) rather than an order.

quoteIdstring, required

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Tools (11)

buy

Argument	Type	Description
quoteId*	string

Input schema (JSON)

{
  "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.

Argument	Type	Description
ref	string	your Algorand address, to earn referral share
note	string	shown on the link page, e.g. 'Your Tokyo trip data'
type*	string
phone	string	topup only: recipient phone, E.164
amount	number	for range top-up offers: amount in local currency
offerId*	string
max_uses	integer	0 = reusable until expiry; default 1 for topup, 0 for esim
ttl_hours	integer	default 168 (7 days)

Input schema (JSON)

{
  "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)"
    }
  }
}

Indicative USDC → local-currency rate at our sale price, with an estimate for an amount. The quote is the binding price.

Argument	Type	Description
to*	string	ISO-4217, e.g. INR
type	string	what the rate is for; default payout
amount	number

Input schema (JSON)

{
  "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.

No arguments.

Input schema (JSON)

{
  "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.

Argument	Type	Description
type*	string	payout = international payment (bank / mobile money / UPI)
brand	string
limit	integer	page size, default 100; 0 means all
offset	integer	use next_offset from the previous page
country	string	ISO-3166 alpha-2, e.g. IN

Input schema (JSON)

{
  "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.

Argument	Type	Description
phone*	string	E.164, e.g. +919876543210

Input schema (JSON)

{
  "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.

Argument	Type	Description
orderId*	string

Input schema (JSON)

{
  "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.

Argument	Type	Description
ref	string	referrer's Algorand address — earns a share of margin if the order is delivered (GET /v1/referrals)
type*	string
iccid	string	existing eSIM to top up (optional)
payer	string	the Algorand address you will pay from (required for payout compliance when this server holds no wallet)
phone	string	recipient phone for topup/bill (E.164)
amount	number	for range offers: amount in the recipient's local currency
fields	object	bill-pay / payout recipient fields the offer lists in requiredFields (account_number, bank_code, full_name, vpa, iban…)
sender	object	payouts only: the principal (legal name + country); reference = partner KYC id, required above $100/day
offerId*	string

quote_vouchers

Lock a price (10 minutes) for a BATCH of travel eSIMs paid in one payment: N claim links, one per person, for a group trip, a conference delegation or event giveaways. Each eSIM is bought when its link is claimed (the person opens it on their phone and installs the QR), and links nobody claims within 30 days are refunded to the paying wallet. Free. Pay the returned quoteId with `buy`, or send the human to this service's /pay/?mode=vouchers page to buy it with their own wallet. Limits: 2–50 eSIMs, each within the per-order limit, the batch within its own limit ($100 by default). ALWAYS show the human the total and the count before buying.

Argument	Type	Description
note	string	shown on every claim page, e.g. 'Devcon 8 delegation'
count*	integer	how many eSIMs, i.e. claim links
payer	string	the Algorand address you will pay from
offerId*	string	an esim offer from list_offers type=esim

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "offerId",
    "count"
  ],
  "properties": {
    "note": {
      "type": "string",
      "maxLength": 140,
      "description": "shown on every claim page, e.g. 'Devcon 8 delegation'"
    },
    "count": {
      "type": "integer",
      "maximum": 50,
      "minimum": 2,
      "description": "how many eSIMs, i.e. claim links"
    },
    "payer": {
      "type": "string",
      "description": "the Algorand address you will pay from"
    },
    "offerId": {
      "type": "string",
      "description": "an esim offer from list_offers type=esim"
    }
  }
}

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.

Argument	Type	Description
onChain	boolean	confirm the txids on chain; default true
orderId	string	an order on this service
receipt	any	a receipt {payload, signature}, or an order response containing one

Input schema (JSON)

{
  "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"
    }
  }
}

voucher_batch

A paid voucher batch: every claim link, which have been claimed and delivered, the expiry, and any refund for unclaimed links. The batchId is the only handle on the links — keep it, and hand each person their own link privately (whoever opens a link first gets that eSIM).

Argument	Type	Description
batchId*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "batchId"
  ],
  "properties": {
    "batchId": {
      "type": "string"
    }
  }
}