AgentRoam

Official11 tools

by agentroam

Buy travel eSIMs, gift cards and mobile top-ups with crypto — user confirms before any order.

MCP Server: ai.agentroam/agentroam

The MCP server ai.agentroam/agentroam supports buying travel eSIMs, gift cards, and mobile top-ups using crypto. Per its description, the system requires user confirmation before any order is placed. It exposes 11 tools via the MCP interface.

🛠️ Key Features

Purchases for travel eSIMs, gift cards, and mobile top-ups
Crypto-based ordering
Requires user confirmation before any order

🚀 Use Cases

Buying travel eSIMs with crypto
Sending or purchasing gift cards using crypto
Topping up mobile balances with crypto

⚡ Developer Benefits

Predictable “confirm before order” flow for integrations
11 available tools exposed through MCP for implementing commerce actions

Captured live from the server via tools/list.

search_products

Search 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.

Parameters3

query	string	required	Brand, carrier or destination to search for
country	string	optional	ISO country code filter (e.g. "us", "mx")
kind	string	optional	Product type filter

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Brand, carrier or destination to search for"
    },
    "country": {
      "type": "string",
      "description": "ISO country code filter (e.g. \"us\", \"mx\")"
    },
    "kind": {
      "type": "string",
      "description": "Product type filter"
    }
  },
  "required": [
    "query"
  ]
}

get_price

Live 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.

Parameters7

brand_slug	string	required	brandSlug from search_products
country_code	string	required	countryCode from search_products
denomination_label	string	required	Exact denomination label (e.g. "100 USD", "60 UC", "1 GB 7 days")
amount_usd	number	required	USD amount (for dynamic-range products)
dynamic	boolean	required	true for dynamic-range amounts, false for fixed denomination labels
coin	string	required	Payment coin, e.g. USDC, USDT, BTC, SOL
network	string	required	Exact network string from get_price/networks, e.g. "Solana", "Tron", "ETH Mainnet"

Raw schema

{
  "type": "object",
  "properties": {
    "brand_slug": {
      "type": "string",
      "description": "brandSlug from search_products"
    },
    "country_code": {
      "type": "string",
      "description": "countryCode from search_products"
    },
    "denomination_label": {
      "type": "string",
      "description": "Exact denomination label (e.g. \"100 USD\", \"60 UC\", \"1 GB 7 days\")"
    },
    "amount_usd": {
      "type": "number",
      "description": "USD amount (for dynamic-range products)"
    },
    "dynamic": {
      "type": "boolean",
      "description": "true for dynamic-range amounts, false for fixed denomination labels"
    },
    "coin": {
      "type": "string",
      "description": "Payment coin, e.g. USDC, USDT, BTC, SOL"
    },
    "network": {
      "type": "string",
      "description": "Exact network string from get_price/networks, e.g. \"Solana\", \"Tron\", \"ETH Mainnet\""
    }
  },
  "required": [
    "brand_slug",
    "country_code",
    "denomination_label",
    "amount_usd",
    "dynamic",
    "coin",
    "network"
  ]
}

validate_order

Dry-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.

Parameters9

brand_slug	string	required	brandSlug from search_products
country_code	string	required	countryCode from search_products
denomination_label	string	required	Exact denomination label (e.g. "100 USD", "60 UC", "1 GB 7 days")
amount_usd	number	required	USD amount (for dynamic-range products)
dynamic	boolean	required	true for dynamic-range amounts, false for fixed denomination labels
coin	string	required	Payment coin, e.g. USDC, USDT, BTC, SOL
network	string	required	Exact network string from get_price/networks, e.g. "Solana", "Tron", "ETH Mainnet"
email	string	required	Delivery email for the buyer
phone	string	optional	Phone number to recharge (REQUIRED for mobile top-ups, with country code)

Raw schema

{
  "type": "object",
  "properties": {
    "brand_slug": {
      "type": "string",
      "description": "brandSlug from search_products"
    },
    "country_code": {
      "type": "string",
      "description": "countryCode from search_products"
    },
    "denomination_label": {
      "type": "string",
      "description": "Exact denomination label (e.g. \"100 USD\", \"60 UC\", \"1 GB 7 days\")"
    },
    "amount_usd": {
      "type": "number",
      "description": "USD amount (for dynamic-range products)"
    },
    "dynamic": {
      "type": "boolean",
      "description": "true for dynamic-range amounts, false for fixed denomination labels"
    },
    "coin": {
      "type": "string",
      "description": "Payment coin, e.g. USDC, USDT, BTC, SOL"
    },
    "network": {
      "type": "string",
      "description": "Exact network string from get_price/networks, e.g. \"Solana\", \"Tron\", \"ETH Mainnet\""
    },
    "email": {
      "type": "string",
      "description": "Delivery email for the buyer"
    },
    "phone": {
      "type": "string",
      "description": "Phone number to recharge (REQUIRED for mobile top-ups, with country code)"
    }
  },
  "required": [
    "brand_slug",
    "country_code",
    "denomination_label",
    "amount_usd",
    "dynamic",
    "coin",
    "network",
    "email"
  ]
}

create_order

Create 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.

Parameters2

confirm_token	string	required	One-time token returned by validate_order (valid 10 minutes)
full_name	string	optional	Buyer full legal name — only if a previous attempt returned FULLNAME_MISSING

Raw schema

{
  "type": "object",
  "properties": {
    "confirm_token": {
      "type": "string",
      "description": "One-time token returned by validate_order (valid 10 minutes)"
    },
    "full_name": {
      "type": "string",
      "description": "Buyer full legal name — only if a previous attempt returned FULLNAME_MISSING"
    }
  },
  "required": [
    "confirm_token"
  ]
}

list_esim_plans

PREFERRED 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.

Parameters2

destination	string	required	Destination: 2-letter country code (e.g. "il", "jp", "fr"), or "eu" (Europe region plan) / "ww" (Global plan)
coin	string	optional	Coin for live pricing (default USDC)

Raw schema

{
  "type": "object",
  "properties": {
    "destination": {
      "type": "string",
      "description": "Destination: 2-letter country code (e.g. \"il\", \"jp\", \"fr\"), or \"eu\" (Europe region plan) / \"ww\" (Global plan)"
    },
    "coin": {
      "type": "string",
      "description": "Coin for live pricing (default USDC)"
    }
  },
  "required": [
    "destination"
  ]
}

get_order_status

Poll order state (WAITING_FOR_PAYMENT → PARTIAL → COMPLETED, or CANCELED/EXPIRED). Requires the status_token from create_order.

Parameters2

external_order_id	string	required
status_token	string	required	statusToken returned by create_order

Raw schema

{
  "type": "object",
  "properties": {
    "external_order_id": {
      "type": "string"
    },
    "status_token": {
      "type": "string",
      "description": "statusToken returned by create_order"
    }
  },
  "required": [
    "external_order_id",
    "status_token"
  ]
}

list_brands

Browse all available brands/carriers for a country: gift cards (500+ US brands) and mobile top-up carriers (100+ countries). Never creates an order.

Parameters2

country_code	string	required	ISO country code, e.g. "us", "mx"
kind	string	optional	Filter by product type

Raw schema

{
  "type": "object",
  "properties": {
    "country_code": {
      "type": "string",
      "description": "ISO country code, e.g. \"us\", \"mx\""
    },
    "kind": {
      "type": "string",
      "description": "Filter by product type"
    }
  },
  "required": [
    "country_code"
  ]
}

list_products

List 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.

Parameters3

brand_slug	string	required	brandSlug from list_brands/search_products
country_code	string	required
coin	string	optional	Coin for live pricing (default USDC)

Raw schema

{
  "type": "object",
  "properties": {
    "brand_slug": {
      "type": "string",
      "description": "brandSlug from list_brands/search_products"
    },
    "country_code": {
      "type": "string"
    },
    "coin": {
      "type": "string",
      "description": "Coin for live pricing (default USDC)"
    }
  },
  "required": [
    "brand_slug",
    "country_code"
  ]
}

get_currencies

List all supported payment cryptocurrencies (the response carries the current set).

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "required": []
}

get_payment_methods

Full 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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "required": []
}

purchase_wizard

Text-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.

Parameters3

session_token	string	optional	Omit on the first call — a new session is minted
answer	string	optional	Answer to the current question
action	string	optional	"back" to return to the previous step

Raw schema

{
  "type": "object",
  "properties": {
    "session_token": {
      "type": "string",
      "description": "Omit on the first call — a new session is minted"
    },
    "answer": {
      "type": "string",
      "description": "Answer to the current question"
    },
    "action": {
      "type": "string",
      "description": "\"back\" to return to the previous step"
    }
  },
  "required": []
}

Install

Tools (11)

search_productsget_pricevalidate_ordercreate_orderlist_esim_plansget_order_statuslist_brandslist_products

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://agentroam.ai/api/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "agentroam": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://agentroam.ai/api/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

MCP Server: ai.agentroam/agentroam

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

search_products

get_price

validate_order

create_order

list_esim_plans

get_order_status

list_brands

list_products

get_currencies

get_payment_methods

purchase_wizard

Install

Remote endpoint

Related servers