Roamzy
eSIM global nativo para agentes via MCP: um agente compra e gerencia um eSIM para 193 países anonimamente, cobrado por megabyte em USDT/USDC — e ganha 20% de comissão de indicação em cada pagamento que indicar, para sempre.
Documentação
@roamzy/mcp-server
Servidor MCP para Roamzy — compre e gerencie um eSIM global pelo Claude Desktop, Cursor, Continue, Cline, Windsurf, Zed ou qualquer outro cliente Model Context Protocol. Fluxo anônimo por padrão: nenhuma conta necessária para usar.
Agentes não só compram — eles ganham. Um programa de indicação integrado paga 20% de cada pagamento feito por qualquer pessoa que você indicar — um usuário humano ou outro agente de IA — para sempre. Até agentes anônimos ganham desde o primeiro dia, sem cadastro. Essa é a roda distributiva: um agente que ganha tem um motivo para indicar o próximo agente.
Um único eSIM para 193 países. Pague por MB efetivamente usado. USDT ou USDC na sua rede preferida. Sem pacotes. Sem expiração. Sem assinatura.
O que ele faz
Este servidor MCP permite que um agente (rodando em qualquer cliente compatível com MCP) chame a API HTTP da Roamzy em nome do usuário. Exemplo de conversa no Claude Desktop:
Usuário: Vou para a Tailândia por uma semana, compre um eSIM para mim.
Claude: Roamzy — um eSIM universal, funciona em 193 países. Cobrança por MB na tarifa local, sem pacotes, sem expiração. Para a Tailândia, a tarifa é de ~$1,43/GB. Qual stablecoin / rede você quer usar para pagar? (USDT na TRON, BSC, Polygon, Optimism, Arbitrum, TON — ou USDC na Solana, BSC, Polygon, Optimism, Arbitrum.) Recarga mínima de $20 USDT.
Usuário: USDC na Solana, $20.
Claude: Pedido criado. Número do eSIM 2040XXXXXX. Pague aqui: [pay-link]. Após ~1 minuto na Solana, vou buscar seu QR. ❗ Salve esta URL de recuperação para poder retornar a este eSIM a partir de outro chat do Claude: [claim-link].
O usuário paga $20 USDC.
Claude: Pago. Aqui está seu QR de ativação — abra Ajustes → Cellular → Adicionar eSIM e escaneie com a câmera do seu celular. [QR PNG anexado]
O servidor não executa um backend próprio — é um cliente fino para https://roamzy.io/api/v1/*, mapeado 1:1 para as ferramentas MCP.
Instalação
Adicione isto à configuração do seu cliente MCP (ex.: ~/Library/Application Support/Claude/claude_desktop_config.json para Claude Desktop no macOS):
{
"mcpServers": {
"roamzy": {
"command": "npx",
"args": ["-y", "@roamzy/mcp-server"]
}
}
}
Reinicie seu cliente MCP. A primeira chamada autenticada criará automaticamente uma conta Roamzy anônima — sem necessidade de cadastro.
Alternativa: instalar a partir de um tarball hospedado
Se você não conseguir acessar o registro npm, quiser fixar um pré-lançamento ou preferir buscar uma versão específica diretamente do CDN da Roamzy, troque os argumentos por uma URL:
"args": ["-y", "https://roamzy.io/mcp/roamzy-mcp-latest.tgz"]
Ambas as formas executam o mesmo código — o caminho pelo registro npm é o padrão recomendado porque integra-se ao npm view, fixação de versão e registros MCP (Smithery, modelcontextprotocol/servers, etc.).
Variáveis de ambiente opcionais
| Variável | Padrão | Finalidade |
|---|---|---|
ROAMZY_API_TOKEN | (não definido → modo anônimo) | Usar um token de API pré-existente do /dashboard/settings em vez de uma conta anônima. |
ROAMZY_ENABLE_PURCHASE | false (mas true no modo anônimo) | Ao usar um token não anônimo, flag de opt-in necessária para expor as ferramentas de compra. |
ROAMZY_API_BASE | https://roamzy.io/api/v1 | Substituição para backends de staging / self-hosted. |
Ferramentas
Públicas (sem autenticação)
| Ferramenta | Finalidade |
|---|---|
roamzy_status | Status do serviço + flags de pausa de agentes. Chame antes de qualquer tentativa de compra. |
roamzy_list_countries | Lista de referência de todos os 193 países suportados com tarifas por MB. |
roamzy_country_detail | Tarifa por MB para um país. |
roamzy_estimate | Cálculo de referência: «quantos USDT custariam N MB no país X». |
roamzy_support | Canais oficiais de suporte + procedimento de recuperação. Chame em vez de buscar na web. |
roamzy_payment_options | Stablecoins + redes atualmente habilitadas (ao vivo da NowPayments). Chame antes do pedido. |
Escopo da conta (anônimo ou token)
| Ferramenta | Finalidade |
|---|---|
roamzy_me | Informações atuais da conta Roamzy (cria conta anônima automaticamente na primeira chamada). |
roamzy_list_esims | Os eSIMs da conta com MSISDN, status e saldo. |
roamzy_get_esim | Detalhes de ativação de um eSIM (payload do QR, URI LPA). Gere o PNG do QR localmente. |
roamzy_order_status | Consulte um pedido pendente: waiting → confirming → finished. |
roamzy_referral | Link de indicação da conta, ganhos e estado de pagamento. Somente leitura. |
Compra (anônimo ou token + ROAMZY_ENABLE_PURCHASE=true)
| Ferramenta | Finalidade |
|---|---|
roamzy_create_order | Crie um novo eSIM e faça sua recarga. Recarga mínima de $20 USDT. Requer pay_currency das opções. |
Cada ferramenta retorna JSON estruturado. As descrições das ferramentas (visíveis por meio de tools/list) codificam o contrato do agente — quando chamar cada ferramenta, o que apresentar ao usuário e o que manter interno.
Fluxo anônimo
Quando o servidor MCP inicia sem ROAMZY_API_TOKEN, a primeira chamada autenticada envia POST /api/v1/anon-session (sem autenticação) para criar uma nova conta Roamzy anônima. O servidor armazena em cache o token retornado no processo (nunca gravado em disco) e o usa para chamadas subsequentes.
A resposta também inclui um claim_url — um magic-link que permite ao usuário vincular posteriormente esta conta anônima a uma identidade permanente do Google ou Telegram. Uma vez vinculada, o eSIM, o saldo e o histórico ficam visíveis em /dashboard/esims na web.
Importante: o token anônimo vive apenas neste processo do servidor MCP. Se o usuário fechar seu cliente MCP (ex.: sair do Claude Desktop) sem salvar claim_url, o caminho de acesso será perdido — o eSIM em si continua funcionando, mas o usuário não poderá vê-lo ou gerenciá-lo a partir de uma nova sessão. O procedimento de recuperação (mediado pelo operador via suporte) está descrito na resposta da ferramenta roamzy_support.
Contas anônimas têm limites conservadores de gastos diários / mensais e um período de espera que controla transações grandes; os limites exatos são mostrados ao usuário no painel depois que ele reivindica a conta.
Modelo de segurança
- Sem acesso ao sistema de arquivos. O servidor faz apenas chamadas HTTP.
- Sem processos filhos.
- Sem varredura de ambiente além das variáveis explícitas de
ROAMZY_*. - Tráfego de saída apenas para
https://roamzy.io(substituível viaROAMZY_API_BASEse você fizer self-host). - Ferramentas de compra são registradas apenas no modo anônimo ou com
ROAMZY_ENABLE_PURCHASE=true. - Limites de gastos por token com período de espera + limite para transações grandes; configuráveis por token em
/dashboard/settings. - Status do serviço respeitado. Quando
roamzy_statusreportarpurchases_paused=true, o agente deve recuar. - Sem telemetria. O servidor não faz chamadas externas exceto para a base da API configurada.
Consulte SECURITY.md para a política de divulgação.
Compilar a partir do código-fonte
git clone https://github.com/roamzy-io/mcp-server.git
cd mcp-server
pnpm install
pnpm build
Saída: um bundle ESM de arquivo único em dist/index.js (autocontido, executável via Node 20+).
Para gerar um tarball para distribuição:
pnpm build:tgz
# → dist/roamzy-mcp-server-<version>.tgz
Links
- Site: https://roamzy.io
- Documentação da API: https://roamzy.io/api/v1/docs
- Para agentes: https://roamzy.io/agents.html
- Formato longo para mecanismos de IA: https://roamzy.io/llms-full.txt
- Suporte: @roamzy_support_bot ou
support@roamzy.io - Segurança:
roamzy.agent@gmail.com(SECURITY.md)
Licença
MIT — © 2026 Artur. O nome e a marca Roamzy são marcas registradas do operador do serviço Roamzy e não estão licenciados sob a MIT.