Pruebas de OTP para agentes de IA

Un agente de IA que maneja un navegador para registrarse en un servicio choca con el mismo muro que un humano: "revisa tu correo para ver el código". A diferencia de un humano, no tiene bandeja de entrada que revisar — a menos que le des una. El servidor MCP de OTPBox hace exactamente eso: le da al agente herramientas para crear una bandeja real, esperar el correo y extraer el código o el enlace, todo dentro de la misma conversación que está llevando el registro.

Por qué MCP y no un script

Las guías de Playwright/Cypress de esta serie conectan una secuencia fija de pasos que un humano escribió de antemano. Un agente es diferente: decide en tiempo de ejecución si necesita una bandeja, cuándo revisarla y qué hacer con lo que llega. Las herramientas de MCP están hechas exactamente para eso — llamadas puntuales y bien definidas que el propio razonamiento del agente invoca según lo necesita, en lugar de un script que ejecuta de principio a fin. La misma cuenta y cuota de OTPBox respaldan ambos casos; MCP es solo una segunda interfaz sobre las mismas bandejas, mensajes e identidades que la API REST.

1. Conecta el servidor

OTPBox ejecuta un servidor MCP remoto (HTTP con streaming) en https://otpbox.io/mcp, autenticado con la misma clave bearer que la API REST. Añádelo a un cliente compatible con MCP — Claude, Cursor, o tu propio framework de agentes:

{
  "mcpServers": {
    "otpbox": {
      "url": "https://otpbox.io/mcp",
      "headers": { "Authorization": "Bearer <your-key>" }
    }
  }
}

Obtén una clave sin necesidad de cuenta — POST /api/v1/keys/free (ver Obtener una clave) — o genera una clave de organización desde el panel si varios agentes o proyectos deben compartir una misma cuota.

2. Las herramientas con las que cuenta un agente

El servidor expone 13 herramientas en total; estas son las que una tarea de registro y verificación realmente usa. Lista completa y detalles de argumentos en la documentación.

Herramienta	Úsala para…
`create_test_inbox`	Obtener una dirección desechable nueva antes de iniciar el registro.
`wait_for_email`	Bloquear hasta que llegue algo, en lugar de que el agente sondee por su cuenta.
`get_otp`	Leer solo el código extraído del mensaje más reciente.
`get_verification_link`	Leer el enlace de confirmación/restablecimiento/inicio mágico extraído en lugar de un código.
`get_latest_email`	Leer el mensaje completo cuando el agente necesita más que el código (asunto, cuerpo, remitente).
`create_test_identity`	Obtener un nombre, país y perfil junto con la bandeja, para un formulario de registro que quiere una persona creíble, no solo una dirección de correo.
`delete_inbox`	Limpiar una vez que la tarea termina.

3. Una tarea típica de agente

Con una instrucción como "regístrate en acme.example.com y confirma que la cuenta existe", un agente con las herramientas de OTPBox disponibles y una herramienta de navegador (o su propia capacidad HTTP) tiende a seguir más o menos esta secuencia — este es el patrón de llamadas a herramientas, no código literal, ya que el propio modelo del agente decide el orden y los reintentos:

1. create_test_inbox()
   -> { id: "a1b2c3", address: "bold.quartz844@otpbox.io", expiresAt: ... }

2. (drive the browser) fill the signup form's email field with that address,
   submit

3. wait_for_email({ inboxId: "a1b2c3", timeoutSeconds: 20 })
   -> { timedOut: false, message: { code: "482913", ... } }

   // or, if the agent only wants the code and not the whole message:
   get_otp({ inboxId: "a1b2c3" })
   -> { code: "482913", messageId: "msg_..." }

4. (drive the browser) type "482913" into the OTP field, submit

5. delete_inbox({ inboxId: "a1b2c3" })

Prefiere wait_for_email antes que hacer que el agente llame a get_otp en un bucle manual de reintentos — es una sola llamada que bloquea en el servidor (hasta 25 segundos) en lugar de varias llamadas que consumen cuota cada una.

4. Pruebas masivas y con perfiles

Un agente con una tarea como "crea 10 cuentas de prueba con distintos países y confirma que cada una se verifica" puede usar create_bulk_test_identities (plantilla más un número de 1 a 50) en lugar de llamar a create_test_inbox en un bucle — cada identidad llega con un nombre, correo y perfil apropiado al país ya adjuntos, respaldados por su propia bandeja real. Plantillas: us_customer, indian_customer, european_customer, business_customer, student, employee.

Límites con los que se topará un agente

Cada llamada a una herramienta cuenta como una solicitud contra la cuota mensual de la clave (Gratis: 200/mes; Pro: 5.000/mes compartidas por organización — ver precios), igual que una llamada REST. Un agente que sondea innecesariamente la agota igual que lo haría una suite de pruebas charlatana.
Las llamadas MCP tienen además un límite de 60/minuto por clave, así que un bucle descontrolado de un agente no puede saturar el servidor ni siquiera dentro de la cuota.
Los fallos aparecen como errores de herramienta MCP, no como códigos de estado HTTP — un framework de agentes bien construido debería tratar un resultado de error de herramienta como una señal para detenerse y reconsiderar, no simplemente reintentar a ciegas.
Una clave creada con permisos restringidos (panel → clave → permisos) rechazará las herramientas fuera de esos permisos con un error de permiso insuficiente — útil para darle a un agente una clave que solo pueda crear bandejas y leer OTP, nada más.

Próximos pasos

¿Listo para integrarlo en tu propio agente? Crea una cuenta gratuita

Documentación de la API Precios Todas las guías Registro de cambios

← Volver a OTPBox