io.github.codespar/mcp-twilio
io.github.codespar/mcp-twilio · 273 stars · TypeScript · MIT
MCP server MCP server for Twilio — global SMS, WhatsApp, Voice, Verify, and Lookup across 180+ countries
Install
The repo has no one-line install. Follow its README.
Published as
- npm
@codespar/mcp-twiliostdio
From the server's entry in the official MCP Registry.
Configuration
| Name | Set as | What it is |
|---|---|---|
TWILIO_ACCOUNT_SIDRequired | Env var | Twilio Account SID (starts with AC...). Used as username for HTTP Basic auth. |
TWILIO_AUTH_TOKENRequired · Secret | Env var | Twilio Auth Token. Used as password for HTTP Basic auth. |
TWILIO_MESSAGING_SERVICE_SIDOptional | Env var | Optional default Messaging Service SID (starts with MG...) used for send_message when From is omitted. |
Files
@codespar/mcp-twilio
MCP server for Twilio — the global standard for programmable messaging and voice.
SMS, WhatsApp, and Voice across 180+ countries. Verify (2FA) and Lookup (phone validation) included. Fills the global messaging gap in a catalog otherwise tilted to Brazil-specific providers (Z-API, Take Blip, Zenvia, Evolution API).
Tools (22)
| Tool | Purpose |
|---|---|
send_message |
Send an SMS or WhatsApp message. |
get_message |
Retrieve a message resource by SID (SM... |
list_messages |
List messages with optional filters. |
delete_message |
Delete a message from history. |
make_call |
Place an outbound voice call. |
get_call |
Retrieve a call resource by SID (CA...). |
update_call |
Modify an in-progress call. |
start_verification |
Start a Verify (2FA) challenge. |
check_verification |
Check a Verify (2FA) code against a Service SID. |
lookup_phone |
Validate and normalize a phone number via Lookups v2. |
list_incoming_numbers |
List Twilio-provisioned phone numbers on this account. |
buy_phone_number |
Provision a new phone number. |
list_recordings |
List call recordings on this account. |
create_verify_service |
Create a Verify Service (VA...). |
create_conversation |
Create a Twilio Conversation. |
list_conversations |
List Conversations. |
add_conversation_participant |
Add a participant to a Conversation. |
send_conversation_message |
Post a message into a Conversation. |
list_messaging_services |
List Messaging Services (MG...). |
execute_studio_flow |
Trigger a Studio Flow Execution for a contact. |
create_taskrouter_task |
Create a TaskRouter Task on a Workspace. |
list_taskrouter_workers |
List Workers on a TaskRouter Workspace. |
Install
npm install @codespar/mcp-twilio
Environment
TWILIO_ACCOUNT_SID="AC..." # required TWILIO_AUTH_TOKEN="..." # required (secret) TWILIO_MESSAGING_SERVICE_SID="MG..." # optional; default sender for send_message
Authentication
HTTP Basic auth with AccountSid:AuthToken. The server handles this automatically — you only configure the env vars.
Authorization: Basic <base64(AccountSid:AuthToken)>
API surface
- Main Accounts API:
https://api.twilio.com/2010-04-01/Accounts/{AccountSid}— Messages, Calls, IncomingPhoneNumbers - Verify API:
https://verify.twilio.com/v2— 2FA flows (requires a Verify Service SID passed per call) - Lookups API:
https://lookups.twilio.com/v2— phone number validation / carrier / line type
Request bodies are application/x-www-form-urlencoded; responses are JSON (endpoints use the .json suffix on the Accounts API).
Use the same send_message tool, but prefix numbers with whatsapp::
{ "To": "whatsapp:+5511999999999", "From": "whatsapp:+14155238886", "Body": "Olá" }
Sandbox numbers or approved WhatsApp-enabled senders work the same way.
Run
# stdio (default — for Claude Desktop, Cursor, etc) npx @codespar/mcp-twilio # HTTP (for server-to-server testing) MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-twilio
Enterprise
Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.
License
MIT
Facts
- Kind
- MCP server
- Group
- Uncategorized
- Stars
- 273
- License
- MIT
- Language
- TypeScript
- Last push
- 2026-09-27
- Forks
- 50
- MCP Registry
- io.github.codespar/mcp-twilio
- Homepage
- codespar.dev/servers
- Topics
- agentic-commerce, ai-agents, brazil, claude, fintech, latin-america, llm-tools, mcp, model-context-protocol, nfe, open-finance, payments, pix
- 1REAio.github.morluto/reaReverse engineer anything from your terminal or agent with one CLI and MCP server.125.3k
- 2com.browser-use/browser-usecom.browser-use/browser-useControl a real Chrome browser to complete any task: fill forms, extract data, book flights.117.7k
- 3World Monitorapp.worldmonitor/mcpLive markets, conflicts, country risk, chokepoints, energy, and China decision signals. 93 tools.88.3k
- 4Scrapling MCP Serverd4vinci/scrapling🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scraplingdev86.9k
- 5Everythingmodelcontextprotocol/serversThis MCP server attempts to exercise all the features of the MCP protocol. It is not intended to be a useful server, but rather a test server for builders of MCP clients. It implements prompts, tools, resources, sampling, and more to showcase MCP capabilities.85.8k
- 6Fetchmodelcontextprotocol/serversA Model Context Protocol server that provides web content fetching capabilities. This server enables LLMs to retrieve and process content from web pages, converting HTML to markdown for easier consumption.85.8k