Platfone - Receive SMS & Virtual Numbers MCP

oficial

Plataforma de números de teléfono virtuales para agentes de IA: alquila números en más de 200 países, recibe SMS y gestiona el ciclo de vida completo de activación.

GitHub

¿Qué puedes hacer con Platfone Receive SMS & Virtual Numbers MCP?

Consultar saldo de la cuenta — Pídele a la IA que recupere tus fondos totales, reservados y disponibles usando get_balance.
Verificar costo y disponibilidad — Revisa el precio y la disponibilidad de números para un par de país y servicio con check_price antes de realizar un pedido.
Solicitar un número virtual — Alquila un número de teléfono temporal por país y nombre de servicio mediante order_number para recibir un ID de activación y un número de teléfono.
Consultar SMS recibidos — Verifica si ha llegado un código SMS para una activación usando check_sms, con estado y guía de sondeo incluidos.
Solicitar un nuevo SMS — Activa un reintento gratuito para recibir otro SMS en el mismo número con retry_activation.
Cancelar y reembolsar — Libera una activación activa y recupera los fondos reservados usando cancel_activation antes de recibir un SMS.

Documentación

Servidor MCP de Platfone

Platfone proporciona números de teléfono virtuales para verificación de cuentas, pruebas y flujos de automatización. El servidor MCP de Platfone permite a los agentes de IA obtener números temporales y recibir mensajes SMS desde clientes compatibles con MCP como Claude, VS Code Copilot, Codex, etc.

📖 Documentación · 🔧 Guía de configuración · 🔑 Obtener clave API · 📦 npm

¿Por qué MCP?

En lugar de integrar la API manualmente, los agentes de IA pueden:

Solicitar números de forma autónoma por país y nombre de servicio
Esperar códigos SMS
Reintentar o cancelar activaciones

Todo mediante llamadas estructuradas a herramientas, sin necesidad de un backend personalizado.

Características

Ciclo de vida completo de activación — desde solicitar un número hasta recibir el SMS
Catálogo con caché ETag — países y servicios se almacenan en caché en memoria con TTL de 5 minutos y actualización condicional basada en ETag — nunca se envía al agente
Entradas amigables — usa "Israel" o "Telegram" en lugar de IDs; los nombres se resuelven automáticamente en el servidor
Transporte dual — stdio y http desde una única base de código
Autenticación por clave API — funciona con tu clave API de Platfone existente

Instalación

Consulta la Guía de instalación completa para instrucciones detalladas.

Inicio rápido

NPM:

PLATFONE_API_KEY=your_key npx @platfone/mcp

Directrices para agentes

Siempre llama primero a check_price para verificar costo y disponibilidad
Luego llama a order_number para alquilar un número
Llama a check_sms hasta que se reciba el SMS o expire
Usa retry_activation si no llega ningún SMS
Usa cancel_activation para liberar fondos si ya no se necesitan

Herramientas

Herramienta	Descripción
`get_balance`	Consultar saldo de cuenta: fondos totales, reservados y disponibles.
`check_price`	Verificar precio y disponibilidad para un par país + servicio antes de solicitarlo.
`order_number`	Solicitar un número de teléfono virtual. Acepta nombres ("Israel") o IDs ("il"). Devuelve `activation_id` + `phone`.
`check_sms`	Consultar estado de activación. Devuelve el código SMS cuando se recibe, o el estado actual con instrucciones de consulta.
`retry_activation`	Solicitar otro SMS en el mismo número. Sin costo.
`cancel_activation`	Cancelar una activación activa antes de recibir el SMS. Reembolsa el monto reservado.

Nota: Los catálogos de países y servicios se almacenan en caché del lado del servidor y se resuelven automáticamente a partir de nombres legibles. El agente nunca recibe el catálogo completo — solo IDs resueltos o sugerencias para desambiguar.

Flujo típico del agente de IA

1. check_price         (country: "Israel", service: "Telegram")  → verify cost & availability
2. order_number        (country: "Israel", service: "Telegram")  → returns activation_id + phone
3. check_sms           (activation_id)                            → poll or check once for SMS

Pasos opcionales:

retry_activation — solicitar otro SMS en el mismo número (gratis)
cancel_activation — cancelar antes de que llegue el SMS (reembolsa el saldo)

Desarrollo

Lee la Guía de desarrollo completa para instrucciones de configuración y consejos de prueba.

Solución de problemas

Error	Solución
`UnauthorizedException`	Verifica que tu `PLATFONE_API_KEY` sea válida
`PaymentRequiredException`	Recarga tu saldo de Platfone
`NoNumbersAvailableException`	Prueba con un país o servicio diferente
`TooManyRequestsException`	Límite de velocidad alcanzado — espera y reintenta
`MaxPriceExceededException`	Reintenta `order_number` con el `max_price` sugerido y el `order_id` devuelto
`TooManyActivationsException`	Máximo de activaciones activas concurrentes alcanzado — cancela o espera a que expiren

Licencia

Consulta LICENSE.md. Con licencia MIT.

El uso de la API de Platfone está sujeto a los Términos de servicio y la Política de privacidad.