rchanllc avatar

Joltsms Sms

rchanllc/joltsms-mcp-server

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 tools

Public 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*secret

Your 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


View the full README on GitHub

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

More from rchanllc

Related Communication & Messaging MCP servers

View all
1stevenvo avatarSlack Mcp Serverstevenvo/slack-mcp-serverRead Slack conversations, threads, user info, and search messages from your MCP client.1stars
2adelaidasofia avatarWhatsApp MCPadelaidasofia/whatsapp-mcpWhatsApp MCP. SQLCipher-encrypted, scrubber-CI-gated, draft-and-confirm sends, voice transcription.0stars
3danushkumar-v avatarDanushkumar V Mcp Discorddanushkumar-v/mcp-discordAn MCP server that integrates with Discord to provide AI-powered features.0stars
4sebastianall1977 avatarSebastianall1977 Gmail Mcpsebastianall1977/gmail-mcpManage Gmail end-to-end: search, read, send, draft, label, and organize threads. Automate workflow…0stars
5mumo-chat avatarmumomumo-chat/mumo-mcpMulti-model deliberation over MCP: full responses plus typed cross-model reactions from other labs.0stars
6deva avatarDilli Email Validation Api Servercom.dillilabs.deva/dilli-email-validation-api-serverAn MCP server that provides tools to validate an email address using Dilli Email Validation API.0stars