x402-sms

x402-sms-mcp

一个收费的 MCP 服务，可让 AI Agent 向美国电话号码发送短信。

每次调用 send_sms 工具：

1. 通过卖家的免费电话号码发送事务性短信（Twilio 验证正在进行中）
2. 如果正文不包含退订说明，则自动附加 Reply STOP to opt out
3. 每条消息收费 0.03 USDC，通过 x402 自动从已配置的钱包付款

无需 API 密钥。无需 Twilio 账号。Agent 支付费用，消息随即发出。

状态（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，用于支付 Gas（可从 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 会调用 send_sms，并设置 opt_in_attestation: true。你会收到 Twilio SID 和链上结算哈希。你可以在 https://sepolia.basescan.org 查看这笔转账。

合规说明 — 请阅读

此 MCP 封装了一个受监管的短信网关。运营方（即你）有责任确保每位收件人都已同意接收消息，然后才能调用 send_sms。opt_in_attestation: true 参数是你根据 TCPA 和 CTIA 短码／长码规则作出的法律声明。

请勿将此 MCP 用于：

• 发送营销或推广内容
• 给陌生人、爬取的名单或任何未主动同意接收消息的人发短信
• 向非美国号码发送消息（卖家目前会拒绝非 +1 E.164 号码）
• 发送任何与 S.H.A.F.T.-C（性、仇恨、酒精、枪支、烟草、大麻）相关的内容

卖家端会自动：

• 在每条消息后附加 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 会显示三种不同的错误形式，以便模型向用户说明发生了什么，并决定是否重试。

原因	你会在聊天中看到什么	是否已扣款？
卖家的免费电话号码仍在 TFV 审核中（HTTP 503）	“短信未发送——服务正在等待上线” + 卖家提交日期和重试说明	否
买家钱包超出每分钟／每小时／每天的速率限制（HTTP 429）	“短信未发送——此买家钱包触发了每 X 时间段的速率限制” + 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 付款，将付款和消息详情发送到卖家端点，然后由卖家的免费电话号码发送短信。你的私钥不会离开你的设备，卖家也看不到它。

路线图

• 当前（2026-05-22）： Base Sepolia 测试网，TFV 待处理。付款流程已通过端到端验证；短信发送需等待 Twilio 批准。
• TFV 审核通过后： 开始在美国实际发送短信；收集早期流量期间保持测试网定价。
• 几周后： A2P 10DLC 品牌审核通过 → 提升每日吞吐量等级。
• 切换至主网： 正式上线，USDC 在 Base 主网上结算；之后计划加入 Solana facilitator。

许可证

MIT