Activación de un solo uso · REST + MCP

Un número, un código

Compra un número privado, captura el código de verificación y sigue adelante. La activación vive unos 20 minutos, y si nunca llega el SMS te quedas con tu dinero: el saldo prepago se devuelve y una retención x402 sin liquidar se libera.

Conecta tu cliente de IA Ir al inicio rápido de REST
Duración
Unos 20 minutos
Qué obtienes
Un código de verificación
Ideal para
Verificación de cuentas y flujos OTP
800+ servicios cubiertos
200+ países disponibles
Sin registro para ver precios
Por número nunca una suscripción

Empieza a construir

Consigue tu clave de API en menos de un minuto

Regístrate con un correo electrónico: sin tarjeta y sin llamadas comerciales. El enlace de acceso te devuelve a esta misma página y te entrega una clave que funciona con la API REST y con el servidor MCP.

Crearla es gratis. Pagas por número, nunca una suscripción.

Cómo funciona

Cuatro pasos, de principio a fin

Cada paso de abajo corresponde a endpoints y herramientas reales. Guarda el id que devuelve la compra: todo lo posterior cuelga de él.

  1. 1

    Consulta el inventario en vivo

    Lista los servicios y luego los países. La disponibilidad y los precios exactos en USD se devuelven en vivo.

    GET /v1/sms/activation/servicesGET /v1/sms/activation/countries sms_activation_list_servicessms_activation_list_countries
  2. 2

    Compra un número

    Elige saldo prepago o x402 sin cuenta, y guarda el id de activación devuelto.

    POST /v1/sms/activation/numbers sms_activation_buy_number
  3. 3

    Consulta hasta que llegue el código

    Lee el estado cada pocos segundos hasta que llegue un código o la activación termine.

    GET /v1/sms/activation/numbers/{id} sms_activation_get_code
  4. 4

    Completa o recibe el reembolso

    Usa el código de inmediato. Si no llega ningún SMS antes de que caduque, la activación se reembolsa automáticamente.

Configúralo una vez

Pon Voxisim dentro de tu cliente de IA

Conecta el endpoint alojado y tu agente podrá comparar precios, comprar un número y darte el código sin que escribas una sola petición. Nada que instalar: no hay paquete, ni servidor local, ni contenedor; solo una URL y un inicio de sesión en el navegador.

Endpoint alojado https://api.voxisim.com/mcp
Streamable HTTP · OAuth o clave bearer
  1. 01

    Añade el endpoint

    Elige tu cliente abajo y copia el bloque que necesita.

  2. 02

    Inicia sesión una vez

    Aprueba el aviso de OAuth en el navegador, o pasa una clave vxs_ desde tu gestor de secretos si prefieres no usar OAuth.

  3. 03

    Solo pídelo

    Tu agente elige las herramientas adecuadas y va pasando los ids entre ellas, así que una sola frase cubre todo el ciclo.

Claude

Web y escritorio

OAuth

Abre Ajustes → Conectores, añade un conector personalizado llamado Voxisim y pega el endpoint alojado.

Sin archivo de configuración 
https://api.voxisim.com/mcp

Pulsa Conectar y termina el inicio de sesión en el navegador. Activa Voxisim desde búsqueda y herramientas en tu chat.

Flujo del agente

Lo que hace realmente tu agente

Las herramientas están tipadas y nombradas por su función, así que los resultados vuelven como campos estructurados y no como texto que el agente tiene que releer. Las compras pueden salir de tu saldo o responder con un reto de pago que tu agente firma desde una wallet.

5 herramientas para este producto

  • sms_activation_list_services
  • sms_activation_list_countries
  • sms_activation_buy_number
  • sms_activation_get_code
  • sms_activation_list_numbers

Prueba a pedirle a tu agente

Busca el país disponible más barato para WhatsApp, compra una activación y espera el código de verificación.
Muéstrame los países disponibles y los precios exactos actuales para una activación de Telegram antes de comprar nada.
Revisa mis activaciones SMS activas e infórmame de cualquier código que haya llegado.

REST

Inicio rápido con REST

El descubrimiento es público: puedes ejecutar el primer bloque ahora mismo sin cuenta. Comprar requiere una clave prepago o un pago x402 firmado, y el cuerpo de la petición es idéntico en ambos casos.

Dos formas de pagar, una sola llamada de compra

El saldo prepago es más simple si compras a menudo. El x402 sin cuenta va mejor para una compra autónoma puntual: guarda el receipt_token de la primera respuesta pagada para poder consultar después qué compraste.

1. Descubre gratis

No hace falta cuenta. Consulta la disponibilidad en vivo y los precios exactos antes de comprar.

curl 'https://api.voxisim.com/v1/sms/activation/services'
curl 'https://api.voxisim.com/v1/sms/activation/countries?service_id=SERVICE_ID'

2A. Usa saldo prepago

Crea una cuenta una vez, recárgala por x402 y usa la clave vxs_ devuelta para tus compras.

curl -X POST https://api.voxisim.com/v1/signup \
  -H 'content-type: application/json' \
  -d '{"label":"docs-quickstart"}'

curl -X POST https://api.voxisim.com/v1/sms/activation/numbers \
  -H 'authorization: Bearer YOUR_VXS_API_KEY' \
  -H 'content-type: application/json' \
  -d '{"service_id":"SERVICE_ID","country_id":COUNTRY_ID}'

2B. O paga sin cuenta con x402

Envía la compra sin credenciales, firma uno de los requisitos de la respuesta 402 y repite la misma petición.

curl -i -X POST https://api.voxisim.com/v1/sms/activation/numbers \
  -H 'content-type: application/json' \
  -d '{"service_id":"SERVICE_ID","country_id":COUNTRY_ID}'

curl -X POST https://api.voxisim.com/v1/sms/activation/numbers \
  -H 'content-type: application/json' \
  -H 'X-PAYMENT: BASE64_SIGNED_AUTHORIZATION' \
  -d '{"service_id":"SERVICE_ID","country_id":COUNTRY_ID}'

3. Consulta hasta que llegue el código

Consulta cada pocos segundos hasta que codes no esté vacío o done sea true.

curl 'https://api.voxisim.com/v1/sms/activation/numbers/YOUR_ACTIVATION_ID' \
  -H 'authorization: Bearer YOUR_VXS_API_KEY'
Método Ruta Qué hace
GET /v1/sms/activation/services Lista servicios y las opciones más baratas en vivo
GET /v1/sms/activation/countries Lista países, stock y precios exactos
POST /v1/sms/activation/numbers Compra un número de un solo uso
GET /v1/sms/activation/numbers/{id} Lee el estado y los códigos recibidos
GET /v1/sms/activation/numbers Lista activaciones activas o archivadas

Notas de uso

Reembolsos, caducidad y recuperación limpia

La caducidad y los tropiezos del proveedor son estados normales, no excepciones. Ramifica según el error tipado, vuelve a ejecutar el descubrimiento antes de reintentar y nunca des por hecho que el precio de la última ejecución sigue vigente.

Sin SMS, sin cargo

Si no llega nada antes de los aproximadamente 20 minutos de caducidad, el reembolso es automático. El saldo prepago se devuelve y una autorización x402 se libera sin llegar a liquidarse: no tienes que pedirlo.

Un código y se acabó

Consulta hasta que codes no esté vacío o done sea true, y usa el código enseguida. Una activación no captura un segundo mensaje; si necesitas otro intento, inicia una nueva.

Los secretos, fuera de los prompts

Las claves vxs_ y los valores receipt_token de x402 van en un gestor de secretos, no en prompts, en el control de versiones ni en los logs.

Cuando algo sale mal

  • invalid_argument: tu servicio, país o intervalo está obsoleto. Vuelve a ejecutar el descubrimiento y envía una combinación válida ahora mismo.
  • payment_required: es lo esperado en la vía x402. Firma uno de los requisitos ofrecidos y repite la petición idéntica.
  • number_unavailable o un conflicto: esa opción acaba de agotarse. Descubre de nuevo y elige otra en lugar de repetir la misma compra.
  • provider_unavailable o límite de tasa: espera y respeta la indicación de reintento del error. Reintentar de inmediato lo empeora.

¿Aún con dudas?

Activación y alquiler resuelven problemas distintos

Elige la duración más corta que cubra tu flujo. El stock y los precios están en vivo para ambos.

Activación SMS

Estás aquí

Compra un número de teléfono de un solo uso y recibe su código de verificación.

  • Unos 20 minutos
  • Un código de verificación
  • Verificación de cuentas y flujos OTP

Alquiler SMS

Alquila un número de teléfono durante el tiempo que elijas y recibe sus mensajes SMS.

  • Un día o más
  • Varios mensajes SMS
  • Sesiones, pruebas y acceso continuado
Leer la guía de Alquiler SMS

Dónde encaja la activación de un solo uso

Contraseñas de un solo usoVerificación de cuentasAutomatización de registros y QATareas cortas ejecutadas por agentes

Preguntas frecuentes

Preguntas sobre la activación

  • Unos 20 minutos desde la compra. Esa ventana es para recibir el código, no para quedarte el número: cuando caduca, el número desaparece y no se puede renovar.

  • Se te reembolsa automáticamente al caducar. No hay ticket de soporte ni reclamación que presentar: el saldo prepago se devuelve y una autorización x402 que nunca se liquidó simplemente se libera.

  • No. Una activación cubre una sola verificación. Si necesitas verificar otra vez, compra otra; por eso también es la opción más barata por código.

  • Normalmente segundos después de que el servicio lo envíe, pero eso depende por completo del servicio, no de nosotros. Consulta cada pocos segundos en lugar de esperar en una única petición larga.

  • No. Llama al endpoint de países justo antes de comprar: devuelve el stock actual y el precio exacto, y ambos se mueven con la oferta real.

  • Sí. Envía la compra sin credenciales, firma el reto x402 que llega de vuelta y repite la petición. El descubrimiento nunca necesitó credenciales.

Referencia

Los contratos generados

Esta página explica el flujo. Para cada parámetro, campo de respuesta y entrada de herramienta, ve a la referencia: se genera desde el contrato en vivo, así que no puede desviarse.

API interactivaExplora las operaciones en Scalar REST en MarkdownGenerado desde OpenAPI MCP en MarkdownGenerado desde los metadatos de las herramientas OpenAPI JSONContrato legible por máquinas

¿Listo para comprar tu primer número?

Conecta un cliente MCP y pídeselo, o copia el inicio rápido de REST y ejecútalo.

Abrir la referencia de la API Comparar ambos productos