Skip to main content
TW

Twilio

v0.2.1API Key

SMS + WhatsApp + Voz + 2FA Verify + Lookup de telefone global em mais de 180 países. Preenche o vazio global na categoria de mensageria (todas as outras entradas são BR-específicas).

22 ferramentas3 env vars🌐 GLOBALestável no npm

O que seu agente faz

O Twilio dá ao seu agente 22 tools que ele chama direto — escolha as que precisar, no Claude, Cursor ou qualquer cliente MCP.

  • send_messageSend an SMS or WhatsApp message. For WhatsApp, prefix `To` (and `From`) with `whatsapp:+E164`. Supply either `From` (a Twilio phone number) OR `MessagingServiceSid` (a Messaging Service). If neither is given, falls back to env TWILIO_MESSAGING_SERVICE_SID.
  • get_messageRetrieve a message resource by SID (SM... or MM...).
  • list_messagesList messages with optional filters. Returns Twilio's paginated list; pass PageSize to cap.
Exemplo de chamada
// Your agent calls a tool directly — no glue code.
// CodeSpar's managed tier handles OAuth2, token rotation and rate limits.
const result = await session.call("send_message", { /* ... */ });

Instalar

terminal
$ npm install @codespar/mcp-twilio

Quickstart

Adicione esta entrada ao seu claude_desktop_config.json (ou a config de qualquer cliente compatível com MCP).

claude_desktop_config.json
{
  "mcpServers": {
    "twilio": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-twilio"
      ],
      "env": {
        "TWILIO_ACCOUNT_SID": "<your_twilio_account_sid>",
        "TWILIO_AUTH_TOKEN": "<your_twilio_auth_token>"
      }
    }
  }
}

Depois de reiniciar, seu agente pode chamar qualquer uma das 22 ferramentas abaixo — teste send_message primeiro.

Variáveis de ambiente · 3

Necessárias pra autenticar o server. Armazenadas criptografadas ao usar a hospedagem gerenciada da CodeSpar.

TWILIO_ACCOUNT_SID
obrigatório

Twilio Account SID (starts with AC...). Used as username for HTTP Basic auth.

TWILIO_AUTH_TOKEN
obrigatóriosecret

Twilio Auth Token. Used as password for HTTP Basic auth.

TWILIO_MESSAGING_SERVICE_SID
opcional

Optional default Messaging Service SID (starts with MG...) used for send_message when From is omitted.

Ferramentas disponíveis · 22

Cada ferramenta é independente — seu agente carrega só o que precisa pra reduzir contexto e tempo de resposta.

WRITEsend_message
Send an SMS or WhatsApp message. For WhatsApp, prefix `To` (and `From`) with `whatsapp:+E164`. Supply either `From` (a Twilio phone number) OR `MessagingServiceSid` (a Messaging Service). If neither is given, falls back to env TWILIO_MESSAGING_SERVICE_SID.
READget_message
Retrieve a message resource by SID (SM... or MM...).
READlist_messages
List messages with optional filters. Returns Twilio's paginated list; pass PageSize to cap.
DELETEdelete_message
Delete a message from history. Irreversible.
READmake_call
Place an outbound voice call. Twilio fetches TwiML from `Url` on connect to drive the call.
READget_call
Retrieve a call resource by SID (CA...).
WRITEupdate_call
Modify an in-progress call. Set Status='completed' to hang up, or pass a new Url to redirect the call to fresh TwiML.
READstart_verification
Start a Verify (2FA) challenge. Sends a one-time code to `To` via the chosen channel. Requires a Verify Service SID (VA...).

Frameworks compatíveis

MCP é um protocolo — qualquer framework que o fale pode montar este server.

Claude Agent SDKAnthropic
OpenAI AgentsOpenAI
Vercel AI SDKVercel
LangChainLangChain
LlamaIndexLlamaIndex
CrewAICrewAI
MastraMastra
Qualquer cliente MCPProtocolo

Perguntas frequentes

Rode `npx -y @codespar/mcp-twilio` e adicione o bloco de config acima ao seu cliente MCP — Claude, Cursor, VS Code ou qualquer cliente compatível com MCP. Sem build, sem SDK. Prefere hospedado? O tier gerenciado da CodeSpar roda pra você, com a auth resolvida.
Twilio — MCP server · 22 tools | CodeSpar