mcp-twilio

@codespar/mcp-twilio

Twilio 用の MCP サーバー — プログラム可能なメッセージングと音声通話のグローバルスタンダードです。

180 以上の国で SMS、WhatsApp、音声通話を利用できます。Verify（2FA）と 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（2FA）チャレンジを開始します。
check_verification	Service SID に対して Verify（2FA）コードを確認します。
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 — 2FA フロー（呼び出しごとに Verify Service SID を渡す必要があります）
• Lookups API：https://lookups.twilio.com/v2 — 電話番号の検証／キャリア／回線種別

リクエストボディは application/x-www-form-urlencoded 形式です。レスポンスは JSON です（Accounts API のエンドポイントでは .json サフィックスを使用します）。

WhatsApp

同じ send_message ツールを使用しますが、電話番号の先頭に whatsapp: を付けます。

{ "To": "whatsapp:+5511999999999", "From": "whatsapp:+14155238886", "Body": "Olá" }

Sandbox の電話番号、または承認済みの 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

エンタープライズ

エージェントの支払いにガバナンス、予算上限、監査証跡が必要ですか？CodeSpar Enterprise は、これらの MCP サーバーにポリシーエンジン、支払いルーティング、コンプライアンステンプレートを追加します。

ライセンス

MIT