Sv number (SMS verification numbers for agents)

SV Number MCP server

Números de telefone como ferramentas. Seu agente solicita um número privado no país que um serviço espera, lê o código de verificação por SMS direto da API e devolve o número. Nove ferramentas via stdio, sem SDK para aprender.

200+ países, a maior cobertura desta categoria. Qualquer outra afirmação nesta página também pode ser verificada, mas esta leva uma única chamada: execute list_countries e conte as linhas.

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

Instalação

Claude Code:

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

Qualquer coisa que leia uma configuração JSON (Codex, Cursor, Claude Desktop):

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

A chave vem do seu perfil após o cadastro. O saldo precisa ser financiado: não há plano gratuito nesta API. A chave é lida do ambiente e nunca sai do processo, nenhuma ferramenta a retorna e nenhuma mensagem de erro a cita.

Ferramentas

Ferramenta	O que faz
get_balance	o que resta na conta
list_countries	todos os países com seus ids e operadoras
list_services	encontra o código de um site: busca por nome ou domínio, melhor correspondência primeiro, preço, quantos estão online e a parcela de códigos que realmente chegaram
order_number	solicita um número privado para um serviço em um país
wait_for_code	consulta até o código chegar e o retorna, já extraído do SMS
finish_activation	encerra uma ativação bem-sucedida
cancel_activation	cancela e devolve o dinheiro
request_another_sms	pede mais um código no mesmo número
totp_code	calcula o código autenticador localmente, conforme RFC 6238

list_services responde com matches classificado como melhor primeiro, além de notInList, o serviço alternativo. Ele aceita um nome de site ou uma URL, então discord.com encontra Discord, e classifica uma palavra inteira acima de uma substring, então x coloca X.com (Twitter) acima de Maxim. Os códigos são arbitrários e nunca devem ser lembrados de memória: uk é Airbnb, re é Coinbase, tn é LinkedIn. Quando nada corresponde, a resposta diz isso e aponta para outro país, porque o catálogo não é o mesmo em todos os lugares, e para ot ("Não listado"), que recebe SMS de qualquer remetente que não esteja na lista. Um site que tem seu próprio código envia para esse código, então ot é uma alternativa e não um curinga.

deliveredPercent é a taxa de entrega para aquele serviço e país, e null quando o par ainda não tem estatísticas, que é o caso comum. Onde houver um número, escolha por ele em vez do preço; onde não houver, online mostra o tamanho do pool ao vivo, que é o próximo melhor sinal.

O que o servidor resolve para você

Cada chamada carrega lang. A API responde sem ele, mas então precifica em outra moeda, então o servidor nunca o omite. Marcadores de texto que a API retorna em vez de JSON são verificados antes de qualquer análise e transformados em uma frase sobre a qual um agente pode agir: NO_NUMBERS vira "mude o país, ou defina a operadora como qualquer" em vez de um token puro. A consulta roda em um intervalo sensato em vez de martelar getStatus, e wait_for_code para no tempo de vida de 20 minutos de um número.

O que não é

Receber códigos de verificação é todo o trabalho. Estes números não enviam SMS, não recebem chamadas e não servem para contas bancárias, de pagamento ou governamentais. Um agente que precisa de um número permanente para manter uma conversa quer um produto de operadora.

Configuração

Variável	Padrão
SVN_API_KEY	obrigatório
SVN_API_BASE	https://sms-verification-number.com/stubs/handler_api
SVN_LANG	en, define tanto o idioma quanto a moeda das respostas
SVN_POLL_SECONDS	4

Relacionados

• O mesmo produto como uma skill de markdown: https://github.com/sv-number/skills
• Referência da API: https://sms-verification-number.com/en/api-sms-activate/
• Cobertura e preços: https://sms-verification-number.com/en/number-for-ai-agents/

MIT. O serviço por trás dele é comercial.