x402-sms

x402-sms-mcp

AI エージェントが米国の電話番号に SMS メッセージを送信できる、有料の MCP サーバーです。

send_sms ツールを呼び出すたびに：

1. 販売者のフリーダイヤル番号を使ってトランザクション SMS を送信します（Twilio の認証手続き中）
2. 本文に配信停止の案内が含まれていない場合は、Reply STOP to opt out を自動で追加します
3. x402 を通じて、設定済みのウォレットからメッセージごとに $0.03 USDC が自動で支払われます

API キーは不要です。Twilio アカウントも不要です。エージェントが料金を支払い、メッセージが送信されます。

ステータス（2026-05-22）：Base Sepolia（テストネット）で公開ベータ中です。 販売者のフリーダイヤル番号は Twilio TFV の承認待ちです（2026-05-14 に申請済みで、現在も審査待ちです）。この期間中、/send の呼び出しは購入者のウォレットが署名する前に 503 delivery_pending_tfv_approval のレスポンスを返すため、USDC は移動しません。Twilio が番号を承認すると、その日に配信が有効になります。その後まもなく、価格体系は Base メインネットに切り替わります。

Claude Desktop / Cursor / Windsurf にインストールする

MCP 設定（macOS の場合は ~/Library/Application Support/Claude/claude_desktop_config.json）に以下を追加します。

{
  "mcpServers": {
    "x402-sms": {
      "command": "npx",
      "args": ["-y", "x402-sms-mcp"],
      "env": {
        "BUYER_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY"
      }
    }
  }
}

MCP クライアントを再起動してください。send_sms ツールが表示されます。

必要なもの

以下を入金した Base Sepolia（テストネット）のウォレット：

• ガス代用の少量の ETH（https://www.coinbase.com/faucets/base-ethereum-sepolia-faucet から無料で入手できます）
• 支払い用の USDC（https://faucet.circle.com から無料で入手できます。Base Sepolia を選択してください）

使い捨てのキーを生成します。

node -e "const {generatePrivateKey,privateKeyToAccount}=require('viem/accounts');const k=generatePrivateKey();console.log('PRIVATE_KEY=',k);console.log('ADDRESS=',privateKeyToAccount(k).address)"

表示されたアドレスを使ってフォーセットから受け取り、表示されたキーを MCP 設定に追加します。

試してみる

Claude Desktop で次のように依頼します。

この時間のかかるタスクが終わったら、私の携帯電話（+15551234567）にテキストメッセージを送ってください。受信者（私）は、このメッセージを受け取ることに同意しています。

Claude は opt_in_attestation: true を指定して send_sms を呼び出します。Twilio SID とオンチェーン決済ハッシュが返されます。送金は https://sepolia.basescan.org で確認できます。

コンプライアンス — 必ずお読みください

この MCP は規制対象の SMS ゲートウェイを利用しています。運用者（あなた）は、send_sms を呼び出す前に、すべての受信者がメッセージの受信に同意していることを確認する責任があります。opt_in_attestation: true 引数は、TCPA および CTIA のショートコード／ロングコード規則に基づく法的な同意表明です。

この MCP を次の目的で使用しないでください。

• マーケティングや宣伝のコンテンツを送信する
• 見知らぬ人、スクレイピングしたリスト、またはオプトインしていない相手にテキストメッセージを送信する
• 米国以外の番号に送信する（販売者は現在、+1 以外の E.164 番号を拒否します）
• S.H.A.F.T.-C（Sex、Hate、Alcohol、Firearms、Tobacco、Cannabis）に関連する内容を送信する

販売者側では、次の処理が自動的に行われます。

• すべてのメッセージに Reply STOP to opt out を追加します
• キャリアレベルの STOP／HELP キーワード処理に対応します
• 監査目的ですべての送信を記録します

同意を得ているかどうか少しでも疑問がある場合は、このツールを呼び出さないでください。

設定

環境変数	必須	デフォルト
BUYER_PRIVATE_KEY	はい	—
SMS_URL	いいえ	https://x402-sms-server-production.up.railway.app/send

MCP サーバーの接続先を独自の販売者デプロイにするには、SMS_URL を上書きします。

表示される可能性のあるエラー

MCP は3種類のエラー形式を返します。これにより、モデルは何が起きたかをユーザーに説明し、再試行するかどうかを判断できます。

原因	チャットに表示される内容	支払いは発生しましたか？
販売者のフリーダイヤル番号がまだ TFV 審査中（HTTP 503）	「SMS は送信されませんでした — サービスはローンチ前の待機中です」＋販売者の申請日と再試行の案内	いいえ
購入者のウォレットが分・時間・日ごとのレート制限を超過（HTTP 429）	「SMS は送信されませんでした — この購入者のウォレットは分・時間・日ごとのレート制限に達しました」＋retry_after_seconds	いいえ
Twilio 側での拒否（例：無効な番号 21211、オプトアウト済み 21610）	Twilio のエラーコードに対応するわかりやすいヒント＋レスポンス本文全体	はい（送信を試行）

MCP が認識する Twilio のエラーコードの完全な対応表については、src/index.ts の TWILIO_HINTS を参照してください。

動作の仕組み

Claude Desktop ──tool call──> MCP server (this package, on your machine)
                              │
                              │ x402 payment (USDC, Base Sepolia)
                              │ + to/message/opt_in_attestation
                              ▼
                              Public seller (Hono + Twilio on Railway)
                              │
                              │ Twilio dispatch
                              ▼
                              SMS lands on recipient's phone
                              │
                              │ Twilio SID + status
                              ▼
                              MCP server ──tool result──> Claude Desktop

MCP サーバーは Twilio と直接通信しません。購入者のウォレットで x402 支払いに署名し、支払い情報とメッセージの詳細を販売者のエンドポイントに送信します。その後、販売者のフリーダイヤル番号から SMS が送信されます。秘密鍵がマシンの外に出ることはありません。販売者に秘密鍵が知られることもありません。

ロードマップ

• 現在（2026-05-22）： Base Sepolia テストネット、TFV 審査待ち。支払いフローはエンドツーエンドで検証済みです。Twilio の承認までは配信が保留されます。
• TFV 承認後： 米国内で SMS を実際に配信します。初期トラフィックを集めている間は、テストネットの料金を維持します。
• 数週間後： A2P 10DLC のブランド承認 → 1日あたりの送信上限が高いティアに移行します。
• メインネット移行： 本番環境でローンチし、USDC は Base メインネット上で決済されます。Solana ファシリテーターはその後のロードマップに含まれています。

ライセンス

MIT