VirtualSMS

VirtualSMS MCP Server

Enlaces rápidos: Inicio rápido · Por qué VirtualSMS · Lo que puedes construir · Herramientas · Preguntas · Ejemplos · Registro de cambios · Política de seguridad · Estado

VirtualSMS es una plataforma de verificación de cuentas para desarrolladores y agentes de IA. Combina verificación por SMS de un solo uso, alquiler de números dedicados, proxies de países coincidentes y sesiones privadas de navegador en la nube detrás de una única API, un único servidor MCP y un único saldo prepago.

Infraestructura para agentes de IA que necesitan verificación telefónica del mundo real.

Los números son números móviles emitidos por operadores, respaldados por tarjetas SIM físicas reales en redes de operadores, no VoIP, por lo que pasan las comprobaciones de tipo de línea que rechazan los números VoIP al registrarse.

Desde un único saldo prepago puedes:

• recibir códigos SMS de un solo uso desde $0.05
• alquilar números dedicados de 1 a 30 días
• comprar proxies residenciales, móviles y de centro de datos del país coincidente
• lanzar sesiones privadas de navegador en la nube que funcionan junto a tu número y proxy (beta)

Los cuatro funcionan juntos desde un único saldo prepago, una única API y un único panel de control. Usa solo las piezas que necesites o combínalas en un único flujo de verificación.

La mayoría de los proveedores resuelven una sola parte del flujo de verificación. VirtualSMS combina números, alquileres, proxies y sesiones de navegador en la nube detrás de una única API, SDK y un servidor MCP, para que uses solo las piezas que necesites o las combines en un único flujo de trabajo.

VirtualSMS puede ser utilizado manualmente por individuos, integrarse en aplicaciones con SDK y API, o ser impulsado por agentes de IA a través de MCP. Usa la plataforma a través de una API REST, SDK oficiales para Node, Python, PHP, Ruby y .NET, un servidor MCP alojado, o herramientas de automatización como n8n.

Este servidor expone esa plataforma a cualquier cliente MCP. Construido para agentes de IA. Diseñado para flujos de trabajo agénticos. Funciona con Claude Code, Claude Desktop, Cursor, Windsurf y cualquier cliente compatible con MCP, sin necesidad de escribir código envoltorio.

Inicio rápido

Pega esto en la configuración de tu cliente MCP. Nada que instalar, no se requiere Node.js en el cliente:

{
  "mcpServers": {
    "virtualsms": {
      "type": "streamableHttp",
      "url": "https://mcp.virtualsms.io/mcp",
      "headers": {
        "x-api-key": "vsms_your_api_key_here"
      }
    }
  }
}

Obtén una clave de API en virtualsms.io. Luego pregúntale a tu agente:

"Cómprame un número de Telegram en el país más barato y espera el código."

¿Prefieres ejecutarlo localmente con stdio?:

npx virtualsms-mcp

Por qué VirtualSMS

Verificar una cuenta no debería significar unir números de un proveedor, proxies de otro y sesiones de navegador de un tercero: múltiples cuentas, múltiples saldos y APIs, y soporte distribuido entre proveedores. VirtualSMS reúne esas piezas detrás de un único saldo, una única API y un único servidor MCP.

VirtualSMS combina los tres bajo una sola cuenta y te da una sola forma de manejarlos:

• Números móviles emitidos por operadores. Respaldados por tarjetas SIM físicas reales, no VoIP, por lo que se resuelven como móviles al registrarse.
• Proxies del país coincidente. Grupos residenciales, móviles y de centro de datos, para que el número y la IP coincidan.
• Sesiones privadas de navegador en la nube. Beta.
• API REST. Documentada en virtualsms.io/docs.
• Servidor MCP alojado. Este repositorio, en vivo en https://mcp.virtualsms.io/mcp.
• Un único saldo prepago. La verificación, los alquileres y los proxies se cargan a este saldo.

Todo lo siguiente amplía esos seis puntos.

Lo que puedes construir

Trabajos concretos que este servidor hace hoy. Cada uno es una solicitud en lenguaje natural que tu agente convierte en llamadas a herramientas:

Las versiones ejecutables de los dos primeros se encuentran en examples/.

Configuración del cliente

Cada cliente ejecuta el mismo comando stdio npx virtualsms-mcp. Solo cambian la ubicación y el formato del archivo. La configuración alojada anterior funciona en cualquier lugar donde se admita streamableHttp y es la ruta recomendada.

Claude Desktop

Edita ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "virtualsms": {
      "command": "npx",
      "args": ["virtualsms-mcp"],
      "env": {
        "VIRTUALSMS_API_KEY": "vsms_your_api_key_here"
      }
    }
  }
}

Cierra y vuelve a abrir Claude Desktop. Una configuración lista para usar más una transcripción de ejemplo se encuentra en examples/03-claude-desktop-config/.

claude mcp add --scope user virtualsms npx virtualsms-mcp -e VIRTUALSMS_API_KEY=vsms_your_api_key_here

{
  "mcpServers": {
    "virtualsms": {
      "command": "npx",
      "args": ["virtualsms-mcp"],
      "env": {
        "VIRTUALSMS_API_KEY": "vsms_your_api_key_here"
      }
    }
  }
}

{
  "mcpServers": {
    "virtualsms": {
      "command": "npx",
      "args": ["virtualsms-mcp"],
      "env": {
        "VIRTUALSMS_API_KEY": "vsms_your_api_key_here"
      }
    }
  }
}

{
  "mcpServers": {
    "virtualsms": {
      "command": "npx",
      "args": ["virtualsms-mcp"],
      "env": {
        "VIRTUALSMS_API_KEY": "vsms_your_api_key_here"
      }
    }
  }
}

[mcp_servers.virtualsms]
command = "npx"
args = ["virtualsms-mcp"]
env = { VIRTUALSMS_API_KEY = "vsms_your_api_key_here" }

{
  "mcpServers": {
    "virtualsms": {
      "command": "npx",
      "args": ["virtualsms-mcp"],
      "env": {
        "VIRTUALSMS_API_KEY": "vsms_your_api_key_here"
      }
    }
  }
}

{
  "virtualsms": {
    "command": "npx",
    "args": ["virtualsms-mcp"],
    "env": {
      "VIRTUALSMS_API_KEY": "vsms_your_api_key_here"
    }
  }
}

{
  "context_servers": {
    "virtualsms": {
      "command": {
        "path": "npx",
        "args": ["virtualsms-mcp"],
        "env": {
          "VIRTUALSMS_API_KEY": "vsms_your_api_key_here"
        }
      }
    }
  }
}

mcpServers:
  - name: virtualsms
    command: npx
    args:
      - virtualsms-mcp
    env:
      VIRTUALSMS_API_KEY: vsms_your_api_key_here

¿Funciona esto con ChatGPT?

Sí, a través del Modo Desarrollador de ChatGPT. Abre Configuración, activa el modo Desarrollador y luego añade https://mcp.virtualsms.io/mcp como conector personalizado (planes Plus, Pro, Business, Enterprise y Edu; no disponible en el nivel gratuito). La configuración es pegar una URL en lugar de un archivo de configuración, por lo que difiere de las configuraciones de cliente anteriores. ChatGPT solo se conecta a servidores MCP remotos a través de SSE o HTTP en streaming, así que usa el endpoint alojado, no el comando stdio local. La API REST sigue disponible si prefieres crear un GPT personalizado o una Action en su lugar.

Configuración

Herramientas

40 herramientas por defecto. Establece VIRTUALSMS_ENABLE_SESSIONS=1 para exponer 3 más.

Los nombres de las herramientas se muestran a continuación sin el prefijo virtualsms_ para mayor legibilidad. Los nombres reales en el cable tienen prefijo: virtualsms_create_order, virtualsms_get_sms, y así sucesivamente.

Flujos de trabajo típicos

Obtener un código de verificación

create_order(service: "telegram", country: "US")
→ {order_id: "abc123", phone_number: "+14155552671", status: "pending"}

wait_for_sms(order_id: "abc123", timeout_seconds: 180)
→ {success: true, code: "12345", delivery_method: "websocket", elapsed_seconds: 8}

Encuentra primero el país más barato

find_cheapest(service: "telegram", limit: 3)
→ {cheapest_options: [{country: "PK", price_usd: 0.05, ...}]}

create_order(service: "telegram", country: "PK")
wait_for_sms(order_id: "abc123")

¿El número no recibe? Cámbialo

swap_number(order_id: "abc123")
→ {order_id: "def456", phone_number: "+628...", status: "waiting"}

Alquila un número por un mes

rentals_available(tier: "full_access")
→ countries holding local SIM stock, each with its own duration and price list

create_rental(tier: "full_access", country: "FR", duration_hours: 720)
→ {rental_id: "rnt_1", phone_number: "+33...", expires_in_days: 30}

El stock es por país y por nivel, así que primero descubre y luego alquila. rentals_available(tier: "platform") cubre un catálogo diferente, bloqueado por servicio.

Combina un número con un proxy del país correspondiente

list_proxy_catalog()
buy_proxy(pool_type: "residential", gb: 1, country_code: "GB")
generate_proxy_endpoint(proxy_id: "px_1", country_code: "GB", protocol: "socks5")

Preguntas

¿Qué es la infraestructura de verificación de cuentas?

La infraestructura de verificación de cuentas es la pila que lleva una cuenta real a través de un flujo de registro que exige un número de teléfono. Tiene cinco capas, y una brecha en cualquiera de ellas hace fallar toda la cadena:

1. Números. Una línea móvil emitida por un operador, porque se comprueba el tipo de línea.
2. SMS. El código de verificación, entregado a ese número y legible por software en lugar de por un humano sosteniendo un teléfono.
3. Proxy. Una IP en el mismo país que el número, para que ambos coincidan.
4. Navegador. Un entorno limpio para llevar a cabo el propio registro.
5. Automatización. Una API o un agente que ejecuta la cadena de principio a fin, sin supervisión.

La mayoría de los proveedores venden las dos primeras capas y te dejan conseguir el resto, que es exactamente donde el número, la IP y el navegador dejan de contar la misma historia. VirtualSMS proporciona la infraestructura detrás de las cinco.

VirtualSMS es una plataforma de verificación de cuentas para individuos, desarrolladores y agentes de IA. Combina verificación SMS de un solo uso, alquiler de números dedicados, proxies del país correspondiente y sesiones privadas de navegador en la nube detrás de una API, un servidor MCP y un saldo prepagado.

¿Qué es un servidor MCP para verificación SMS?

MCP (Model Context Protocol) es un estándar abierto que permite a un cliente de IA llamar a herramientas externas. Un servidor MCP para verificación SMS expone operaciones de número de teléfono y código de verificación como herramientas que un agente puede llamar directamente, de modo que el agente compra el número, espera el código y lo lee sin ningún código de conexión por tu parte. Este repositorio es ese servidor para VirtualSMS: 40 herramientas que cubren verificación, alquileres y proxies. Si no estás manejando ningún agente, las mismas operaciones están disponibles como una API REST de verificación simple.

¿Cuándo debería usar esto?

• Tu agente de IA necesita iniciar sesión o registrar una cuenta que exige un número de teléfono.
• Estás probando un flujo de OTP o registro y quieres números nuevos bajo demanda en lugar de un cajón de SIM de prueba.
• Necesitas recuperar un código de verificación automáticamente, en CI o en un trabajo sin supervisión.
• Necesitas un número y una IP del país correspondiente que coincidan entre sí.
• Estás manejando automatización de registro en un navegador y prefieres que el número, la IP y el navegador vengan de un solo lugar en lugar de tres.
• Necesitas un número de teléfono temporal para un código, o uno dedicado que conservas hasta 30 días.
• Quieres precios por código desde $0.05 sin suscripción y sin alquiler mensual de número.

¿Cuándo NO debería usar esto?

Respuestas honestas, para que no pierdas una tarde:

• Necesitas enviar SMS. Esta plataforma recibe; no envía. Usa un proveedor de mensajería como Twilio.
• Necesitas un número permanente para tu negocio. Los números de verificación son temporales por diseño, y los alquileres duran días, no años. Compra una línea real a un operador.
• Necesitas códigos en un número que ya posees. No hay portabilidad. Los números provienen de nuestro inventario.
• Estás ejecutando campañas de marketing A2P. Herramienta completamente equivocada.
• Estás intentando evadir los términos de servicio de una plataforma. Que tu uso cumpla con los términos del servicio contra el que verificas es tu responsabilidad, no la nuestra.

¿Pueden Claude o Cursor recibir códigos de verificación SMS?

Sí, a través de este servidor. Claude Code, Claude Desktop, Cursor, Windsurf, Cline, Zed, Continue.dev, Codex, OpenClaw y Hermes son todos clientes MCP, y cada uno está a un pegado de configuración de distancia (consulta Configuración del cliente). Una vez instalado, «compra un número de Telegram y espera el código» es una solicitud que el agente puede llevar a cabo de principio a fin. ChatGPT también puede acceder, a través de conectores personalizados del Modo Desarrollador (consulta ¿Funciona esto con ChatGPT?), o a través de la API REST si prefieres no habilitar el Modo Desarrollador.

¿Cómo reciben los agentes de IA los códigos OTP automáticamente?

Dos llamadas a herramientas. create_order compra un número para un servicio y país determinados y devuelve un order_id. wait_for_sms se bloquea entonces en ese order_id y devuelve el resultado en el momento en que llega el código, enviado por WebSocket, normalmente en 2 a 15 segundos. El agente nunca sondea, nunca duerme en un bucle y nunca necesita que un humano lea un teléfono. Si prefieres manejar tu propio bucle, get_sms sondea un solo pedido en su lugar.

¿En qué se diferencia esto de Twilio?

Twilio es una plataforma de comunicaciones completa: enviar y recibir SMS y voz, números de larga duración, campañas A2P, todo. VirtualSMS hace un solo trabajo, que es recibir códigos de verificación bajo demanda. Las diferencias prácticas:

• Tipo de línea. Los números de Twilio son VoIP. Muchos servicios rechazan números VoIP en el registro. Los números de VirtualSMS son tarjetas SIM físicas reales en redes de operadores, por lo que se resuelven como móviles.
• Forma de precios. Twilio te cobra por un número cada mes, lo uses o no. VirtualSMS cobra por código desde $0.05, sin suscripción.
• Dirección. Twilio envía y recibe. Esto recibe.

Si necesitas enviar mensajes, usa Twilio. Si necesitas recibir un código de verificación, esto está construido específicamente para ello.

¿Por qué tarjetas SIM físicas reales en lugar de VoIP?

Los sistemas de verificación comprueban el tipo de línea del número que les das. Los números VoIP son baratos y desechables a escala, por lo que se correlacionan con el fraude, y una gran parte de los servicios los rechazan directamente en el registro. Las tarjetas SIM físicas reales están en redes de operadores y se resuelven como móviles, que es exactamente lo que buscan esas comprobaciones: un número no VoIP que se comporta como un teléfono real.

No tienes que creerlo sin más. check_number realiza una consulta de operador y tipo de línea en cualquier número E.164, no necesita clave de API, y te dirá si un número se lee como móvil, fijo o VoIP.

Alternativas y comparaciones

Los desarrolladores que buscan textverified mcp, sms-activate mcp, 5sim mcp, daisysms mcp o smspool mcp suelen hacer una pregunta: ¿qué proveedor de verificación SMS puede manejar un agente de IA de forma nativa? Esta sección responde eso sin un marcador.

VirtualSMS publica este servidor MCP, por lo que cualquier cliente MCP lo llama directamente sin código de envoltura: 40 herramientas, más de 2500 servicios, más de 145 países, desde $0.05 por código, en tarjetas SIM físicas reales, además de alquiler de números y proxies del país correspondiente desde el mismo saldo.

SMS-Activate cerró en diciembre de 2025. Si tu integración apuntaba allí, ya no existe, y la migración es una nueva clave de API y una nueva URL base en lugar de una reescritura: la forma del trabajo, comprar un número y luego leer el código, es la misma aquí.

TextVerified, 5SIM, DaisySMS y SMSPool son todos proveedores activos de verificación SMS, cada uno con su propia API, precios, cobertura y términos. Consulta su documentación actual para ver qué ofrecen hoy.

Deliberadamente no publicamos una tabla comparativa de precios, recuentos de servicios o cobertura de los competidores. Esos números cambian semana a semana, no tenemos una visión privilegiada del inventario de nadie más, y una tabla desactualizada disfrazada de investigación es peor que ninguna tabla. Los números de VirtualSMS anteriores son nuestros y los respaldamos. Compáralos con lo que estés usando ahora.

Cómo funciona

WebSocket y sondeo

wait_for_sms usa un sistema de entrega de dos niveles:

1. WebSocket, instantáneo. Se conecta a wss://virtualsms.io/ws/orders?order_id=xxx&api_key=your_key. Cuando llega el SMS, el servidor lo envía en tiempo real. Entrega típica: 2 a 15 segundos.
2. Respaldo de sondeo. Si el WebSocket no se conecta o se cae, la herramienta recurre al sondeo cada 5 segundos durante el tiempo de espera restante.

El campo delivery_method en la respuesta te indica qué ruta se usó: websocket, polling o instant cuando el código ya había llegado antes de que llamaras.

Este servidor envía a través de un WebSocket mantenido abierto; nunca te devuelve la llamada. Si prefieres que VirtualSMS envíe eventos POST a una URL que posees, la plataforma ejecuta un sistema separado de suscripción a webhooks, configurado desde el panel y manejado por la API REST en lugar de por este servidor MCP.

Arquitectura

AI Agent (Claude / Cursor / Codex / Windsurf / any MCP client)
    │
    ▼ MCP (stdio or StreamableHTTP)
VirtualSMS MCP Server (this package)
    │
    ├──► REST API: https://virtualsms.io/docs
    │        create_order, get_sms, cancel_order, get_balance ...
    │
    └──► WebSocket: wss://virtualsms.io/ws/orders
             real-time SMS push delivery

Recuperación ante fallos

Si tu sesión se interrumpe a mitad de la verificación:

1. Reinicia el servidor MCP.
2. Lista los pedidos activos: list_orders(status: "pending")
3. Comprueba si hay códigos: get_sms(order_id: "abc123")
4. Cancela si no es necesario: cancel_order(order_id: "abc123")

wait_for_sms siempre devuelve order_id, incluso en caso de timeout, para que puedas recuperarte.

Endpoint alojado y estado

• Endpoint MCP alojado: https://mcp.virtualsms.io/mcp. StreamableHTTP solo TLS, con Cloudflare al frente.
• Estado y disponibilidad de la plataforma: virtualsms.io/status, consultado en vivo: sitio web y panel, pasarela SMS, API REST, bot de Telegram y base de datos. El endpoint MCP alojado se ejecuta como un servicio independiente y aún no aparece como fila en esa página.
• SLA objetivo: 99,9% en la ruta MCP alojada. Un objetivo que nos imponemos a nosotros mismos más que una garantía contractual, y que la página de estado anterior aún no mide.
• Cobertura: 145+ países en línea, 2500+ servicios indexados.
• Retención de datos: los cuerpos de los mensajes SMS se conservan durante 7 días y luego se eliminan permanentemente. Los metadatos de los pedidos (número de teléfono, servicio, país, marcas de tiempo) se conservan durante toda la vida de tu cuenta. Consulta SECURITY.md para más detalles.
• Divulgación de vulnerabilidades: envía un correo a security@virtualsms.io o abre un aviso de seguridad privado.

👉 Regístrate en VirtualSMS.io

Ejemplos

En este repositorio hay tres ejemplos ejecutables. Cada uno está a node run.mjs de distancia una vez que se establece VIRTUALSMS_API_KEY.

• examples/01-quick-balance-check/: prueba de humo MCP alojada de 5 segundos (get_balance).
• examples/02-buy-sms-and-wait-for-code/: flujo de verificación completo, find_cheapest → create_order → wait_for_sms → cancelación por timeout. El patrón canónico para agentes de IA.
• examples/03-claude-desktop-config/: configuración de Claude Desktop lista para usar más una transcripción de "pregúntale a Claude cuál es mi saldo" a través de StreamableHTTP.

SDKs y herramientas

La misma plataforma, desde lo que ya uses para escribir:

Compilar y contribuir

git clone https://github.com/virtualsms-io/mcp-server.git
cd mcp-server
npm install
npm run build      # tsc
npm test           # vitest
npx tsc --noEmit   # typecheck only

Dos transportes comparten una misma tabla de herramientas: src/index.ts (stdio) y src/http-server.ts (StreamableHTTP). Las definiciones y los manejadores de herramientas viven en src/tools.ts. Si añades una herramienta, conéctala a ambos transportes. src/__tests__/transport-parity.test.ts hace fallar la compilación si lo olvidas, y src/__tests__/docs-tool-names.test.ts falla si la documentación menciona una herramienta que no existe.

Problemas y pull requests: github.com/virtualsms-io/mcp-server.

Las notas de versión de v1.0.0 a v1.3.1 están en CHANGELOG.md.

Seguridad

Las claves de API se pasan mediante el encabezado x-api-key (alojado) o la variable de entorno VIRTUALSMS_API_KEY (stdio local), y se pueden rotar desde tu cuenta en virtualsms.io. Política completa, detalles de retención y proceso de divulgación: SECURITY.md.

Reporta vulnerabilidades a security@virtualsms.io.

Licencia

MIT. Consulta LICENSE.

Creado por VirtualSMS.io. Verificación de cuentas para desarrolladores y agentes de IA, con tarjetas SIM físicas reales: 2500+ servicios · 145+ países · desde $0.05 por código.