Install Roamzy MCP in 3 minutes

Locate your client's config file

The MCP config file lives in a different place depending on your client:

Create the file if it doesn't exist — the parent directory may need creating too.

Paste the Roamzy block

Add this to mcpServers. If the file is empty, the whole object is what goes in:

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

copy{
  "mcpServers": {
    "roamzy": {
      "command": "npx",
      "args": ["-y", "@roamzy/mcp-server"],
      "env": {
        "ROAMZY_API_TOKEN": "rk_live_xxx",
        "ROAMZY_ENABLE_PURCHASE": "false"
      }
    }
  }
}

Restart the client completely

Quit fully (Cmd+Q on macOS, not just close the window). Reopen. The Roamzy tools (roamzy_status, roamzy_list_countries, roamzy_estimate, roamzy_create_order, roamzy_get_esim) appear in the tools menu.

Stuck? Logs are at ~/Library/Logs/Claude/mcp.log on macOS.

Ask your agent

Try natural language — no need to remember tool names:

You: How much does an eSIM cost in Japan for 1 GB through Roamzy?

You: Buy me an eSIM for Spain with $20 USDT.

You: I'm going to Italy and the UAE next month, what's the cheapest setup?

For a purchase, the agent returns three things:

Pay USDT and get your eSIM

Open pay_url in any browser, pay the USDT amount. Confirmation typically takes 5-15 minutes (depends on network).

Once settled, the agent calls roamzy_get_esim and renders a QR code in the chat. Scan it with your phone camera — the eSIM activates automatically (iOS 17.4+ / Android 14+) or opens the system eSIM install dialog (older OSes).

(Optional) Attach to a permanent account

If you'd like dashboard access, browser-based top-ups, and recovery if you lose your MCP token: open the claim_url from step 4. Sign in with Google or Telegram, then enter the eSIM number (MSISDN from step 4) as a 2-factor verification.