Atualização do servidor MCP da Vonage: relatórios, Numbers e gráficos

As ligações da API do servidor MCP da Vonage permitem que assistentes de IA utilizem as APIs da Vonage por meio do Protocolo de Contexto de Modelo (MCP). Desde dezembro de 2025, as versões 1.3.0 a 1.5.1 trouxeram três lançamentos com novas funcionalidades. Adicionamos recursos de geração de relatórios, gerenciamento de números, criação de Applications e geração de gráficos.

Agora você pode extrair dados da Reports API, pesquisar e provisionar números de telefone, criar Applications e transformar dados de relatórios em gráficos, tudo diretamente do seu assistente de IA. Esta publicação apresenta as novidades desde dezembro de 2025.

Se você ainda não configurou o servidor, consulte nossa publicação anterior, “Passo a passo: como adicionar APIs da Vonage ao seu agente de IA com o MCP”, para conhecer os conceitos básicos.

Por que essas atualizações são importantes

Essas novidades permitem que você conclua mais fluxos de trabalho da Vonage sem precisar alternar entre seu assistente de IA, o Painel da API da Vonage e scripts personalizados. Agora, você pode analisar a atividade de comunicação, localizar e configurar números, criar Applications e visualizar dados de relatórios em uma única conversa.

Criação de aplicativos

A versão 1.3.0 adicionou uma ferramenta de criação de Applications, para que você possa criar um novo Application da Vonage pelo nome sem sair da janela de bate-papo:

Can you create a new Vonage application called "My Chat App"?

Ou, se você não se importar com o nome, basta pedir ao assistente para criar um e deixar que ele sugira algo.

Acesso à Reports API

A versão 1.4.0 introduziu o comando `get-records-report`, que extrai registros de atividades da Reports API. É possível fazer consultas por intervalo de datas ou por um ID de registro específico:

Can you get a report of all outbound SMS sent over the last week?

Can you get the report for Voice Call ID 1234-abcd-5678-efgh?

Se você quiser ver como o get-records-report está por trás de uma interface de usuário totalmente interativa, confira o artigo “Crie um painel de relatórios no Claude Desktop com o MCP Apps e a Vonage”. Ele aborda a criação de um painel de relatórios em tempo real para SMS e chamadas de voz, que é exibido diretamente no Claude.

Pesquisa e provisionamento de números Pesquisa e provisionamento de números

Ainda na versão 1.4.0, duas novas ferramentas completam o gerenciamento de números:

• search-available-numbers — pesquisa de números disponíveis para compra por país, com filtros opcionais para recursos (SMS, Voice) ou um padrão de número

• link-number-to-vonage-application — vincule um número de sua propriedade a uma aplicação específica da Vonage

Juntamente com a ferramenta existente de Numbers adquiridos por lista, você pode passar de “o que eu tenho” para “o que está disponível” e, por fim, para “associar esse número ao meu aplicativo” em uma única conversa:

Can you search for available Vonage numbers in the US with SMS and VOICE features?

Can you search for available numbers in GB starting with pattern "44207*"?

Geração de gráficos

A versão 1.5.0 adicionou o comando `make-chart`, que utiliza dados já recuperados — como uma consulta à Reports API — e os exibe na forma de um gráfico:

Please create a chart showing all the outbound SMS sent over the last week.

A ferramenta “make-chart” foi desenvolvida por um colaborador iniciante, o que é um bom sinal para um projeto de código aberto e um bom lembrete de que o repositório aceita pull requests. Confira como contribuir para o Servidor de Ferramentas MCP da Vonage de código aberto.

Confiabilidade e Organização

As versões 1.5.0 e 1.5.1 também incluíram algumas correções que vale a pena conhecer:

• Correção do problema de failover do WhatsApp: whatsapp-send-text estava acionando incorretamente o failover por SMS. Isso foi corrigido — o failover ainda está disponível explicitamente por meio do comando `whatsapp-send-text-with-sms`.

• Tratamento de erros: list-applications e list-purchased-numbers agora tratem e exibam os erros adequadamente, em vez de falharem silenciosamente.

• Agente de usuário personalizado: as solicitações enviadas pelo servidor agora incluem um agente de usuário distinto, de modo que o tráfego gerado pelo MCP pode ser identificado em nossos logs separadamente do restante do tráfego da API.

• Atualização de dependências: @vonage/server-sdk atualizado para a versão 3.26.0.

• Correção de um problema na importação: A versão 1.5.1 corrigiu um problema na importação que estava presente na versão 1.5.0. Se você estiver usando a versão 1.5.0, atualize para a 1.5.1.

Comece hoje mesmo

Atualize sua configuração do MCP para baixar a versão mais recente:

{ 
  "vonage-mcp-server-api-bindings": { 
    "type": "stdio", 
    "command": "npx", 
    "args": [ 
      "-y", 
      "@vonage/vonage-mcp-server-api-bindings" 
    ], 
    "env": { 
      "VONAGE_APPLICATION_ID": "<YOUR_VONAGE_APPLICATION_ID>", 
      "VONAGE_PRIVATE_KEY64": "<YOUR_VONAGE_PRIVATE_KEY64>", 
      "VONAGE_API_KEY": "<YOUR_VONAGE_API_KEY>", 
      "VONAGE_API_SECRET": "<YOUR_VONAGE_API_SECRET>", 
      "VONAGE_VIRTUAL_NUMBER": "<YOUR_VONAGE_VIRTUAL_NUMBER>", 
      "VONAGE_WHATSAPP_NUMBER": "<YOUR_VONAGE_WHATSAPP_NUMBER>", 
      "RCS_SENDER_ID": "<YOUR_RCS_SENDER_ID>" 
    } 
  } 
} 

Como a configuração é executada pelo npx, basta reiniciar seu cliente MCP para obter a versão mais recente.

Conclusão