IoMarkets Topup (demo)

Name: IoMarkets Topup (demo)
Author: SergoVashakmadze

제작자: SergoVashakmadze버전 0.2.12i★ 0i클라우드에서 실행

레지스트리 이름app.iomarkets/topup

설치

개요

제작자가 쓴 설명(영어 원문)

Demo only, payments switched off. Travel eSIMs and mobile top-ups priced in USDC via x402.

PopNx MCP의 세 기둥

이 세 가지는 절대 하나의 점수로 합치지 않아요. 의견, 측정, 인기는 서로 다른 것이니까요.

사용자 의견i아직 리뷰가 없어요리뷰는 다음 단계에서 계정 기능과 함께 열려요
우리의 기본 점검i4개 중 4개 통과공개된 정보로 점검했으며, 코드는 아직 스캔하지 않았어요
사용 정도i초기★ 0

할 수 있는 일

이 서버는 아직 쉬운 말로 된 요약을 쓰지 못했어요. 아래는 레지스트리에서 읽어 온 사실이에요.

연결 방식: 클라우드에서 실행
전송 방식: Streamable HTTP
카테고리: 여행, 지도 및 날씨

설치

쓰고 있는 AI 앱을 고른 다음 설정을 복사하세요.

설치하기 전에

기본 점검: 4개 중 4개 통과
제작자의 서버에서 실행돼요. 내가 요청한 내용은 제작자의 서버를 거쳐요.
할 수 있는 일 11가지(도구) lookup_phone, list_offers, quote, create_pay_link …
레지스트리에 입력해야 할 키가 나와 있지 않아요.

필요한 것

클라우드에서 실행설치할 것 없음. 인터넷으로 연결돼요

어떤 앱을 쓰세요?

ClaudeClaude CodeCursorVS CodeChatGPT

위에서 앱을 고르세요. 기억해 두었다가 다음부터는 버튼에 “…에 설치”라고 표시해요.

웹, 데스크톱, 모바일의 Claude에서 쓸 수 있어요:

Settings → Connectors 열기
Add custom connector 누르기
아래 주소를 붙여 넣고 Add 누르기
로그인하라고 하면 제작자의 서비스에 로그인하기

https://iomarkets.app/mcp

터미널에서 이 명령어를 실행하세요

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

Cursor에서 열기

또는 설정을 직접 복사하기

프로젝트의 .cursor/mcp.json 또는 ~/.cursor/mcp.json에 붙여 넣으세요

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

브라우저가 앱을 열지 물어본 다음, 앱이 설정을 보여 주고 확인을 요청해요. 키 값은 비워 두니 직접 입력하세요.

VS Code에서 열기

또는 설정을 직접 복사하기

프로젝트의 .vscode/mcp.json에 붙여 넣으세요

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

브라우저가 앱을 열지 물어본 다음, 앱이 설정을 보여 주고 확인을 요청해요. 키 값은 비워 두니 직접 입력하세요.

ChatGPT는 인터넷에 있는 서버에만 연결할 수 있어요:

웹에서 ChatGPT 열기 → Settings → Connectors (Apps)
Create 또는 Add 누르기(일부 요금제는 먼저 Advanced에서 Developer mode를 켜야 해요)
아래 주소를 붙여 넣고 이름을 정한 뒤 저장하기
로그인하라고 하면 제작자의 서비스에 로그인하기

https://iomarkets.app/mcp

메뉴 이름은 요금제나 시기에 따라 조금 다를 수 있어요.

선택한 앱은 이 기기의 쿠키에만 저장돼요. 계정은 필요 없어요.

이 설정은 제작자의 레지스트리 정보로 만들었어요. README와 다르면 README를 따르세요.

할 수 있는 일

도구 이름과 설명은 서버가 2026년 11월 10일에 알려 준 그대로예요. 우리가 아니라 제작자가 쓴 글이고, 일반 텍스트로만 보여 드려요.

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 dete
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.
quote
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_link
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, se
buy
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 yo
quote_vouchers
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 boug
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).
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.
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 se
fx
Indicative USDC → local-currency rate at our sale price, with an estimate for an amount. The quote is the binding price.
ledger
Public delivery ledger: totals, delivered-or-refunded %, volume, countries, recent orders.

기본 점검i

누구나 볼 수 있는 정보를 점검했고, 코드는 읽지 않았어요. 해당하지 않는 항목은 개수에서 뺐어요. · 2026년 11월 10일 점검

✓ 통과
제작자와 저장소 일치
레지스트리 이름이 도메인 iomarkets.app 기준으로 확인되었어요(레지스트리가 도메인 소유를 확인해요)
✓ 통과
계속 관리되고 있음
코드 마지막 변경: 어제
… 아직 점검 안 함
라이선스 있음
아직 GitHub에서 이 저장소를 읽어 오지 않았어요
✓ 통과
엔드포인트 응답
128ms 만에 응답(HTTP 200)
– 해당 없음
OAuth로 로그인
로그인 필요 없음
✓ 통과
도구 설명에 숨겨진 지시 없음
도구 설명 11개를 읽었고, AI에게 보내는 숨겨진 지시는 없었어요

여행, 지도 및 날씨 카테고리의 다른 서버와 비교i

이 카테고리의 다른 서버 1795개 중 0%보다 스타가 많아요
이 카테고리의 다른 서버 1795개 중 94%보다 최근에 레지스트리에 공개됐어요
기본 점검 결과가 이 카테고리의 다른 서버 1795개 중 100%와 같거나 더 좋아요

레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.

자주 묻는 질문

IoMarkets Topup (demo), 안전한가요?

해당하는 기본 점검 4개 중 4개를 통과했어요. 코드는 읽지 않았어요. 키나 토큰을 넣기 전에 서버가 어떤 권한을 요구하는지 확인하고, 꼭 필요한 권한만 있는 키를 쓰세요.

어떤 키나 코드가 필요한가요?

레지스트리에 필수 키가 나와 있지 않아요. 다만 처음 쓸 때 로그인을 요구하는 서버도 있어요.

내 컴퓨터에서 실행되나요, 클라우드에서 실행되나요?

제작자의 클라우드에서 실행돼요. 설치 없이 인터넷으로 연결하지만, 보내는 내용은 제작자의 서버를 거쳐요.

아직 관리되고 있나요?

GitHub 저장소는 마지막으로 어제 변경됐고, 최신 버전(0.2.12)은 어제 레지스트리에 올라왔어요.

어떤 앱에서 쓸 수 있나요?

Claude Desktop, Claude Code, Cursor, VS Code처럼 MCP를 지원하는 앱에서 쓸 수 있어요. URL로 연결되기 때문에, 원격 MCP 서버를 지원하는 앱(예: 개발자 모드의 ChatGPT)에서도 쓸 수 있어요.

대신 쓸 수 있는 건 뭐가 있나요?

같은 카테고리에는: LetsFG — Flights & Hotels, Google Maps MCP Server, Mu

대안

같은 카테고리에서 다른 제작자가 만든 서버예요. 스타 순으로 정렬했어요.

카드 보는 법:↓ 주간 다운로드i★ GitHub 스타i세 기둥: 리뷰 · 점검 · 사용 정도i업데이트 = 최신 버전을 레지스트리에 공개한 날i

LetsFG — Flights & Hotels

Search and book flights and hotels: hundreds of airlines, plus bookable hotel rates.

제작자: LetsFG널리 사용됨↓ 204/주★ 2.3천2개월 전 업데이트

컴퓨터 또는 클라우드

설치

Google Maps MCP Server

18 Google Maps tools for AI agents — geocode, search, directions, weather, and more.

제작자: cablate성장 중↓ 1.3천/주★ 491지난달 업데이트

내 컴퓨터에서 실행

설치

Mu

News, web search, mail, markets, weather, places, files, calendar, contacts. 67 tools, one endpoint.

제작자: micro성장 중★ 4383개월 전 업데이트

클라우드에서 실행✓ micro.mu

설치

제작자의 README

README 열기

제작자의 저장소에서 쓰인 그대로 가져왔어요. PopNx MCP가 검토하거나 보증한 내용이 아니에요. HTML, 이미지, 스크립트는 제거했어요. 링크를 누르면 이 사이트를 벗어나요.

IoMarkets Topup — real-world checkout for AI agents on Algorand

Demo only: payments are switched off and nothing can be bought. This is a technology demonstration, not a commercial service.

Your AI agent can buy real things — and send money. In the pilot today: travel eSIMs and mobile airtime/data top-ups. Prepaid bills and international payments (bank / mobile money / UPI payouts via a licensed partner) are built and supplier-gated. Everything is paid per order in USDC on Algorand via x402. No account, no API key, no card. Money settles on-chain first, goods ship second, failures refund on-chain automatically, and every terminal order carries an ed25519-signed receipt anyone can verify.

Built for the Global x402 Challenge (Algorand Foundation × GoPlausible). Pilot: https://iomarkets.app · agent docs: /agent.md · ledger: /v1/ledger · receipt spec: docs/RECEIPTS.md

How it works

agent ── GET /v1/lookup?phone=+91…  ─▶ operator + offers                      (free)

agent ── POST /v1/quote {type, offerId, recipient, amount} ─▶ quoteId, price (free, 10-min lock) agent ── POST /v1/orders {quoteId} ─▶ 402 + exact USDC amount (x402) agent ── …signs Algorand USDC payment, retries with PAYMENT-SIGNATURE ─▶ facilitator settles on-chain server ── order created ONLY after settlement ─▶ supplier purchase ─▶ delivered | failed → on-chain refund agent ── GET /v1/orders/{id} ─▶ status, confirmation (operator ref / eSIM LPA), signed receipt, txids

Route	Cost	Purpose
`GET /v1/lookup?phone=`	free	country / operator / offers for a number
`GET /v1/catalog?type=topup\	esim\	bill\	payout&country=&limit=&offset=`	free	browse offers / payout corridors with indicative USDC prices (paged: 100 by default, `total` + `next_offset` in the response, `limit=0` for all)
`GET /v1/countries?type=esim`	free	every destination a product reaches; `enumerable:false` = the supplier will not list them
`GET /v1/fx?to=INR&amount=&type=`	free	indicative USDC→local rate at our sale price + estimate (`type` = topup \	bill \	payout, since the markup can differ per product)
`POST /v1/quote`	free	lock an exact price for one purchase
`POST /v1/orders`	the quoted amount, x402	pay → order
`GET /v1/orders/:id`	free	status, confirmation, signed receipt, refund txid
`POST /v1/verify`	free	verify any receipt: signature + both txids on chain (`?online=0` for signature only)
`GET /v1/ledger` · `GET /v1/pubkey` · `GET /agent.md` · `GET /fund`	free	public ledger · receipt key · agent instructions · how to get USDCa
`GET /.well-known/agent-card.json` · `GET /.well-known/agent.json`	free	A2A agent card — what registries and agent routers read: the live skill list (rendered from what the suppliers can actually fill), the provider, and x402 declared as a required capability with the paid route named. Claims no transport and no `url`: this server does not speak A2A JSON-RPC, and neither `HTTP+JSON` nor a made-up `MCP` is an honest value for that field, so the card is discovery metadata and `documentationUrl` sends a caller to `/agent.md` for the interface that exists (`src/agent-card.ts`)
`GET /v1/client-config`	free	network, CAIP-2 id, algod URL, USDC ASA and the order ceiling — what a browser needs to build a payment (public values only)
`GET /pay`	free	the batch payout console — paste a spreadsheet, price every row, approve once, export receipts (`web/`, `?demo=1` for canned data)
`GET /console`	free	the original single-file console — no build step, works when `web/dist` is absent
`POST /v1/links` · `GET /v1/links/:id` · `POST /v1/links/:id/quote`	free	pay links — an agent with no wallet hands its human a checkout URL (`/l/:id`); they approve the exact price in their own Pera wallet. A top-up link is a "top up my phone" request anyone can pay
`GET /p/:settlement_txid` · `GET /v1/proof/:txid`	free	proof of delivery — shareable page per goods order (price, delivery time, on-chain settlement, checked signature), keyed by the public txid, never the order id; "get the same eSIM" credits the original buyer
`GET /v1/referrals` · `GET /v1/referrals/:address` · `GET /earn`	free	referral share — `ref` on any quote or link earns a share of net margin on delivered orders, paid on-chain in USDC; off until `REFERRAL_SHARE_BPS` > 0
`GET /` · `GET /brand/logo.webp` · `GET /favicon.ico`	free	the human landing page — what, why, who, a live-catalogue explorer with a simulated purchase, the ledger, and where the product sits in the IoMarkets® ecosystem; the logo and icons every page shares (`src/brand.ts`)

Trust model (what makes agents use it extensively)

No order without a settled payment — the order row is created from the facilitator's settlement txid.
Exact pricing — the 402 challenge carries the quoted amount; a quote pays once and expires in 10 min.
Automatic refunds — supplier failure ⇒ USDC returned to the paying address on-chain, note = order id.
Signed receipts — {order, amount, payer, settlement txid, refund txid} signed with a published ed25519 key (pnpm verify receipts/ .json --online checks the signature *and* both transactions on Algorand). The same check is an endpoint anyone can call — POST /v1/verify — and it verifies receipts from any server that adopts the format, not just ours. The format is a spec: docs/RECEIPTS.md.
Public ledger — every order, outcome and txid (recipients hashed).
Abuse posture — $50/order (goods), $200/payment (payouts), $200/payer/day, sanctioned destinations refused, replay guard, rate limits; payouts need a sender record and a partner KYC reference above $100/day (src/compliance.ts).
Key hygiene — the server holds one hot key (refund float, daily-capped); PAY_TO is an address only; secrets come from files / systemd encrypted credentials, never .env (see src/keys.ts).

Run it

pnpm install --frozen-lockfile --ignore-scripts

cp .env.example .env # PAY_TO, RECEIPT_* (pnpm gen-key), SUPPLIER=mock to start pnpm dev # http://127.0.0.1:3000 (NETWORK=mainnet — the facilitator serves mainnet) pnpm test && pnpm typecheck

The batch payout console (web/ — React + TanStack Start, installed with bun).

pnpm install:web && pnpm build:web # → web/dist/client, served by the SAME process at /pay pnpm dev:web # or: vite with HMR on http://127.0.0.1:8080/pay/ , /v1 proxied to :3000 AGENT_MNEMONIC_FILE=~/.secrets/agent.mnemonic pnpm buy --phone +919876543210 --amount 100 # real USDC pnpm check-bazaar # listed after the first settled payment

Mock supplier rules for demos: a phone ending `0000` fails (→ refund path), `1111` is delivered after polling.

Agent integrations

.claude-plugin/plugin.json — Claude Code plugin: this skill + the hosted MCP server, zero setup for the user.
server.json — MCP registry manifest (remotes → https://iomarkets.app/mcp); needs the deploy live + a DNS TXT record proving the app.iomarkets namespace.
skills/iomarkets-topup/SKILL.md — the single shared skill for OpenClaw, Hermes and Claude Code (agentskills format); publishing to each hub is a copy, not a fork (skills/README.md).
pnpm mcp — MCP server (stdio) with lookup_phone, list_offers, quote, buy, order_status, verify_receipt, ledger, create_pay_link.
Bazaar: the paid route declares discovery metadata + the x402-global-challenge tag; it is indexed on first settlement.

Layout

src/app.ts          HTTP surface + x402 wiring (dynamic price = quote, preflight hook, post-settle order creation)

src/orders.ts quote → paid → fulfilling → delivered | failed → refunded (single-flight, resumable) src/suppliers/ types · mock · zendit · reloadly · composite (goods + payouts) · payout-partner (skeleton) src/compliance.ts payout gate (sanctions, caps, sender, KYC threshold) src/receipt.ts ed25519 receipts src/refunds.ts on-chain refunds (daily cap) src/db.ts node:sqlite src/keys.ts secret sources (file / systemd cred / env) src/growth.ts pay links · proof pages · referral routes src/referrals.ts margin share, reserve-first payouts src/mcp.ts MCP server src/client/paying.ts x402 paying fetch with budget scripts/ gen-key · new-wallet · optin-usdc · buy · verify-receipt · check-bazaar docs/RECEIPTS.md the signed-receipt format, as a spec other sellers can adopt deploy/entrypoint.sh container entrypoint: refuses to start on a config that cannot take money

IoMarkets Topup (demo)

개요

PopNx MCP의 세 기둥

할 수 있는 일

설치

설치하기 전에

할 수 있는 일

기본 점검i

제작자와 저장소 일치

계속 관리되고 있음

라이선스 있음

엔드포인트 응답

OAuth로 로그인

도구 설명에 숨겨진 지시 없음

여행, 지도 및 날씨 카테고리의 다른 서버와 비교i

자주 묻는 질문

대안

LetsFG — Flights & Hotels

Google Maps MCP Server

Mu

제작자의 README

IoMarkets Topup — real-world checkout for AI agents on Algorand

How it works

Trust model (what makes agents use it extensively)

Run it

The batch payout console (web/ — React + TanStack Start, installed with bun).

Agent integrations

Layout