twilio-mcp-server

Twilio MCP

Um servidor MCP para comunicações Twilio. Envie mensagens SMS, MMS e WhatsApp. Faça chamadas de voz. Gerencie números de telefone.

O que ele faz

Conecte sua conta Twilio a qualquer cliente MCP. Envie mensagens de texto, compartilhe imagens, faça chamadas telefônicas e gerencie seus números de telefone por meio de linguagem natural.

Ferramentas

• send_sms. Envie uma mensagem de texto SMS.
• send_mms. Envie uma mensagem MMS com uma imagem ou arquivo de mídia.
• send_whatsapp. Envie uma mensagem WhatsApp.
• get_message_status. Verifique o status de entrega de uma mensagem enviada.
• list_messages. Veja o histórico recente de mensagens com filtros.
• make_call. Inicie uma chamada de voz com controle TwiML.
• list_calls. Veja o histórico recente de chamadas.
• list_numbers. Liste seus números de telefone Twilio.
• search_numbers. Pesquise números de telefone disponíveis por código de área.

Autenticação

Defina estas variáveis de ambiente:

export TWILIO_ACCOUNT_SID="ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
export TWILIO_AUTH_TOKEN="your-auth-token"

Encontre-as no painel da sua conta Twilio Console.

Instalação

npx twilio-mcp

Configuração do Claude Desktop

{
  "mcpServers": {
    "twilio": {
      "command": "npx",
      "args": ["-y", "twilio-mcp"],
      "env": {
        "TWILIO_ACCOUNT_SID": "ACxxxxxxxx",
        "TWILIO_AUTH_TOKEN": "your-token"
      }
    }
  }
}

Exemplo de uso

Pergunte ao Claude:

"Envie um SMS para +14155551234 dizendo 'Olá do Claude' do meu número Twilio"

"Envie uma mensagem WhatsApp para +14155551234 com esta imagem anexada"

"Qual é o status de entrega da mensagem SM1234567890?"

"Liste minhas mensagens recentes do último dia"

"Ligue para +14155551234 e toque uma mensagem usando esta URL TwiML"

"Liste meus números de telefone Twilio"

"Procure números de telefone disponíveis no código de área 415"

Chamadas de voz

Para fazer chamadas, você precisa de uma URL TwiML que controle o fluxo da chamada. Você pode usar o TwiML Bin no Twilio Console ou hospedar seu próprio TwiML. Exemplo de TwiML:

<?xml version="1.0" encoding="UTF-8"?>
<Response>
  <Say voice="alice">Hello, this is a call from your AI assistant.</Say>
</Response>

Licença

MIT