
Joltsms Sms
Connects Claude to JoltSMS for provisioning real SIM US phone numbers and handling SMS verification flows. Exposes tools to rent numbers by area code ($50/month), poll for incoming messages, extract OTP codes, and manage billing subscriptions. The core workflow is automated verification: provision a number, tag it with a service name like "PayPal", wait for SMS using `joltsms_wait_for_sms` with configurable timeout, grab the parsed OTP code, then mark messages read. Useful when you need agents to complete phone verification steps autonomously without manual SMS forwarding. First number must be ordered through the dashboard for payment verification, then the MCP handles everything programmatically.
- GitHub stars
- 1
- tools
- 12
- auth
- Secret needed
- transport
- STDIO
- env var
- 1
- last updated
- Nov 12, 2026
Tools
12 toolsPublic tool metadata for what this MCP can expose to an agent.
joltsms_list_numbersList active numbers with service labels, tags, and unread counts
List active numbers with service labels, tags, and unread counts
No parameter schema in public metadata yet.
joltsms_get_numberFull details for a single number
Full details for a single number
No parameter schema in public metadata yet.
joltsms_update_numberSet service label, tags, or notes on a number
Set service label, tags, or notes on a number
No parameter schema in public metadata yet.
joltsms_list_payment_methodsList masked saved cards and payment method IDs
List masked saved cards and payment method IDs
No parameter schema in public metadata yet.
joltsms_provision_numberRent the next available number, optionally using a selected saved card ($50/mo)
Rent the next available number, optionally using a selected saved card ($50/mo)
No parameter schema in public metadata yet.
joltsms_release_numberEnd auto-renew at period end, or cancel an unpaid initial checkout
End auto-renew at period end, or cancel an unpaid initial checkout
No parameter schema in public metadata yet.
joltsms_list_messagesList recent SMS with parsed OTP codes and message IDs
List recent SMS with parsed OTP codes and message IDs
No parameter schema in public metadata yet.
joltsms_reply_to_smsReply to an eligible inbound message (up to 15 characters)
Reply to an eligible inbound message (up to 15 characters)
No parameter schema in public metadata yet.
joltsms_mark_readMark single or bulk messages as read
Mark single or bulk messages as read
No parameter schema in public metadata yet.
joltsms_wait_for_smsPoll until an SMS arrives (key tool for OTP flows)
Poll until an SMS arrives (key tool for OTP flows)
No parameter schema in public metadata yet.
joltsms_get_latest_otpGet the most recent parsed verification code
Get the most recent parsed verification code
No parameter schema in public metadata yet.
joltsms_billing_statusCheck up to 10 subscriptions with billing health
Check up to 10 subscriptions with billing health
No parameter schema in public metadata yet.
Sponsors
Configuration
JOLTSMS_API_KEY*secretYour JoltSMS API key (jolt_sk_*). Create one at https://app.joltsms.com/settings
Readme
@joltsms/mcp-server
MCP server for JoltSMS — provision dedicated real-SIM US phone numbers and receive SMS/OTP codes through AI agents.
Built on the Model Context Protocol, this server gives AI agents (Claude Code, Claude Desktop, Cursor, etc.) the ability to rent phone numbers, wait for incoming SMS, extract OTP codes, and manage billing — all through standardized tool calls.
Quick Start
1. Get an API Key
Create a JoltSMS account and generate an API key at Dashboard → Settings → API Keys.
2. Configure Your MCP Client
Add to your .mcp.json (Claude Code) or MCP settings (Claude Desktop, Cursor):
{
"mcpServers": {
"joltsms": {
"command": "npx",
"args": ["-y", "@joltsms/mcp-server@2"],
"env": {
"JOLTSMS_API_KEY": "jolt_sk_your_key_here"
}
}
}
}
3. Use It
Your AI agent now has access to all 15 JoltSMS tools. Try:
"List my saved cards, then rent the next available number using the card I choose."
Tools
Details
- Repository
- github.com/rchanllc/joltsms-mcp-server
- Categories
- Communication & Messaging, Search & Web Crawling
- Package
@joltsms/mcp-server- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active