Sv number (SMS verification numbers for agents)

SV Number servidor MCP

Números de teléfono como herramientas. Tu agente solicita un número privado en el país que un servicio espera, lee el código de verificación SMS directamente de la API y devuelve el número. Nueve herramientas sobre stdio, sin SDK que aprender.

Más de 200 países, la cobertura más amplia en esta categoría. Cualquier otra afirmación en esta página también es verificable, pero esta requiere una sola llamada: ejecuta list_countries y cuenta las filas.

order_number(service="tg", country=6)   ->  +62 838 1234 5678
wait_for_code(activationId)             ->  123456
finish_activation(activationId)         ->  done

Instalación

Claude Code:

claude mcp add sv-number --env SVN_API_KEY=your_key_here -- npx -y sv-number-mcp

Cualquier cosa que lea una configuración JSON (Codex, Cursor, Claude Desktop):

{
  "mcpServers": {
    "sv-number": {
      "command": "npx",
      "args": ["-y", "sv-number-mcp"],
      "env": { "SVN_API_KEY": "your_key_here" }
    }
  }
}

La clave proviene de tu perfil después del registro. El saldo debe estar financiado: no hay nivel gratuito en esta API. La clave se lee del entorno y nunca sale del proceso, ninguna herramienta la devuelve y ningún mensaje de error la cita.

Herramientas

Herramienta	Qué hace
get_balance	lo que queda en la cuenta
list_countries	cada país con su id y operadores
list_services	encontrar el código para un sitio: buscar por nombre o dominio, mejor coincidencia primero, precio, cuántos están en línea y la proporción de códigos que realmente llegaron
order_number	solicitar un número privado para un servicio en un país
wait_for_code	consultar hasta que llegue el código y devolverlo, ya extraído del SMS
finish_activation	cerrar una activación exitosa
cancel_activation	cancelar y recuperar el dinero
request_another_sms	solicitar un código más en el mismo número
totp_code	calcular el código autenticador localmente, según RFC 6238

list_services responde con matches clasificados mejor primero más notInList, el servicio de respaldo. Toma un nombre de sitio o una URL, por lo que discord.com encuentra Discord, y clasifica una palabra completa por encima de una subcadena, por lo que x pone X.com (Twitter) por encima de Maxim. Los códigos son arbitrarios y nunca deben recordarse de memoria: uk es Airbnb, re es Coinbase, tn es LinkedIn. Cuando no hay coincidencia, la respuesta lo dice y señala a otro país, porque el catálogo no es el mismo en todas partes, y a ot ("No en la lista"), que recibe SMS de cualquier remitente que no esté en la lista. Un sitio que tiene su propio código envía a ese código, por lo que ot es un respaldo y no un comodín.

deliveredPercent es la tasa de entrega para ese servicio y país, y null cuando el par aún no tiene estadísticas, que es el caso común. Donde hay un número, elige por él en lugar de por precio; donde no lo hay, online muestra cuán grande es el grupo en vivo, que es la siguiente mejor señal.

Lo que el servidor maneja por ti

Cada llamada lleva lang. La API responde sin él, pero entonces cotiza en otra moneda, por lo que el servidor nunca lo omite. Los marcadores de texto que la API devuelve en lugar de JSON se verifican antes de analizar cualquier cosa y se convierten en una frase sobre la que un agente puede actuar: NO_NUMBERS se convierte en "cambia de país, o establece el operador en cualquiera" en lugar de un token simple. El sondeo se ejecuta a un intervalo razonable en lugar de golpear getStatus, y wait_for_code se detiene a los 20 minutos de vida de un número.

Lo que no es

Recibir códigos de verificación es todo el trabajo. Estos números no envían SMS, no reciben llamadas y no están destinados a cuentas bancarias, de pago o gubernamentales. Un agente que necesita un número permanente para mantener una conversación quiere un producto de operador en su lugar.

Configuración

Variable	Predeterminado
SVN_API_KEY	requerido
SVN_API_BASE	https://sms-verification-number.com/stubs/handler_api
SVN_LANG	en, establece tanto el idioma como la moneda de las respuestas
SVN_POLL_SECONDS	4

Relacionados

• El mismo producto como habilidad de markdown: https://github.com/sv-number/skills
• Referencia de API: https://sms-verification-number.com/en/api-sms-activate/
• Cobertura y precios: https://sms-verification-number.com/en/number-for-ai-agents/

MIT. El servicio detrás de él es comercial.