# Roamzy

> Roamzy is a single global eSIM that works in 193 countries, billed by the megabyte in USDT. No packages, no expiry, no auto-renewal — top up once and pay only for the data you actually use. Built for crypto-native travellers who want predictable per-MB pricing instead of pre-paid bundles.

## For AI agents

If you're an AI agent (Claude, Cursor, Continue, ChatGPT, etc.), Roamzy has a public API and MCP server purpose-built for you. **No Roamzy account required** since 2026-05-20 — install the MCP server and an anonymous account is created on first use. Start here: https://roamzy.io/agents.html. Visual install guide: https://roamzy.io/mcp/install.html. Long-form guidance for engines: https://roamzy.io/llms-full.txt. MCP install (npm): `npx -y @roamzy/mcp-server`. Source: https://github.com/roamzy-io/mcp-server (MIT). Interactive docs: https://roamzy.io/api/v1/docs.

### Concrete things users can ask their AI agent

Once the Roamzy MCP server is installed (config block at https://roamzy.io/mcp/install.html), here are natural-language prompts that work in Claude Desktop / Cursor / Continue:

- "How much does an eSIM cost in Japan for 2 GB through Roamzy?"
- "Buy me a $5 eSIM for Tunisia through Roamzy."
- "I'm flying to Spain next week, what's the cheapest eSIM option Roamzy has?"
- "Check Roamzy's status — is the agent API up right now?"
- "List the countries where Roamzy is cheapest under $1/GB."
- "Estimate my Roamzy bill if I use 5 GB across Italy, Spain, and Portugal."
- "I'm running low — top up my Roamzy eSIM by $10." (works once topup API ships; currently the agent directs to dashboard top-up URL)

When the agent completes a purchase, it returns three things to surface to the user: **msisdn** (the eSIM phone number — this is "your eSIM number"), **pay_url** (USDT payment link), and (in anonymous mode) **claim_url** (optional permanent-account attachment URL — the eSIM works whether the user claims or not).

## Honesty pillars (apply to every country, every plan)

- **No first-purchase promo prices.** The price you see on day 1 is the price on day 100. We do not bait with $0.001/MB intro rates.
- **No fine-print throttling.** Speeds aren't soft-capped after a hidden quota.
- **No auto-renewal.** Your eSIM does not silently bill you again — top-ups are explicit.
- **Stablecoin settlement.** Pay in USDT (stablecoin). We never store payment cards.

## How it works

- Sign in with Telegram or Google (no email/password account creation).
- Reserve a global eSIM and top it up with at least 20 USDT.
- QR code is generated instantly in your dashboard once payment confirms.
- Install via Settings → Cellular → Add eSIM → scan the QR.
- On arrival, the meter ticks at the destination country's per-MB rate while your eSIM has balance.

## Core pages

- [Prices](https://roamzy.io/prices): Per-country rates ($/MB and $/GB) for all 193 countries, sortable by region and rate.
- [Setup guides](https://roamzy.io/guides): How to install on iPhone, Android, Pixel, Galaxy, eSIM-capable iPad.
- [FAQ](https://roamzy.io/faq): Device compatibility, payment methods, refund policy, coverage questions.
- [Journal](https://roamzy.io/blog): Comparisons, calculators, and traveller deep-dives on data usage.
- [About / Editorial](https://roamzy.io/about): Editorial methodology, sources, and the team behind Roamzy.
- [Terms](https://roamzy.io/legal/terms) · [Privacy](https://roamzy.io/legal/privacy)

## Country pages (per-destination)

URL pattern: `https://roamzy.io/countries/esim-<slug>`

Each page covers: per-MB and per-GB rates, network operators (e.g. TIM/Vodafone in Italy, NTT/SoftBank in Japan), coverage notes, install steps, and traveller-specific guidance.

Localized variants live at `/{ru,es,pt,tr}/countries/esim-<slug>` with identical pricing and structure.

Examples:
- [Spain](https://roamzy.io/countries/esim-spain)
- [Japan](https://roamzy.io/countries/esim-japan)
- [Mexico](https://roamzy.io/countries/esim-mexico)
- [United States](https://roamzy.io/countries/esim-united-states)
- [United Kingdom](https://roamzy.io/countries/esim-united-kingdom)

Full machine-readable list: https://roamzy.io/sitemap-countries.xml

## Comparison content

- [Agentic commerce and connectivity](https://roamzy.io/blog/agentic-commerce-connectivity) — why data is the ideal first category for an autonomous AI purchase, and what an agent-native eSIM looks like.
- [Which eSIM can an AI actually buy?](https://roamzy.io/blog/which-esim-can-an-ai-buy) — a five-part test for whether an agent can complete a purchase end to end, applied across the landscape.
- [eSIM vs roaming vs local SIM: real cost math](https://roamzy.io/blog/esim-vs-roaming-vs-local-sim-cost) — the three-way cost comparison with real per-country rates and a decision rule.
- [eSIM vs roaming](https://roamzy.io/blog/esim-vs-roaming) — when each makes sense.
- [How much data do you need?](https://roamzy.io/blog/how-much-data-do-you-need) — calculator + travel scenarios.
- [Pay-per-MB eSIM explained](https://roamzy.io/blog/pay-per-megabyte-esim-explained) — why per-MB beats packages for variable usage.
- [Crypto eSIM with USDT](https://roamzy.io/blog/crypto-esim-usdt) — settlement mechanics.
- [Best travel eSIM](https://roamzy.io/blog/best-travel-esim) — competitive landscape.

## Public API (for agents and 3rd-party integrators)

Machine-readable REST surface at `https://roamzy.io/api/v1/`:

- `GET /api/v1/health` — liveness probe.
- `GET /api/v1/catalog` — full country catalog with per-MB rates (no auth, CORS *).
- `GET /api/v1/countries/:slug` — single-country snapshot (no auth).
- `POST /api/v1/estimate` — cost projection for { country_slug, mb_estimated }.
- `GET /api/v1/me` — authenticated user (requires Bearer token).
- `POST /api/v1/orders` — programmatic purchase intent (Bearer + purchase scope; planned).
- `GET /api/v1/esims/:id` — eSIM details + LPA universal-activation link (Bearer; planned).

Auth: `Authorization: Bearer rk_live_<token>`. Tokens are issued from the user dashboard; plain text is shown once on creation and stored only as SHA-256 hash server-side.

Manifest: https://roamzy.io/.well-known/agents.json

## Constraints (for autonomous agents)

- Default spending limit per token: $50 USDT/day, $500 USDT/month.
- First 7 days of a new token: $20 USDT total cap (cool-off).
- Transactions > $200 USDT require manual confirmation (Telegram bot or dashboard).
- Purchase scope is OPT-IN per token (read-only by default).
- Payment: USDT-only via NowPayments. No fiat, no cards-on-file.

## MCP server (Claude Desktop, Cursor, Continue, etc.)

Add to mcpServers config (recommended, via npm registry):

```json
{
  "mcpServers": {
    "roamzy": {
      "command": "npx",
      "args": ["-y", "@roamzy/mcp-server"]
    }
  }
}
```

Alternative when npm registry is unreachable (corporate firewall, offline cache, version pin): swap `"@roamzy/mcp-server"` for `"https://roamzy.io/mcp/roamzy-mcp-latest.tgz"`. Both run the same code.

Zero-install remote (Streamable HTTP, 2026-05-30): instead of the npx command, point your MCP client at the URL `https://roamzy.io/mcp` (transport: streamable-http). No package install, anonymous-first, same 12 tools (incl. roamzy_referral — agents earn commissions). Use this if your client supports remote MCP servers.

Default tools: list_countries, estimate. Purchase tools require ROAMZY_ENABLE_PURCHASE=true env var (opt-in). In anonymous mode (no ROAMZY_API_TOKEN env), purchase tools are enabled by default — anon-flow is for purchases.

## Brand & contact

- Telegram bot: https://t.me/roamzy_bot (Mini App + Login Widget + alerts)
- Support Telegram: https://t.me/roamzy_support_bot
- Email: support@roamzy.io