MCP SERVER
https://agentroam.ai/api/mcpSUMMARY
AgentRoam is an MCP server that enables purchasing travel eSIMs, gift cards, and mobile top-ups using cryptocurrency. It provides tools for searching products, getting live prices, validating orders, and creating orders. The server emphasizes user confirmation before any purchase, with a dry-run validation step that returns a confirmation token required for order creation. It supports multiple cryptocurrencies and networks, and offers both a widget-based flow and a text-only fallback wizard.
CAPABILITIES
Evidence-backed capability profile
TOOLS IN THIS MCP SERVER
create_orderCreate OrderCreate the real order (requires confirm_token from validate_order, after user approval). Returns the payment wallet address, exact crypto amount, 30-minute expiry, and an order-status URL. The purchased code/QR is emailed by Cryptorefills to the buyer — it is never returned here.
get_currenciesGet CurrenciesList all supported payment cryptocurrencies (the response carries the current set).
get_order_statusGet Order StatusPoll order state (WAITING_FOR_PAYMENT → PARTIAL → COMPLETED, or CANCELED/EXPIRED). Requires the status_token from create_order.
get_payment_methodsGet Payment MethodsFull payment matrix: every supported coin × network combination currently available, with the exact network strings orders require. The response includes live totals — report those, never a memorized count.
get_priceGet PriceLive crypto price for one product/denomination. Payment coins include USDT, USDC, BTC (incl. Lightning), ETH, SOL, DAI, PYUSD, LTC, TRX, TON, DOGE and SUI across many networks — call get_payment_methods for the current list. Never creates an order.
list_brandsList BrandsBrowse all available brands/carriers for a country: gift cards (500+ US brands) and mobile top-up carriers (100+ countries). Never creates an order.
list_esim_plansList eSIM PlansPREFERRED for any eSIM request: live eSIM data plans for a destination (110+ countries, plus "eu" Europe and "ww" Global multi-country plans) with USD prices and crypto amounts. Renders an interactive plan-picker widget where the user can complete the purchase directly. Never creates an order by itself.
list_productsList ProductsList a brand's live products/denominations with prices in the chosen coin — exact labels to use with get_price/validate_order (for eSIM use list_esim_plans instead). Never creates an order.
purchase_wizardPurchase WizardText-only fallback purchase flow for clients WITHOUT widget support. In ChatGPT prefer list_esim_plans / list_products + validate_order + create_order instead. Stateful: call repeatedly with the same session_token, answering one question at a time, until status is "complete". First call: empty arguments. The final "confirm" answer creates a REAL order — get explicit user approval first.
search_productsSearch ProductsSearch the AgentRoam travel-crypto catalog: gift cards (Airbnb, Uber, airlines, 500+ US brands), eSIM data plans (110+ destinations incl. Europe/Global region plans) and mobile top-ups (carriers in 100+ countries). Returns product handles for get_price/validate_order. Never creates an order.
validate_orderValidate OrderDry-run an order and mint a one-time confirm_token (valid 10 minutes). Returns a human-readable summary that MUST be shown to the user for approval before calling create_order. Does NOT create the order or reserve funds.
MACHINE-READABLE ENDPOINTS
ACCESS
USAGE OBSERVATIONS