Skip to content
MCP server

IoMarkets Topup (demo)

Pay-per-order checkout that lets AI agents buy mobile top-ups and travel eSIMs in USDC

Answered our latest tool-list check 3 hours ago with 11 tools. It will be marked verified after 3 successful checks in 7 days.

Install
Pricing
Paid
Platforms
API, Web
Runs
Remotely
Version
0.2.12
Listing updated
today

Similar MCP servers

About IoMarkets Topup (demo)

IoMarkets Topup (demo) is a paid MCP server for agent payments. It runs as a hosted remote server, so there is nothing to install locally.

The service is a merchant rather than a payments API: each order buys an actual item from a supplier, such as an eSIM, phone airtime or data, and delivers it to a phone number. Payment is made per order in USDC on Algorand using the x402 protocol, so an agent pays the exact quoted amount from its own wallet without needing an account, API key or card.

The flow is four HTTP calls: look up a number or browse offers, request a free quote that locks the price for ten minutes, pay the 402 challenge, then poll until the order is delivered or refunded on-chain. Every terminal order carries an ed25519-signed receipt that can be checked through the service's verify endpoint, and a public ledger lists orders and outcomes.

The README and site describe this as a limited pilot. Payments are currently switched off, so quote and order requests return 503 and nothing can be bought right now. Non-goods payouts are described as waiting on a licensed partner.

Install

Run in a terminal

claude mcp add --transport http topup https://iomarkets.app/mcp

Add to Settings → Connectors → Add custom connector

https://iomarkets.app/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "topup": {
      "url": "https://iomarkets.app/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "topup": {
      "type": "http",
      "url": "https://iomarkets.app/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "topup": {
      "serverUrl": "https://iomarkets.app/mcp"
    }
  }
}

Add to Grok Bot desktop app → Connect apps → Add a custom connector

https://iomarkets.app/mcp

Enter a Name (for example "IoMarkets Topup (demo)"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "topup": {
      "type": "http",
      "url": "https://iomarkets.app/mcp"
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (11)

Read directly from the server.

7 of 11 tools say they're read-only. 4 of 11 tools say they can delete or change data.

From the server's own tool annotations; not verified by us.

lookup_phoneSays read-only
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 bo
list_offersSays read-only
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.
quoteSays it can change data
Demo only: payments are switched off, so this answers with an error and nothing can be bought. 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.
create_pay_linkSays it can change data
Demo only: payments are switched off, so this answers with an error and nothing can be bought. 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 pa
buySays it can change data
Demo only: payments are switched off, so this answers with an error and nothing can be bought. 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
quote_vouchersSays it can change data
Demo only: payments are switched off, so this answers with an error and nothing can be bought. 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
voucher_batchSays read-only
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).
order_statusSays read-only
Check an order. Poll every ~3 s until `terminal` is true: delivered (confirmation + signed receipt), refunded (refund txid + signed receipt) or refund_failed.
verify_receiptSays read-only
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.
fxSays read-only
Indicative USDC → local-currency rate at our sale price, with an estimate for an amount. The quote is the binding price.
ledgerSays read-only
Public delivery ledger: totals, delivered-or-refunded %, volume, countries, recent orders.

What it does

Settle before delivery
An order is created only after the USDC payment settles on-chain, and failed supplier deliveries are refunded to the paying address.
Exact quoted pricing
Quotes lock a USDC price for ten minutes and can be paid once.
Signed receipts
Each terminal order returns an ed25519-signed receipt that names the settlement and refund transactions.
Public ledger
The ledger lists orders, outcomes and transaction IDs, including stranded orders.
Pay links for humans
An agent without a wallet can create a link that a human approves in their own Pera wallet.

Good for

  • Topping up a mobile phone number in another country
  • Buying a travel eSIM for a trip
  • Letting an agent pay for small prepaid services without a card
  • Paying a list of recipients from one wallet with a receipt for each

Pricing

Paid

Per-order pricing in USDC; quotes are shown per purchase. Payments currently disabled.

Prices change. Check iomarkets.app before you buy.

IoMarkets Topup (demo) FAQ

Can I buy anything right now?

No. The README and site state that payments are switched off, so quote and order requests answer 503 and nothing can be bought in the current demo.

What is the payment method?

Orders are paid per order in USDC on Algorand mainnet using the x402 protocol, with no account, API key or card required.

What products are available in the pilot?

Mobile airtime and data top-ups and travel eSIMs. The README says prepaid bills and international payouts are built but supplier-gated.

What happens if a delivery fails?

The full amount is refunded to the paying address on-chain automatically, and the order receives a signed receipt.

Is IoMarkets Topup (demo) free?

No. IoMarkets Topup (demo) is a paid product.

How do I add IoMarkets Topup (demo) to Claude Code?

Run this command in your terminal: claude mcp add --transport http topup https://iomarkets.app/mcp

What are the best alternatives to IoMarkets Topup (demo)?

The closest alternatives to IoMarkets Topup (demo) are X402 Payagent MCP, SI Dog Park, Pay, Ego Agent Marketplace and Agent Payment Guard.

Where this comes from

  • Description: written from the project's README, the project's website and its MCP Registry entry.
  • Status and tools: checked automatically by AIPoweredBot on 19 November 2026.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers