关于 mcp-twilio
mcp-twilio 是 Twilio 的 MCP 服务，提供覆盖 180 多个国家的短信、WhatsApp、语音、Verify（双因素验证）和 Lookup（号码校验）能力。它面向需要全球消息与语音触达的开发者和 Agent。项目还补充了目录中以巴西服务商为主的全球通信类服务。
主要功能
- 01发送短信与 WhatsApp 消息，并查询消息记录
- 02发起、查询和更新语音通话
- 03启动并校验 Verify 双因素验证码
- 04通过 Lookups v2 校验并规范化电话号码
- 05管理 Conversations、Studio Flow 与 TaskRouter 相关资源
适用场景
- 01向全球用户发送短信或 WhatsApp 通知
- 02在注册或登录流程中发送并校验一次性验证码
- 03通过号码校验工具清理或验证用户的电话号码
MCP 相关
该项目是 MCP 服务，向 MCP 客户端暴露 22 个工具，用于调用 Twilio 的 Accounts、Verify 与 Lookups 等 API。
配置
本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。
npx -y @codespar/mcp-twilioTWILIO_ACCOUNT_SIDTwilio Account SID (starts with AC...). Used as username for HTTP Basic auth.TWILIO_AUTH_TOKEN密钥Twilio Auth Token. Used as password for HTTP Basic auth.TWILIO_MESSAGING_SERVICE_SIDOptional default Messaging Service SID (starts with MG...) used for send_message when From is omitted.本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。
工具
22收录的工具列表 · 更新于 2 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| To | string | 是 | E.164 格式的目标号码（例如 +5511999999999），或 WhatsApp 使用的 `whatsapp:+E164` |
| Body | string | 是 | 消息文本（UTF-8） |
| From | string | 否 | E.164 格式的 Twilio 电话号码，或 WhatsApp 使用的 `whatsapp:+E164`。使用 MessagingServiceSid 时省略。 |
| MediaUrl | array | 否 | 可选的媒体 URL 列表（MMS / WhatsApp 媒体） |
| StatusCallback | string | 否 | Twilio 在投递状态变化时调用的 Webhook URL |
| MessagingServiceSid | string | 否 | 消息服务 SID（MG...）。覆盖环境默认值。若使用 From，则省略。 |
详细介绍
@codespar/mcp-twilio
适用于 Twilio 的 MCP 服务——全球可编程消息和语音服务的行业标准。
覆盖 180 多个国家和地区的 SMS、WhatsApp 和语音服务。包含 Verify（双重身份验证）和 Lookup（电话号码验证）。弥补了目录中全球消息服务的空缺；该目录中的服务商目前偏向巴西本地服务商（Z-API、Take Blip、Zenvia、Evolution API）。
工具（22）
| 工具 | 用途 |
|---|---|
send_message | 发送 SMS 或 WhatsApp 消息。 |
get_message | 根据 SID（SM...）获取消息资源。 |
list_messages | 列出消息，并可选择筛选条件。 |
delete_message | 从历史记录中删除消息。 |
make_call | 发起语音呼叫。 |
get_call | 根据 SID（CA...）获取呼叫资源。 |
update_call | 修改进行中的呼叫。 |
start_verification | 发起 Verify（双重身份验证）验证。 |
check_verification | 根据 Service SID 检查 Verify（双重身份验证）验证码。 |
lookup_phone | 通过 Lookups v2 验证并规范化电话号码。 |
list_incoming_numbers | 列出此账户上由 Twilio 提供的电话号码。 |
buy_phone_number | 申请新的电话号码。 |
list_recordings | 列出此账户上的呼叫录音。 |
create_verify_service | 创建 Verify Service（VA...）。 |
create_conversation | 创建 Twilio Conversation。 |
list_conversations | 列出 Conversation。 |
add_conversation_participant | 向 Conversation 添加参与者。 |
send_conversation_message | 在 Conversation 中发送消息。 |
list_messaging_services | 列出 Messaging Service（MG...）。 |
execute_studio_flow | 为联系人触发 Studio Flow Execution。 |
create_taskrouter_task | 在 Workspace 上创建 TaskRouter Task。 |
list_taskrouter_workers | 列出 TaskRouter Workspace 上的 Worker。 |
安装
npm install @codespar/mcp-twilio
环境变量
TWILIO_ACCOUNT_SID="AC..." # required
TWILIO_AUTH_TOKEN="..." # required (secret)
TWILIO_MESSAGING_SERVICE_SID="MG..." # optional; default sender for send_message
身份验证
使用 AccountSid:AuthToken 进行 HTTP Basic 身份验证。服务会自动处理，你只需配置环境变量。
Authorization: Basic <base64(AccountSid:AuthToken)>
API 范围
- 主 Accounts API：
https://api.twilio.com/2010-04-01/Accounts/{AccountSid}— Messages、Calls、IncomingPhoneNumbers - Verify API：
https://verify.twilio.com/v2— 双重身份验证流程（每次调用都需要传入 Verify Service SID） - Lookups API：
https://lookups.twilio.com/v2— 电话号码验证／运营商／线路类型
请求正文采用 application/x-www-form-urlencoded 格式；响应为 JSON（Accounts API 的端点使用 .json 后缀）。
使用相同的 send_message 工具，但号码需加上 whatsapp: 前缀：
{ "To": "whatsapp:+5511999999999", "From": "whatsapp:+14155238886", "Body": "Olá" }
沙盒号码或已获批准的 WhatsApp 发送方均可使用相同方式。
运行
# 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
企业版
需要为 Agent 付款设置治理、预算限制和审计跟踪？CodeSpar Enterprise 在这些 MCP 服务之上提供策略引擎、付款路由和合规模板。
许可证
MIT
评论
一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。