Twilio

oficial

Interaja com as APIs do Twilio para enviar mensagens, gerenciar números de telefone, configurar sua conta e muito mais.

GitHub
109

O que você pode fazer com Twilio MCP?

  • Enviar mensagens SMS e WhatsApp — Peça ao seu assistente para compor e enviar mensagens através das APIs de mensagens da Twilio.
  • Fazer e gerenciar chamadas telefônicas — Iniciar chamadas de saída, acompanhar o status da chamada ou modificar chamadas em andamento por meio da Twilio Voice API.
  • Consultar números de telefone — Recuperar informações de operadora e nome do chamador para qualquer número de telefone usando o Twilio Lookup.
  • Comprar e configurar números de telefone — Pesquisar números disponíveis e provisioná-los em sua conta por meio das APIs de números de telefone.
  • Filtrar APIs expostas por serviço — Use os sinalizadores --services e --tags para limitar quais APIs da Twilio estão disponíveis para o assistente, reduzindo o tamanho do contexto.

Documentação

Twilio AlphaTwilio Alpha

Twilio MCP Monorepo

Este é um monorepo para o servidor do Model Context Protocol que expõe todas as APIs da Twilio.

O que é MCP?

O Model Context Protocol (MCP) é um protocolo para troca de informações de contexto de modelo entre ferramentas de IA e serviços. Esta implementação permite expor as APIs da Twilio a assistentes de IA e outras ferramentas que suportam o protocolo MCP.

Pacotes

Este monorepo contém dois pacotes principais:

  • mcp - Servidor MCP para toda a API pública da Twilio
  • openapi-mcp-server - Um servidor MCP que serve a especificação OpenAPI fornecida

Cada pacote possui seu próprio README abrangente com documentação detalhada:

Início Rápido

A maneira mais fácil de começar é usando npx:

{
  "mcpServers": {
    "twilio": {
      "command": "npx",
      "args": [
        "-y",
        "@twilio-alpha/mcp",
        "YOUR_ACCOUNT_SID/YOUR_API_KEY:YOUR_API_SECRET"
      ]
    }
  }
}

Visite a documentação de Chaves de API da Twilio para obter informações sobre como localizar/criar sua Chave de API e Segredo.

Recomendações de Segurança

Para proteção contra ataques de injeção que podem permitir que sistemas não confiáveis acessem seus dados da Twilio, a equipe ETI aconselha os usuários dos servidores MCP da Twilio a evitar instalar ou executar quaisquer servidores MCP da comunidade juntamente com os nossos oficiais. Fazer isso ajuda a garantir que apenas servidores MCP confiáveis tenham acesso a ferramentas que interagem com sua conta Twilio, reduzindo o risco de acesso não autorizado aos dados.

Opções Básicas de Configuração

Ambos os pacotes aceitam parâmetros de configuração. Aqui está uma visão geral breve:

  • Servidor MCP: Use --services e --tags para filtrar quais APIs expor
  • Servidor OpenAPI MCP: Use --apiPath para especificar a localização dos arquivos de especificação OpenAPI

Para detalhes completos de configuração, consulte a documentação específica do pacote vinculada acima.

Desenvolvimento

# Run tests
npm test

# Run linting
npm run lint

# Fix linting issues
npm run lint:fix

Solução de Problemas Comuns

  • Limitações de Tamanho de Contexto: Devido aos limites de contexto dos LLMs, carregue APIs específicas usando --services ou --tags
  • Problemas de Autenticação: Verifique o formato e as permissões das suas credenciais de API da Twilio
  • Versionamento de API: Verifique se você está usando a versão correta da API (v1, v2, v3) para suas necessidades

Para orientações detalhadas sobre solução de problemas, consulte a documentação específica do pacote.

Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request.

Licença

Este projeto está licenciado sob a Licença ISC - veja o arquivo LICENSE para detalhes.