MCP SERVER

Roamzy MCP server

Give any MCP-compatible AI client the ability to buy and manage a global eSIM. Anonymous-first, per-MB pricing in USDT/USDC, 12 tools, 193 countries — over a remote endpoint or the npm package.

Install

Remote (zero install) — add to your MCP client config:

{
  "mcpServers": {
    "roamzy": {
      "type": "streamable-http",
      "url": "https://roamzy.io/mcp"
    }
  }
}

npm (stdio) — run the package directly:

npx -y @roamzy/mcp-server

The remote endpoint is anonymous-first — it never requires a token. Set ROAMZY_API_TOKEN only if you want to bind activity to an existing account.

The 12 tools

Tool	What it does
`roamzy_status`	Read — API status + agent pause flag. Call before a purchase and back off if purchases are paused.
`roamzy_list_countries`	Read — the 193-country per-MB rate card in USDT.
`roamzy_country_detail`	Read — the per-MB rate for one country.
`roamzy_estimate`	Read — what a given MB volume would cost at a given rate.
`roamzy_payment_options`	Read — the stablecoin / network options enabled for checkout.
`roamzy_me`	Read — current account info (anonymous accounts are auto-minted).
`roamzy_referral`	Read — your referral link + earnings. Agents earn 20% referral, forever.
`roamzy_list_esims`	Read — the account's eSIMs with status, balance, MSISDN.
`roamzy_get_esim`	Read — one eSIM by id, including the activation QR payload.
`roamzy_order_status`	Read — poll a pending order until it is finished.
`roamzy_support`	Read — the official Roamzy support / recovery channel.
`roamzy_create_order`	Financial — mint a Roamzy eSIM and fund it with USDT or USDC. Anonymous mode returns a recovery link to save.

What the agent can do

Check rates for 193 countries, estimate a cost, list payment options, mint and fund an eSIM in USDT/USDC, poll the order, and return the activation QR — plus read referral earnings, because an agent that uses Roamzy also earns from it.

Clients

Claude Desktop
Cursor
Continue
Cline
Windsurf
Zed

Registry & package

Official MCP Registry: io.github.roamzy-io/mcp-server
npm: @roamzy/mcp-server
Source: github.com/roamzy-io/mcp-server (MIT)

FAQ

Does the remote MCP endpoint require a token?

No. https://roamzy.io/mcp is anonymous-first and never returns 401. A token is optional and only binds activity to an existing account.

How many tools does it expose?

Twelve, covering status, rates, estimates, payment options, account, referral, eSIM lifecycle and ordering.

Which transport does it use?

Streamable HTTP for the remote endpoint, or stdio for the npm package.

Is it open source?

Yes — MIT-licensed at github.com/roamzy-io/mcp-server.

Add the server

Zero-install remote endpoint:

{
  "mcpServers": {
    "roamzy": {
      "type": "streamable-http",
      "url": "https://roamzy.io/mcp"
    }
  }
}

See all 193 country rates →

Compare the best eSIMs for AI agents →