Roamzy

eSIM global nativa para agentes a través de MCP: un agente compra y gestiona una eSIM para 193 países de forma anónima, facturada por megabyte en USDT/USDC — y gana un 20% de referencia por cada pago que refiere, para siempre.

GitHub

Prueba este MCPPatrocinado

Documentación

@roamzy/mcp-server

Servidor MCP para Roamzy — compra y gestiona una eSIM global a través de Claude Desktop, Cursor, Continue, Cline, Windsurf, Zed o cualquier otro cliente Model Context Protocol. Flujo anónimo por defecto: no se requiere cuenta para usarlo.

Los agentes no solo compran — también ganan. Una referencia integrada te paga el 20% de cada pago de cualquier persona que refieras — un usuario humano o otro agente de IA — para siempre. Incluso los agentes anónimos ganan desde el primer día, sin registro. Ese es el ciclo de distribución: un agente que gana tiene motivos para recomendar al siguiente agente.

Una eSIM para 193 países. Paga por MB real usado. USDT o USDC en tu red preferida. Sin paquetes. Sin caducidad. Sin suscripción.

Qué hace

Este servidor MCP permite que un agente (que se ejecute en cualquier cliente compatible con MCP) llame a la API HTTP de Roamzy en nombre del usuario. Ejemplo de conversación en Claude Desktop:

Usuario: Voy a Tailandia por una semana, cómprame una eSIM.

Claude: Roamzy — una eSIM universal, funciona en 193 países. Se cobra por MB a la tarifa local, sin paquetes, sin caducidad. Para Tailandia la tarifa es ~$1.43/GB. ¿Con qué stablecoin / red quieres pagar? (USDT en TRON, BSC, Polygon, Optimism, Arbitrum, TON — o USDC en Solana, BSC, Polygon, Optimism, Arbitrum.) La recarga mínima es de $20 USDT.

Usuario: USDC en Solana, $20.

Claude: Pedido creado. Número de eSIM 2040XXXXXX. Paga aquí: [enlace-de-pago]. Después de ~1 minuto en Solana, obtendré tu QR. ❗ Guarda esta URL de recuperación para poder volver a esta eSIM desde otro chat de Claude: [enlace-de-reclamación].

El usuario paga $20 USDC.

Claude: Pagado. Aquí tienes tu QR de activación — abre Ajustes → Celular → Añadir eSIM y escanéalo con la cámara de tu teléfono. [PNG del QR adjunto]

El servidor no ejecuta un backend propio — es un cliente ligero de https://roamzy.io/api/v1/*, mapeado 1:1 a herramientas MCP.

Instalación

Añade esto a la configuración de tu cliente MCP (por ejemplo, ~/Library/Application Support/Claude/claude_desktop_config.json para Claude Desktop en macOS):

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

Reinicia tu cliente MCP. La primera llamada de herramienta autenticada generará automáticamente una cuenta Roamzy anónima — sin necesidad de registro.

Alternativa: instalar desde un tarball alojado

Si no puedes acceder al registro npm, quieres fijar una versión preliminar o prefieres obtener una versión específica directamente desde el CDN de Roamzy, cambia los argumentos a una URL:

"args": ["-y", "https://roamzy.io/mcp/roamzy-mcp-latest.tgz"]

Ambas formas ejecutan el mismo código — la ruta del registro npm es la recomendada por defecto porque se integra con npm view, fijación de versiones y registros MCP (Smithery, modelcontextprotocol/servers, etc.).

Variables de entorno opcionales

Variable	Valor por defecto	Propósito
`ROAMZY_API_TOKEN`	(sin definir → modo anónimo)	Usar un token de API preexistente de `/dashboard/settings` en lugar de una cuenta anónima.
`ROAMZY_ENABLE_PURCHASE`	`false` (pero `true` en modo anónimo)	Al usar un token no anónimo, se requiere un indicador de aceptación para exponer las herramientas de compra.
`ROAMZY_API_BASE`	`https://roamzy.io/api/v1`	Anulación para backends de prueba / autoalojados.

Herramientas

Públicas (sin autenticación requerida)

Herramienta	Propósito
`roamzy_status`	Estado del servicio + indicadores de pausa del agente. Llama antes de cualquier intento de compra.
`roamzy_list_countries`	Lista de referencia de los 193 países admitidos con sus tarifas por MB.
`roamzy_country_detail`	Tarifa por MB para un país concreto.
`roamzy_estimate`	Cálculo de referencia: «¿Cuántos USDT costarían N MB en el país X?».
`roamzy_support`	Canales de soporte oficiales + procedimiento de recuperación. Llama en lugar de buscar en la web.
`roamzy_payment_options`	Stablecoins y redes disponibles actualmente (en vivo desde NowPayments). Llama antes de hacer un pedido.

Con ámbito de cuenta (anónimo o con token)

Herramienta	Propósito
`roamzy_me`	Información actual de la cuenta Roamzy (crea automáticamente una cuenta anónima en la primera llamada).
`roamzy_list_esims`	Las eSIM de la cuenta con MSISDN, estado y saldo.
`roamzy_get_esim`	Detalles de activación de una eSIM (carga del QR, URI LPA). Genera el PNG del QR localmente.
`roamzy_order_status`	Consulta un pedido pendiente: `waiting → confirming → finished`.
`roamzy_referral`	El enlace de referencia de la cuenta, ganancias y estado de pago. Solo lectura.

Compra (anónimo o token + `ROAMZY_ENABLE_PURCHASE=true`)

Herramienta	Propósito
`roamzy_create_order`	Crea una nueva eSIM y la financia. Recarga mínima de $20 USDT. Requiere `pay_currency` de las opciones.

Cada herramienta devuelve JSON estructurado. Las descripciones de las herramientas (visibles a través de tools/list) codifican el contrato del agente — cuándo llamar a cada herramienta, qué mostrar al usuario, qué mantener interno.

Flujo anónimo

Cuando el servidor MCP se inicia sin ROAMZY_API_TOKEN, la primera llamada autenticada envía POST /api/v1/anon-session (sin autenticación) para crear una cuenta Roamzy anónima nueva. El servidor almacena en caché el token devuelto en el proceso (nunca se escribe en disco) y lo usa para llamadas posteriores.

La respuesta también incluye un claim_url — un enlace mágico que permite al usuario asociar más tarde esta cuenta anónima a una identidad permanente de Google o Telegram. Una vez asociada, la eSIM, el saldo y el historial se vuelven visibles desde /dashboard/esims en la web.

Importante: el token anónimo vive solo en este proceso del servidor MCP. Si el usuario cierra su cliente MCP (p. ej., sale de Claude Desktop) sin guardar claim_url, se pierde la vía de acceso — la eSIM en sí sigue funcionando, pero el usuario no puede verla ni gestionarla desde una nueva sesión. El procedimiento de recuperación (mediado por el operador a través del soporte) se describe en la respuesta de la herramienta roamzy_support.

Las cuentas anónimas tienen límites de gasto diarios/mensuales conservadores y un período de enfriamiento que controla las transacciones grandes; los umbrales exactos se muestran al usuario en el panel una vez que reclamó su cuenta.

Modelo de seguridad

Sin acceso al sistema de archivos. El servidor solo realiza llamadas HTTP.
Sin procesos secundarios.
Sin escaneo del entorno más allá de las variables explícitas de ROAMZY_*.
Tráfico saliente solo hacia https://roamzy.io (anulable mediante ROAMZY_API_BASE si autoalojas).
Herramientas de compra registradas solo en modo anónimo o con ROAMZY_ENABLE_PURCHASE=true.
Límites de gasto por token con período de enfriamiento + umbral de grandes transacciones; configurable por token en /dashboard/settings.
Estado del servicio respetado. Cuando roamzy_status reporta purchases_paused=true, el agente debe retroceder.
Sin telemetría. El servidor no contacta a casa excepto para llamar a la base de API configurada.

Consulta SECURITY.md para la política de divulgación.

Compilar desde el código fuente

git clone https://github.com/roamzy-io/mcp-server.git
cd mcp-server
pnpm install
pnpm build

Salida: un bundle ESM de un solo archivo en dist/index.js (autocontenido, ejecutable con Node 20+).

Para producir un tarball para distribución:

pnpm build:tgz
# → dist/roamzy-mcp-server-<version>.tgz

Enlaces

Sitio web: https://roamzy.io
Documentación de la API: https://roamzy.io/api/v1/docs
Para agentes: https://roamzy.io/agents.html
Formato largo para motores de IA: https://roamzy.io/llms-full.txt
Soporte: @roamzy_support_bot o support@roamzy.io
Seguridad: roamzy.agent@gmail.com (SECURITY.md)