Server data from the Official MCP Registry
Provision real-SIM US phone numbers, receive SMS, and extract OTP codes for AI agents.
About
Provision real-SIM US phone numbers, receive SMS, and extract OTP codes for AI agents.
Security Report
Valid MCP server (2 strong, 5 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry.
12 files analyzed · 1 issue found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
Environment variable: JOLTSMS_API_KEY
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-rchanllc-joltsms-sms": {
"env": {
"JOLTSMS_API_KEY": "your-joltsms-api-key-here"
},
"args": [
"-y",
"@joltsms/mcp-server"
],
"command": "npx"
}
}
}Documentation
View on GitHubFrom the project's GitHub 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"],
"env": {
"JOLTSMS_API_KEY": "jolt_sk_your_key_here"
}
}
}
}
3. Use It
Your AI agent now has access to all JoltSMS tools. Try:
"Provision a new phone number with area code 650 and wait for an OTP"
Tools
| Tool | Description |
|---|---|
joltsms_list_numbers | List active numbers with service labels, tags, and unread counts |
joltsms_get_number | Full details for a single number |
joltsms_update_number | Set service label, tags, or notes on a number |
joltsms_provision_number | Rent a new dedicated real-SIM US number ($50/mo) |
joltsms_release_number | Cancel/release a number at end of billing period |
joltsms_list_messages | List recent SMS with parsed OTP codes |
joltsms_mark_read | Mark single or bulk messages as read |
joltsms_wait_for_sms | Poll until an SMS arrives (key tool for OTP flows) |
joltsms_get_latest_otp | Get the most recent parsed verification code |
joltsms_billing_status | Check all subscriptions with billing health |
OTP Verification Workflow
The most common use case — automated phone verification:
1. joltsms_provision_number({ area_code: "650" })
→ Number provisioning started! Phone: +16505551234
2. joltsms_update_number({ number_id: "+16505551234", service_name: "PayPal" })
→ Tagged for easy lookup later
3. [Agent enters phone number on PayPal and requests OTP]
4. joltsms_wait_for_sms({ number_id: "+16505551234", timeout_seconds: 120 })
→ SMS received after 8.2s: "Your PayPal code is 847291"
→ OTP Code: 847291
5. joltsms_mark_read({ number_id: "+16505551234" })
→ Inbox clean
6. [Agent enters 847291 on PayPal — verification complete]
Environment Variables
| Variable | Required | Description |
|---|---|---|
JOLTSMS_API_KEY | Yes | Your API key (jolt_sk_*) |
JOLTSMS_API_URL | No | API base URL (defaults to https://api.joltsms.com) |
Requirements
- Node.js 18+
- A JoltSMS account with a payment method on file
- Your first number must be ordered through the Dashboard to complete initial 3D Secure verification
Documentation
License
MIT
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Fetch
Freeby Modelcontextprotocol · Developer Tools
Web content fetching and conversion for efficient LLM usage
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption