Wavix

oficial

Wavix é uma plataforma global de comunicações que oferece APIs para voz, SMS, 2FA e números de telefone. Nosso servidor MCP traz essas capacidades para agentes de IA e fluxos de trabalho agentivos.

GitHub

O que você pode fazer com Wavix MCP?

Enviar mensagens SMS ou MMS — peça ao assistente para enviar uma mensagem de texto ou mídia usando sms_and_mms_messages_send.
Executar um fluxo de verificação 2FA — faça o assistente criar uma verificação com two_fa_verification_create e verificar o código recebido via two_fa_verification_check.
Pesquisar e comprar números de telefone — encontre números disponíveis por país e capacidade com buy_numbers_list, adicione-os ao carrinho e finalize a compra.
Analisar transcrições de chamadas — pesquise registros de chamadas por frases específicas usando cdrs_search e recupere metadados completos com cdrs_get.
Baixar gravações e transcrições — obtenha a URL de gravação de chamada via call_recording_get, solicite transcrição com cdrs_retranscribe e busque o resultado.
Auditar faturamento e baixar faturas — revise transações com billing_transactions_list e obtenha um link de download de PDF pré-assinado via billing_invoices_download.

Documentação

Servidor MCP Wavix

Um servidor Model Context Protocol que oferece a LLMs e agentes de IA acesso direto à plataforma de telecomunicações Wavix — SMS/MMS, chamadas de voz, 2FA, troncos SIP, gerenciamento de números de telefone, registro 10DLC, gravações de chamadas, análise de fala e faturamento.

Wavix é uma plataforma global de comunicações para enviar SMS, realizar chamadas de voz e executar fluxos de 2FA através de uma única API. Um teste gratuito está disponível; o uso pago segue o plano de preços da Wavix vinculado à sua conta.

A maneira mais rápida de usar este servidor MCP é o endpoint hospedado em https://mcp.wavix.com/mcp — aponte qualquer cliente compatível com MCP para ele e autentique-se com sua chave de API Wavix. Se você precisar de auto-hospedagem (implantação Wavix personalizada, atrás de um firewall, instância dedicada), consulte Execute o seu próprio.

Índice

Endpoint
Instalar — um clique, Claude Code, Claude Desktop / Web, Cursor, VS Code, Codex CLI, Windsurf
Execute o seu próprio (auto-hospedagem)
Exemplos
Ferramentas → catálogo completo em TOOLS.md
Recursos
Autenticação (melhores práticas, se um token for comprometido)
Solução de problemas
Compatibilidade e limites
Suporte, Contribuindo, Segurança, Licença

Endpoint

Campo	Valor
URL	`https://mcp.wavix.com/mcp`
Transporte	HTTP Transmissível
Autenticação	`Authorization: Bearer <api_key>`
Ferramentas	veja TOOLS.md
Recursos	Documentação Wavix + especificação OpenAPI (descoberta automática)

Obtenha uma chave de API Wavix no Console Wavix → Administração → Chaves de API → Criar nova.

Instalar

Antes de começar: obtenha sua chave de API Wavix.

Faça login em https://wavix.com.
Abra Administração → Chaves de API.
Clique em Criar nova (ou copie uma chave existente). Mantenha-a à mão — você a colará no lugar de YOUR_API_KEY abaixo.

Instalação com um clique

⚠️ Os botões abaixo preenchem a configuração MCP do seu editor com um token placeholder YOUR_API_KEY. Após o editor terminar a instalação, abra a configuração gerada e substitua o placeholder pela sua chave de API real antes de enviar qualquer requisição — caso contrário, cada chamada retornará 401 Unauthorized.

Para remover posteriormente: abra o mesmo arquivo de configuração (~/.cursor/mcp.json, .vscode/mcp.json, ou o equivalente para o seu editor) e exclua a entrada wavix, ou remova o conector através da interface MCP / Conectores do seu editor.

Claude Code

claude mcp add --transport http wavix https://mcp.wavix.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Use claude mcp list para verificar e /mcp dentro de uma sessão para ver o status.

Claude Desktop / Claude Web

Configurações → Conectores → Adicionar conector personalizado:

Nome: Wavix
URL: https://mcp.wavix.com/mcp
Transporte: Streamable HTTP
Cabeçalho de autenticação: Authorization: Bearer <api_key>

Cursor (manual)

Adicione ao ~/.cursor/mcp.json (ou ao .cursor/mcp.json no nível do projeto):

{
  "mcpServers": {
    "wavix": {
      "url": "https://mcp.wavix.com/mcp",
      "headers": {
        "Authorization": "Bearer <api_key>"
      }
    }
  }
}

Cursor 2.4+ expõe o catálogo completo; versões anteriores limitam a 40.

VS Code (manual, GitHub Copilot Chat)

Crie .vscode/mcp.json no seu espaço de trabalho (ou adicione o mesmo objeto servers sob a chave "mcp" no settings.json do usuário):

{
  "servers": {
    "wavix": {
      "type": "http",
      "url": "https://mcp.wavix.com/mcp",
      "headers": {
        "Authorization": "Bearer <api_key>"
      }
    }
  }
}

Consulte o guia de servidores MCP do VS Code para o esquema atualizado.

Codex CLI

Codex CLI suporta MCP sobre stdio. Faça a ponte para o servidor hospedado via mcp-remote. Edite ~/.codex/config.toml:

[mcp_servers.wavix]
command = "npx"
args = [
  "-y",
  "mcp-remote",
  "https://mcp.wavix.com/mcp",
  "--header",
  "Authorization:Bearer ${WAVIX_API_KEY}"
]

[mcp_servers.wavix.env]
WAVIX_API_KEY = "YOUR_API_KEY"

Windsurf / outros clientes

Qualquer cliente MCP que suporte transporte HTTP Transmissível com cabeçalhos personalizados funcionará. Use:

URL: https://mcp.wavix.com/mcp
Cabeçalho: Authorization: Bearer <api_key>

Configurando através de um agente de IA? Aponte seu agente para llms-install.md — é um guia de instalação legível por máquina que fornece ao modelo a URL, o cabeçalho e a configuração por cliente em um formato determinístico para que ele não improvise valores de endpoint.

Execute o seu próprio

O servidor hospedado funciona imediatamente para a maioria dos usuários. Auto-hospede se precisar apontar para uma implantação Wavix não pública, executar atrás de um firewall ou operar dentro da sua própria infraestrutura.

Docker

docker build -t wavix-mcp-server .
docker run --rm -p 8000:8000 wavix-mcp-server

O servidor escuta na porta 8000 e expõe o endpoint MCP em /mcp. Aponte seu cliente para http://<host>:8000/mcp.

A partir do código fonte

git clone https://github.com/Wavix/wavix-mcp-server.git
cd wavix-mcp-server
pip install -e .
wavix-mcp

Requer Python 3.10+.

Configuração

Variável de ambiente	Padrão	Finalidade
`WAVIX_API_BASE_URL`	`https://api.wavix.com`	Substitui o endpoint upstream da API Wavix (para implantações internas ou staging)

Nenhuma credencial Wavix é necessária para executar o servidor — elas são encaminhadas por requisição a partir do cabeçalho Authorization: Bearer <api_key> do cliente MCP. Os auto-hospedeiros são responsáveis por terminar o TLS na frente do servidor (nginx, Caddy, balanceador de carga na nuvem) antes de expô-lo publicamente.

Exemplos

Prompts concretos que você pode inserir em qualquer cliente conectado.

Os números de telefone abaixo (+1 310 555 0100, +44 7700 900123) estão em intervalos de teste reservados (NANP 555 e Ofcom 070 09xx) — seguros para copiar literalmente, nenhum assinante real pode ser alcançado através deles.

Enviar um SMS transacional

Prompt: "Envie um SMS de +13105550100 para +447700900123 dizendo 'Seu código de verificação é 4821'."

O agente chama sms_and_mms_messages_send com from, to e text. Retorna o ID da mensagem e o status de entrega.

Executar uma verificação 2FA

Prompt: "Envie um código de verificação 2FA para +13105550100 via SMS. Quando eu fornecer o código que recebi, verifique se está correto."

O agente chama two_fa_verification_create, aguarda você compartilhar o código que chega via SMS e então chama two_fa_verification_check. Útil para prototipar fluxos sem senha sem escrever código de integração.

Encontrar e comprar um número de telefone

Prompt: "Encontre um número gratuito dos EUA disponível com capacidade de SMS, adicione-o ao meu carrinho e finalize a compra."

O agente encadeia buy_numbers_list (filtrando por país e recurso), cart_add e cart_checkout. Confirme com o usuário antes de finalizar a compra — isso cobra da conta.

Pesquisar transcrições de chamadas

Prompt: "Mostre-me todas as chamadas recebidas de ontem com mais de dois minutos em que o chamador mencionou 'reembolso'."

O agente usa cdrs_search nas transcrições e então enriquece cada resultado via cdrs_get para obter metadados completos da chamada.

Obter uma gravação e transcrevê-la

Prompt: "Obtenha a gravação da chamada abc-123, peça à Wavix para transcrevê-la e retorne a transcrição."

O agente chama call_recording_get (retorna uma URL de download pré-assinada), cdrs_retranscribe e então consulta cdrs_transcription_get.

Auditar faturamento

Prompt: "Quanto gastamos em SMS no mês passado? Dê-me um link de download para a fatura em PDF mais recente."

O agente chama billing_transactions_list filtrado por tipo e data, e então billing_invoices_list + billing_invoices_download. A ferramenta de download retorna uma URL pré-assinada para o PDF, não o arquivo em si — abra a URL em um navegador ou passe-a para o seu cliente buscar o documento real.

Ferramentas

122 ferramentas, geradas a partir da especificação OpenAPI da Wavix. Os argumentos espelham os parâmetros da requisição e os campos do corpo.

Grupo	#	Cobertura
SMS e MMS	10	Enviar, listar, recuperar mensagens; IDs de remetente; opt-outs
Controle de chamadas	9	Iniciar / atender / encerrar chamadas; reproduzir áudio; coletar DTMF
Gravação de chamadas	3	Listar, baixar (URL pré-assinada), excluir
Streaming de chamadas	2	Iniciar / parar fluxo de mídia
Webhooks de chamadas	3	Listar, criar, excluir
CDRs	6	Listar, exportar, recuperar; pesquisa de transcrição e retranscrição
Análise de Fala	4	Enviar, transcrever, recuperar arquivo original
2FA	6	Criar / verificar / cancelar / reenviar verificação; eventos
Meus números	7	Listar, atualizar, liberar; roteamento de SMS / voz; upload de documentos
Comprar	5	Países, regiões, cidades; pesquisa de números disponíveis
Carrinho	4	Adicionar, remover, recuperar, finalizar compra
Validador de números	3	Validação única e em lote
Troncos SIP	5	CRUD completo
10DLC	30	Marcas, campanhas, verificação, evidências, assinaturas de eventos
Perfil	3	Obter / atualizar perfil; configuração da conta
Chaves de API	5	Listar, criar, ativar / desativar, excluir
Subcontas	5	Listar, criar, obter, atualizar; transações
Faturamento	3	Transações, faturas, download de extrato
Campanhas de voz	2	Disparar e recuperar
Wavix Embeddable (WebRTC)	5	CRUD de tokens de widget
Encurtador de links	2	Criar links curtos; métricas

Veja TOOLS.md para a lista completa de ferramentas com descrições de uma linha. A fonte autoritativa é a especificação OpenAPI da Wavix — seu cliente sempre vê o catálogo atual ao vivo.

Recursos

Além das ferramentas, o servidor expõe a documentação da Wavix como Recursos MCP, para que o modelo possa obter contexto autoritativo sob demanda, em vez de adivinhar com base em conhecimento prévio.

Esquema de URI	Conteúdo
`wavix://docs/<path>`	Páginas de documentação de docs.wavix.com (descobertas automaticamente via `llms.txt`).
`wavix://api/openapi.yaml`	A especificação OpenAPI 3.0 completa da Wavix.

Ambas as fontes — docs.wavix.com e a especificação OpenAPI da Wavix — estão publicamente disponíveis e podem ser navegadas diretamente sem autenticação.

Os recursos são buscados sob demanda em resources/read e armazenados em cache no lado do servidor com um TTL de 1 hora. O token Bearer upstream nunca é encaminhado para hosts de documentação — apenas para api.wavix.com.

Autenticação

Cada requisição do cliente deve incluir:

Authorization: Bearer <api_key>

O servidor encaminha este cabeçalho para api.wavix.com por requisição. O token:

nunca é registrado em log,
nunca é encaminhado em redirecionamentos entre hosts (por exemplo, URLs de download S3 pré-assinadas),
nunca é enviado para hosts de documentação.

Se o seu cliente seguir uma URL de download pré-assinada retornada por call_recording_get, billing_invoices_download, speech_analytics_file_get ou ten_dlc_brand_evidence_get, busque-a diretamente sem o cabeçalho Authorization.

Melhores práticas

Use uma chave de API dedicada para MCP. Crie uma chave de API separada em https://wavix.com → Administração → Chaves de API (ou através da própria ferramenta api_keys_create, de outra sessão). Isso permite revogar o acesso MCP sem interromper outras integrações.
Rotacione periodicamente. Trate a chave de API como qualquer segredo de produção: rotacione conforme cronograma e diante de qualquer suspeita de vazamento.
Mantenha as chaves de API fora do git. As configurações do cliente MCP são fáceis de comitar acidentalmente, levando o token junto para o histórico e logs de CI. A maioria dos clientes suporta substituição de ${env:VAR} no valor do cabeçalho — armazene a chave de API em uma variável de ambiente ou no chaveiro do seu sistema operacional e faça referência a ela na configuração. Como rede de segurança, adicione os caminhos comuns de configuração do cliente ao .gitignore do seu projeto:
```
.cursor/mcp.json
.vscode/mcp.json
claude_desktop_config.json
.claude/mcp.json
.codex/config.toml
```

Se um token for comprometido

No Console do Wavix, desative a chave imediatamente (ou chame api_keys_deactivate).
Crie uma substituição via api_keys_create ou pelo Console.
Atualize a configuração do cliente e reconecte.
Revise billing_transactions_list e cdrs_list em busca de atividades inesperadas.

Solução de problemas

Sintoma	Causa provável / solução
`401 Unauthorized` de qualquer ferramenta	Cabeçalho `Authorization: Bearer …` ausente ou inválido. Verifique se a chave da API está ativa no Console do Wavix.
A ferramenta retorna um `download_url`, não o arquivo em si	Comportamento esperado. Os endpoints de gravação, fatura, análise de fala e evidência 10DLC retornam URLs pré-assinadas (consulte Autenticação). Busque a URL diretamente sem o cabeçalho `Authorization`.
O cliente mostra apenas ~40 ferramentas, não o catálogo completo	Clientes mais antigos impõem um limite de ferramentas por servidor. Atualize (Cursor 2.4+, VS Code mais recente, Claude mais recente).
`Tool not found` para uma ferramenta listada neste README	O cliente local pode estar armazenando em cache uma lista de ferramentas antiga. Reinicie o cliente ou remova e adicione novamente o servidor.
4xx com um array `errors`	Erro de validação da API do Wavix. Inspecione `errors`; faça referência cruzada com a página `wavix://docs/*` relevante ou com a especificação OpenAPI.
Não é possível acessar o servidor	Confirme o DNS e o HTTPS de saída para `mcp.wavix.com:443`.
O agente chama uma ferramenta destrutiva inesperadamente	A maioria dos clientes pode exigir confirmação antes de chamadas de ferramenta — habilite essa configuração e faça a rotação para uma chave de API MCP dedicada (consulte Boas práticas).

Compatibilidade e limites

Compatível com qualquer cliente MCP que suporte transporte HTTP Transmissível (Claude Desktop / Web / Code, Cursor 2.4+, VS Code, Windsurf, SDKs MCP personalizados) e qualquer framework de agente com um adaptador de cliente MCP.
Clientes mais antigos podem impor um limite de ferramentas por servidor; atualize para uma versão recente para acessar o catálogo completo.
Limites de taxa e cobranças de uso seguem o plano da sua conta Wavix. Consulte Preços do Wavix.

Registro de alterações

O servidor hospedado é atualizado continuamente à medida que a especificação OpenAPI do Wavix evolui; novas ferramentas aparecem automaticamente e os argumentos das ferramentas existentes podem ganhar campos opcionais. As alterações na documentação deste repositório são rastreadas em Versões. Para mudanças substanciais de comportamento que afetem entradas de ferramentas ou autenticação, publicaremos um aviso tanto lá quanto nas notas de versão do Wavix.

Suporte

Documentação do produto: https://docs.wavix.com
Referência da API: https://docs.wavix.com/api-reference
Dúvidas / feedback: support@wavix.com

Contribuição

Este repositório é de código-fonte disponível, mas não está aberto a contribuições externas. Pull requests são fechados automaticamente, e Issues / Discussões estão desabilitados. Envie relatórios de bugs, solicitações de recursos e feedback para support@wavix.com. Consulte CONTRIBUTING.md para obter detalhes.

Se você encontrar um bug no framework subjacente FastMCP, relate-o diretamente no repositório upstream.

Segurança

Para relatar uma vulnerabilidade de segurança, envie um e-mail para support@wavix.com com o assunto Security: <short summary> em vez de abrir uma issue pública. Consulte SECURITY.md para obter detalhes.