Dale a tu agente de IA una eSIM global en cinco minutos

La mayoría de las demos de "la IA te compra algo" son humo. El agente rellena un formulario, o te pasa a una página de pago, o da por sentado en silencio que hay un humano a la espera para escanear un código. La conectividad es una de las pocas categorías donde el bucle entero se cierra de verdad dentro del chat — y este es el tutorial que te lleva hasta ahí.

Al final tendrás un agente capaz de responder "¿cuánto me costarían los datos en Japón?" y, cuando se lo pidas, acuñarte una eSIM real y entregarte un código QR y un enlace de pago — sin que jamás crees una cuenta de Roamzy. A continuación van dos rutas de configuración. Elige una; llegan al mismo sitio.

Treinta segundos de contexto antes de conectar nada

Ayuda saber a qué te estás conectando, porque no tiene la forma de los productos eSIM que quizás hayas usado:

• Un producto, no un catálogo. Una única eSIM universal que funciona en los 193 países. No hay paquetes por país que elegir ni nada para lo que escoger un tamaño o una duración.
• Por megabyte, sin caducidad. Cargas un saldo en stablecoins; los datos lo descuentan a la tarifa local por MB allá donde esté el dispositivo; el saldo sin usar se conserva para siempre. El modelo se cubre en profundidad en el pago por MB explicado.
• Anónimo por defecto. El agente no necesita una cuenta ni un token para empezar. La primera llamada autenticada acuña una cuenta de Roamzy anónima automáticamente. La identidad es opcional, después.
• Doce herramientas. Las herramientas de lectura (estado, catálogo, detalle de país, estimación de coste, tus eSIM y pedidos) están abiertas; la herramienta de compra es la única que mueve dinero, y está acotada por los topes de gasto que verás más abajo.

Si lo que buscas es el argumento más amplio de "por qué la conectividad es lo natural que primero compra un agente" en lugar del cableado, empieza por comercio agéntico y conectividad y vuelve aquí.

Ruta A — Endpoint remoto, sin instalación (unos 2 minutos)

Esta es la ruta más rápida y no necesita nada instalado. Funciona con Claude.ai y cualquier cliente que hable MCP remoto (Streamable HTTP).

1. Abre los ajustes de conectores de tu cliente. En Claude.ai eso es Ajustes → Conectores → Añadir conector personalizado.
2. Pega la URL del endpoint: https://roamzy.io/mcp
3. Guarda. Aparecen las doce herramientas de Roamzy. Estás conectado.

Esa es la instalación entera. No hay token que pegar ni paquete que descargar. El endpoint es anónimo primero por diseño — nunca devuelve un 401, así que un cliente se conecta sin un baile de OAuth y actúa contra una cuenta anónima nueva. (Existe una capa de identidad OAuth para los clientes que quieren un inicio de sesión nominal, pero no la necesitas para empezar.) Salta a la recompensa de cinco minutos de abajo.

Ruta B — Instalación local vía npm (unos 5 minutos)

Usa esto para clientes de escritorio y de editor: Claude Desktop, Cursor, Continue, Cline, Windsurf, Zed, o cualquier otra cosa que ejecute un servidor MCP local sobre stdio.

Añade un bloque al archivo de configuración MCP de tu cliente — para Claude Desktop en macOS eso es ~/Library/Application Support/Claude/claude_desktop_config.json:

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

No hace falta ningún bloque de entorno — dejar ROAMZY_API_TOKEN sin definir es lo que pone el servidor en modo anónimo. Si ya ejecutas otros servidores MCP, fusiona la clave roamzy en tu objeto mcpServers existente en lugar de sobrescribir el archivo. Luego reinicia por completo el cliente (en Claude Desktop, sal con Cmd-Q, no solo la ventana). La primera llamada autenticada a una herramienta acuña tu cuenta anónima.

Existen tres variables de entorno opcionales, ninguna requerida para el flujo anónimo:

• ROAMZY_API_TOKEN — ponla a un token de tu panel para actuar como una cuenta nominal en lugar de una anónima.
• ROAMZY_ENABLE_PURCHASE — su valor por defecto es false para un token nominal (solo lectura hasta que te decidas), pero está activada automáticamente en modo anónimo. Con un token nominal, la herramienta de compra permanece oculta hasta que la pongas a true — defensa en profundidad contra que una errata de configuración gaste dinero.
• ROAMZY_API_BASE — anula la base de la API para backends de staging o autoalojados.

La recompensa de cinco minutos: pídele que compre

Antes de la conversación de ejemplo, un modelo mental que despista a la gente. Como Roamzy es una única eSIM global facturada por megabyte, hay dos cosas que no deberías decirle al agente, y un agente que se porta bien no te las pedirá:

• Ni un país. La eSIM funciona en todas partes; no compras "una eSIM de Japón".
• Ni una cantidad de datos. No hay paquete que dimensionar. No estás comprando gigabytes; estás cargando un saldo.

Lo que el agente sí necesita de ti es un importe de recarga (mínimo 20 $ USDT) y con qué stablecoin y red quieres pagar. Aquí está el flujo de principio a fin:

Tú: La semana que viene me voy a Tailandia — móntame los datos.

Agente: Roamzy es una única eSIM universal que funciona en 193 países, facturada por MB a la tarifa local — sin paquetes, sin caducidad. ¿Cuánto te gustaría recargar? El mínimo es 20 $ USDT. ¿Y con qué stablecoin y red quieres pagar — por ejemplo USDT en TRON, BSC o TON, o USDC en Solana?

Tú: 20 $, USDC en Solana.

Agente: Hecho. El número de tu eSIM es 2040XXXXXX. Paga aquí: [enlace de pago]. Guarda este enlace de recuperación para poder llegar a esta eSIM desde otro chat: [enlace de reclamación]. Te traeré tu QR en cuanto se confirme el pago.

Qué pasó bajo el capó, herramienta a herramienta:

1. roamzy_status — una comprobación rápida de actividad y política (¿está el servicio en marcha?, ¿están habilitadas las compras?).
2. roamzy_estimate(country_slug, mb_estimated) — opcional, solo si preguntaste "cuánto costaría X". Esto es un cálculo de referencia, no una entrada de compra; no compromete nada.
3. roamzy_payment_options — obtiene la lista en vivo de stablecoins y redes, para que el agente te ofrezca opciones reales en lugar de adivinar. Este paso es obligatorio antes de una compra: elegir una red por ti bloquearía el pago a una cadena que quizá no tengas.
4. roamzy_create_order(amount_usdt, pay_currency, country_slug) — acuña la eSIM y la factura. Aquí country_slug es solo una etiqueta de factura (su valor por defecto es una referencia de tarifa baja); no restringe dónde funciona la eSIM. Devuelve tu número de teléfono (MSISDN), una URL de pago y — en modo anónimo — una URL de reclamación.
5. roamzy_order_status(order_id) — se consulta hasta que el pago en USDT se confirma, normalmente de uno a quince minutos según la red.
6. roamzy_get_esim(esim_id) — devuelve las superficies de activación una vez pagado: una imagen QR para renderizar en el chat, la carga útil QR en bruto, y un enlace de instalación de un toque para cuando el agente y el teléfono son el mismo dispositivo.

Las barandillas que obtienes sin configurar nada

La autonomía solo es razonable si está acotada, así que los límites están activados por defecto. Cada token de agente — incluido el anónimo creado para ti — lleva:

• Topes de gasto. Una sesión anónima se mantiene en 30 $ al día, 100 $ al mes, un techo de enfriamiento de 30 $ en un token recién creado, una sola eSIM activa, y cualquier transacción superior a 50 $ devuelta para confirmación humana. Una cuenta nominal (reclamada) obtiene 50 $/día, 500 $/mes, un enfriamiento de 50 $, una puerta de transacción grande de 200 $, y hasta cinco eSIM.
• Un presupuesto que el agente puede ver. Los límites restantes vuelven en cada llamada, para que el agente razone sobre lo que le queda en lugar de descubrir un tope chocando contra él.
• Interruptores de apagado. Tres independientes — revocar un solo token, bloquear el acceso de agente de una cuenta individual, o pausar todas las compras de agentes a nivel global — con el estado actual legible en roamzy_status.

No activas nada de esto. Es lo predeterminado, y la justificación de diseño más profunda está en la guía para desarrolladores.

Pasar de anónimo a una cuenta nominal

Una eSIM anónima funciona por completo — se puede recargar y usar indefinidamente. Cuando quieras ligarla a una identidad real (para subir los topes, gestionarla en un navegador, o sencillamente no depender de un enlace guardado), recláma­la. Abre el enlace de reclamación, inicia sesión con Google o Telegram, e introduce el código de un solo uso; la eSIM y su saldo pasan a tu cuenta nominal. Es totalmente opcional y ocurre después de la compra, nunca antes. Pagado en USDT o USDC, al saldo le da igual qué cuenta lo posea.

Cuando algo no funciona

• No aparece ninguna herramienta de Roamzy. Casi siempre una errata de JSON en la configuración o un reinicio incompleto. Valida el JSON, y en Claude Desktop sal del todo con Cmd-Q en lugar de cerrar la ventana.
• El agente puede leer pero no comprar. El modo anónimo expone la herramienta de compra automáticamente. Con un token nominal necesitas tanto el alcance de compra en el token como ROAMZY_ENABLE_PURCHASE puesta a true.
• El agente pregunta "¿qué país?". Ese es el antipatrón de antes — la eSIM es global. Un agente correcto solo pide un importe de recarga y un método de pago. Si el tuyo insiste en un país, está razonando desde un modelo de paquete que aquí no aplica.
• El pago parece atascado. Las confirmaciones de USDT y USDC tardan aproximadamente de uno a quince minutos según la red; el agente debería consultar roamzy_order_status en lugar de dar por hecho un fallo.

A dónde ir después

Ahora tienes un agente capaz de comprar conectividad. Para la arquitectura detrás del servidor MCP y las decisiones de diseño de la API, lee la guía para desarrolladores. Para ver cómo se compara con el mercado de consumo establecido, la comparativa Roamzy vs Airalo es franca sobre dónde gana cada uno. La visión general de una página de toda la superficie para agentes vive en agents.html, la API REST está documentada en /api/v1/docs, y la guía en formato largo escrita para motores está en /llms-full.txt. Si te atascas, el bot de soporte es @roamzy_support_bot.