ultrastarz avatar

X402 Sms

ultrastarz/x402-sms-mcp

Pay-per-use SMS sending via x402 crypto payments. Exposes a single send_sms tool that dispatches transactional messages to US phone numbers through a Twilio-backed toll-free gateway. Each send costs $0.03 USDC on Base and automatically appends STOP opt-out language. Currently running on Sepolia testnet while the seller's number clears Twilio TFV approval, so calls return a 503 without charging you until that gate lifts. You supply a funded wallet private key in the MCP config and the server handles payment signing on each invocation. Designed for agent-initiated notifications where you've already collected recipient consent. Rate limits and TCPA compliance checks are baked in. The seller never sees your key; settlement happens on-chain and the receipt comes back with the Twilio SID.

tool
1
auth
Secret needed
transport
STDIO
env var
1
last updated
May 15, 2026

Tools

1 tools

Public tool metadata for what this MCP can expose to an agent.

send_smsSends a transactional SMS via the seller's toll-free number to a US phone number, costing $0.03 USDC per message paid via x402.

Sends a transactional SMS via the seller's toll-free number to a US phone number, costing $0.03 USDC per message paid via x402.

No parameter schema in public metadata yet.

Sponsors

Configuration

BUYER_PRIVATE_KEY*secret

Ethereum private key for the buyer wallet that pays the per-call USDC fee.

Readme

x402-sms-mcp

A paid MCP server that lets AI agents send SMS messages to US phone numbers.

Each send_sms tool call:

  1. Sends a transactional SMS via the seller's toll-free number (Twilio verification in progress)
  2. Auto-appends Reply STOP to opt out if the body doesn't include opt-out language
  3. Costs $0.03 USDC per message, paid automatically from the configured wallet via x402

No API keys. No Twilio account. The agent pays the toll, the message goes out.

Status (2026-05-22): Public beta on Base Sepolia (testnet). The seller's toll-free number is undergoing Twilio TFV approval (submitted 2026-05-14, still in queue). During this window /send calls short-circuit to a 503 delivery_pending_tfv_approval response before the buyer wallet signs anything, so no USDC is moved. The day Twilio approves the number, delivery flips on; pricing flips to Base mainnet shortly after.

Install in Claude Desktop / Cursor / Windsurf

Add this to your MCP config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):


View the full README on GitHub

Details

Repository
github.com/ultrastarz/x402-sms-mcp
Category
Communication & Messaging
Package
x402-sms-mcp
Transport
STDIO
Auth
Required
Registry
MCP registry, active

More from ultrastarz

Related Communication & Messaging MCP servers

View all
1meharajm avatarWhatsapp Mcpmeharajm/whatsapp-mcpWhatsApp MCP Server - Human-in-the-loop for AI agents via WhatsApp0stars
2theyahia avatarSms Ru Mcptheyahia/sms-ru-mcpMCP server for SMS.RU API — send SMS, check status, balance. 3 tools.0stars
3builderio avatarAgent-Native Chatbuilderio/agent-nativeMinimal chat-first app with durable threads, actions, and the app-agent loop7.6Kstars
4lharries avatarWhatsApplharries/whatsapp-mcpExposes a MCP server to search, read, and send WhatsApp messages and media via Claude5.6Kstars
5korotovsky avatarSlackkorotovsky/slack-mcp-serverProvides Slack workspace access via MCP with channels, DMs, history, search, and safe posting via multiple transports.1.6Kstars
6levnikolaevich avatarHex Linelevnikolaevich/claude-code-skillsHash-verified file editing MCP server with token efficiency hook for AI coding agents.0stars