{
  "markdown": "# @joltsms/mcp-server\n\nMCP server for [JoltSMS](https://joltsms.com) — provision dedicated real-SIM US phone numbers and receive SMS/OTP codes through AI agents.\n\nBuilt on the [Model Context Protocol](https://modelcontextprotocol.io), 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.\n\n## Quick Start\n\n### 1. Get an API Key\n\nCreate a JoltSMS account and generate an API key at **[Dashboard → Settings → API Keys](https://app.joltsms.com/settings)**.\n\n### 2. Configure Your MCP Client\n\nAdd to your `.mcp.json` (Claude Code) or MCP settings (Claude Desktop, Cursor):\n\n```json\n{\n  \"mcpServers\": {\n    \"joltsms\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@joltsms/mcp-server\"],\n      \"env\": {\n        \"JOLTSMS_API_KEY\": \"jolt_sk_your_key_here\"\n      }\n    }\n  }\n}\n```\n\n### 3. Use It\n\nYour AI agent now has access to all JoltSMS tools. Try:\n\n> \"Provision a new phone number with area code 650 and wait for an OTP\"\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `joltsms_list_numbers` | List active numbers with service labels, tags, and unread counts |\n| `joltsms_get_number` | Full details for a single number |\n| `joltsms_update_number` | Set service label, tags, or notes on a number |\n| `joltsms_provision_number` | Rent a new dedicated real-SIM US number ($50/mo) |\n| `joltsms_release_number` | Cancel/release a number at end of billing period |\n| `joltsms_list_messages` | List recent SMS with parsed OTP codes |\n| `joltsms_mark_read` | Mark single or bulk messages as read |\n| `joltsms_wait_for_sms` | Poll until an SMS arrives (key tool for OTP flows) |\n| `joltsms_get_latest_otp` | Get the most recent parsed verification code |\n| `joltsms_billing_status` | Check all subscriptions with billing health |\n\n## OTP Verification Workflow\n\nThe most common use case — automated phone verification:\n\n```\n1. joltsms_provision_number({ area_code: \"650\" })\n   → Number provisioning started! Phone: +16505551234\n\n2. joltsms_update_number({ number_id: \"+16505551234\", service_name: \"PayPal\" })\n   → Tagged for easy lookup later\n\n3. [Agent enters phone number on PayPal and requests OTP]\n\n4. joltsms_wait_for_sms({ number_id: \"+16505551234\", timeout_seconds: 120 })\n   → SMS received after 8.2s: \"Your PayPal code is 847291\"\n   → OTP Code: 847291\n\n5. joltsms_mark_read({ number_id: \"+16505551234\" })\n   → Inbox clean\n\n6. [Agent enters 847291 on PayPal — verification complete]\n```\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `JOLTSMS_API_KEY` | Yes | Your API key (`jolt_sk_*`) |\n| `JOLTSMS_API_URL` | No | API base URL (defaults to `https://api.joltsms.com`) |\n\n## Requirements\n\n- Node.js 18+\n- A JoltSMS account with a payment method on file\n- Your first number must be ordered through the [Dashboard](https://app.joltsms.com) to complete initial 3D Secure verification\n\n## Documentation\n\n- [MCP Server Docs](https://joltsms.com/developers/mcp)\n- [API Reference](https://joltsms.com/developers/api-reference)\n- [JoltSMS Website](https://joltsms.com)\n\n## License\n\nMIT\n",
  "bytes": 3196,
  "sha": "fd9d8eac506fb8967bb1ac63cfe58ca75cad17bd65814fef271607f3df1d1d69",
  "repo_slug": "rchanllc/joltsms-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_rchanllc_joltsms_sms_cb83e3a6/readme"
}