Can I specify the area code when provisioning a new number?

Yes, you can request a new number with a desired area code using the provision number tool.

Is there a cost associated with renting numbers?

Yes, each dedicated real-SIM US phone number costs $50 per month.

What is the typical workflow for automated OTP verification?

Provision a number, tag it, wait for SMS containing OTP, extract the code, mark messages read, then use the OTP for verification.

Can I change the API base URL?

Yes, optionally set JOLTSMS_API_URL environment variable to override the default API endpoint.

Joltsms MCP Server

smsotpphone-numbersverificationcommunication

Provision and manage dedicated US real-SIM phone numbers for receiving SMS and OTP codes via AI agents.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "rchanllc-joltsms-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@joltsms/mcp-server"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Overview

This MCP server enables AI agents to rent dedicated real-SIM US phone numbers, receive inbound SMS messages, extract OTP codes, and manage billing through standardized tool calls. It is designed for automating phone verification workflows across platforms by polling for SMS and handling message state. Use this server when you need programmatic control over phone numbers and SMS reception for verification or communication automation.

Use cases

Provision dedicated US phone numbers with specific area codes

Receive and poll inbound SMS messages on rented numbers

Extract and retrieve OTP codes from incoming SMS

Tag and manage phone numbers with service labels and notes

Monitor billing status and manage number subscriptions

Key features

Rent real-SIM US phone numbers ($50/month per number)

List and update active numbers with metadata

Poll for incoming SMS and wait for messages

Parse OTP codes automatically from SMS content

Mark messages as read individually or in bulk

Check billing health and subscription status

Capabilities & Tool Schemas (10)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by Joltsms MCP Server.

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

Documentation Overview

@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):

config.json

{
  "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:

Code

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

Read the full README →View source on GitHub →

Related MCP Servers

View all in Communication View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

npm downloads

156

Package downloads in the last 30 days.

Last commit

6mo ago

Most recent push to the default branch.

Tools exposed

Callable tools this server registers over MCP.

Directory activity

2 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Joltsms MCP Server

You must provide a JoltSMS API key via the JOLTSMS_API_KEY environment variable.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Joltsms MCP Server AllMCPs Directory Badge

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/rchanllc-joltsms-mcp-server?style=directory)](https://allmcps.com/mcp/rchanllc-joltsms-mcp-server)

HTML Embed

<a href="https://allmcps.com/mcp/rchanllc-joltsms-mcp-server"><img src="https://allmcps.com/api/badge/rchanllc-joltsms-mcp-server?style=directory" alt="Joltsms MCP Server on AllMCPs" /></a>

Technical Specs & Signals

CategoryCommunication

PricingPaid

10/11 checks healthy over the last 32d

55Quality signal: Good · 55/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools28/30

Adoption & activity3/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 22d ago via OSV.dev · @joltsms/mcp-server (npm)

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💬 Communication →Best MCP servers for Slack & Communication →Alternatives to Joltsms MCP Server →Install in Claude Desktop Install in Cursor Install in VS Code