How do I install the joltsms mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `JOLTSMS_API_KEY`, `JOLTSMS_API_URL` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Joltsms MCP Server

MCP server for JoltSMS — provision real-SIM phone numbers and receive OTP codes

Local serverstdio

What is the Joltsms MCP Server?

MCP server for JoltSMS — provision real-SIM phone numbers and receive OTP codes

What the server does

MCP server for JoltSMS — provision dedicated real-SIM US phone numbers and receive SMS/OTP codes through AI agents.

Credentials and setup notes

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

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
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

How to install the Joltsms MCP Server

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

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

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

Variable	Description	Required
JOLTSMS_API_KEY	Declared in the maintainer’s client configuration.	Check documentation

Example prompts to try

“Use Joltsms to joltsms list numbers.”
“Use Joltsms to joltsms get number.”
“Use Joltsms to joltsms update number.”

Frequently asked questions

MCP server for JoltSMS — provision real-SIM phone numbers and receive OTP codes Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.