numero-virtual-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| NUMERO_VIRTUAL_API_KEY | Yes | Sua chave de API do Número Virtual. Começa com nv_live_ e é obtida em app.numero-virtual.com → Desenvolvedores → Nova chave. | |
| NUMERO_VIRTUAL_API_URL | No | URL base da API v1 do Número Virtual. | https://app.numero-virtual.com/api/v1 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_balanceA | Saldo atual da conta no Numero Virtual, em reais (BRL). Toda compra de numero desconta daqui. |
| list_countriesA | Lista os paises com numeros em estoque e quantos servicos cada um tem. Use o campo "code" (ISO, ex.: BR, US) nas outras ferramentas. Limite: 6 consultas por minuto; o resultado muda pouco, entao guarde-o. |
| list_servicesA | Servicos (WhatsApp, Telegram, Google...) com estoque em um pais, do mais barato ao mais caro, com preco em centavos de BRL e as opcoes (fornecedores) de cada um. O "serviceId" e o "apiId" daqui sao os que vao em request_number. Use "search" para achar um servico pelo nome (a lista completa do Brasil tem ~700 itens). Limite: 6 consultas por minuto. |
| request_numberA | Compra um numero virtual para receber o SMS de verificacao de um servico. Debita o saldo na hora. Devolve o id da ativacao e o telefone; depois use wait_for_sms (ou get_activation) para ler o codigo. O numero vale ~20 minutos; se o SMS nao vier, cancele com cancel_activation para o valor voltar ao saldo. |
| get_activationA | Situacao atual de uma ativacao: status (waiting_sms, sms_received, cancelled, expired), telefone, codigo e texto do SMS quando ja chegou. Consulte a cada 5-10 s; prefira wait_for_sms. |
| wait_for_smsA | Fica consultando a ativacao a cada 5 s ate o codigo chegar ou o tempo acabar (padrao 60 s, maximo 300). Devolve a ativacao com "codigo_chegou" true/false. Se nao chegou, chame de novo (o numero vale ~20 min) ou use resend_sms / cancel_activation. |
| cancel_activationA | Cancela uma ativacao que ainda nao recebeu SMS e devolve o valor ao saldo. Nao funciona depois que o codigo chegou. |
| complete_activationA | Marca a ativacao como concluida depois de usar o codigo. Opcional, mas libera o numero mais cedo. |
| resend_smsA | Pede ao fornecedor um novo SMS para a mesma ativacao (quando o servico permite reenviar o codigo). Use se o primeiro nao chegou. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 9 tools
Each tool targets a distinct action in the number-rental lifecycle (browse, buy, poll, resend, cancel, complete). The only notable overlap is get_activation vs wait_for_sms, but the descriptions explicitly state that wait_for_sms is preferred, which mitigates confusion.
All nine tools follow a consistent snake_case verb_noun pattern (get_balance, list_countries, request_number, cancel_activation, etc.). No mixing of conventions or vague verbs.
Nine tools is well-scoped for the domain, covering browsing, purchasing, and activation lifecycle management without redundancy or filler.
The surface covers the full lifecycle: balance, country/service discovery, number purchase, SMS polling, resend, cancel, and completion. Minor gap: no way to list past/active activations in bulk, only single-activation lookup via get_activation.