rchanllc/joltsms-mcp-server

rchanllc/joltsms-mcp-server

от rchanllc
MCP сервер для аренды US-номеров и приёма SMS/OTP через AI-агентов. Включает заказ номеров, ожидание и извлечение OTP, управление биллингом. Автоматизация верификации аккаунтов и регистраций.

@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 12 JoltSMS tools. Try:

"List my saved cards, then rent the next available number using the card I choose."

Инструменты были проиндексированы:
joltsms_billing_status

Проверяет статус биллинга и подписок для всех ваших номеров JoltSMS. Показывает каждую подписку с указанием статуса оплаты, цены, дат продления/отмены и статуса автопродления. Сопоставляет с номерами телефонов для удобной идентификации.

Параметры
  • limitnumber

    Максимум подписок для отображения (1-10, по умолчанию 10)

joltsms_get_latest_otp

Получает последний распарсенный OTP-код из телефонного номера. Удобный инструмент — проверяет последние сообщения (по умолчанию за последние 10 минут) на наличие распарсенного проверочного кода. Если распарсенный код не найден, возвращает текст последнего сообщения для ручного извлечения. Используйте joltsms_wait_for_sms, если нужно дождаться OTP, который ещё не пришёл.

Параметры
  • number_idstringобязательный

    Числовой ID (UUID) или номер телефона (например, +17243213654 или 7243213654)

  • sincestring

    Учитывает только сообщения после указанной даты и времени в формате ISO 8601. По умолчанию используются последние 10 минут.

joltsms_get_number

Получает полные сведения об одном номере телефона, включая название услуги, теги, заметки, количество сообщений, даты выставления счетов и статус подписки. Принимает UUID или номер телефона (например, "+16505551234", "650-555-1234", "(650) 555-1234").

Параметры
  • number_idstringобязательный

    Числовой ID (UUID) или номер телефона (например, +17243213654 или 7243213654)

joltsms_list_messages

Выводит список последних SMS-сообщений, полученных на ваши номера JoltSMS. Возвращает отправителя, текст, распознанный OTP-код (если обнаружен) и временные метки. Используйте number_id для фильтрации по конкретному номеру или опустите этот параметр для всех номеров. Используйте from_filter для точной фильтрации по отправителю.

Параметры
  • cursorstring

    Курсор пагинации из предыдущего ответа

  • from_filterstring

    Фильтрует по номеру телефона отправителя (точное совпадение, например, "+18005551234").

  • limitnumber

    Максимум возвращаемых сообщений (1-10, по умолчанию 10)

  • number_idstring

    Фильтр по ID номера (UUID) или номеру телефона (например, +17243213654 или 7243213654). Опустите для всех номеров.

  • sincestring

    Дата и время в формате ISO 8601 — возвращать только сообщения после этого времени. Пример: "2025-01-15T00:00:00Z"

joltsms_list_numbers

Выводит список активных телефонных номеров JoltSMS. Возвращает номер телефона, статус, название сервиса, теги, количество сообщений и информацию о подписке. Каждый номер стоит 50 долларов в месяц и принимает неограниченное количество входящих SMS с разобранными кодами OTP.

Параметры
  • limitnumber

    Максимум возвращаемых чисел (1-10, по умолчанию 10)

joltsms_mark_read

Помечает сообщения как прочитанные. Укажите ровно один из параметров: - message_id: помечает одно сообщение как прочитанное (UUID) - number_id: помечает ВСЕ сообщения на номере как прочитанные (UUID или номер телефона) Используйте после извлечения одноразового кода (OTP), чтобы поддерживать чистоту входящих.

Параметры
  • message_idstring

    Отмечает одно сообщение как прочитанное по его UUID. Укажите ровно один из параметров message_id или number_id.

  • number_idstring

    Помечает ВСЕ сообщения на этом номере как прочитанные. Принимает UUID или номер телефона. Укажите ровно один из параметров: message_id или number_id.

joltsms_provision_number

Арендовать новый выделенный номер телефона в США с реальной SIM-картой ($50/мес.). ВАЖНО: У пользователя должен быть настроен способ оплаты в панели управления JoltSMS. Предоставление выполняется асинхронно — номер может стать АКТИВНЫМ от нескольких секунд до нескольких минут. Для конкретных кодов городов укажите трёхзначный код (например, "212" для Нью-Йорка). Если требуется аутентификация 3DS, этот инструмент возвращает URL-адрес, по которому пользователь должен перейти для авторизации платежа.

Параметры
  • area_codestring

    Предпочитаемый код города США (3 цифры, например «212»). Необязательно: пропустите, чтобы использовать любой доступный код.

joltsms_release_number

Отменяет/освобождает номер телефона. Номер остаётся активным до конца текущего расчётного периода. Требует идентификатор подписки (из вывода joltsms_list_numbers). Это отключает автопродление — номер будет освобождён по окончании периода.

Параметры
  • subscription_idstringобязательный

    Идентификатор подписки на номер, который нужно освободить (из joltsms_list_numbers).

joltsms_update_number

Обновляет метаданные номера телефона - устанавливает метку сервиса, теги или заметки. Обновляются только указанные поля. Остальные поля остаются без изменений. Передайте пустой массив [], чтобы очистить теги, или пустую строку "", чтобы очистить заметки. Примеры: update_number("+16505551234", service_name="PayPal", tags=["production"]) update_number("+16505551234", notes="Linked to acme@company.com")

Параметры
  • notesstring

    Заметки в свободной форме (например, "Linked to acme@company.com"). Максимум 1000 символов. Для очистки введите "".

  • number_idstringобязательный

    Числовой ID (UUID) или номер телефона (например, +17243213654 или 7243213654)

  • service_namestring

    Метка сервиса или платформы (например, «PayPal», «Discord Backup»). Максимум 100 символов.

  • tagsstring[]

    Теги для категоризации (например, ["production", "paypal"]). Максимум 20 тегов, каждый до 50 символов. Передайте [], чтобы очистить.

joltsms_wait_for_sms

Опрашивает входящее SMS-сообщение на указанном номере. Это КЛЮЧЕВОЙ инструмент для рабочих процессов проверки OTP. Типичный процесс: 1. Запустите OTP на сайте/в приложении, используя номер телефона JoltSMS 2. Вызовите этот инструмент с параметром number_id 3. Инструмент опрашивает каждые несколько секунд, пока не придёт SMS или не истечёт тайм-аут 4. Возвращает тело сообщения и распарсенный код OTP Используйте from_filter, чтобы отфильтровать сообщения только от конкретного отправителя. Тайм-аут по умолчанию — 120 секунд с интервалом опроса 5 секунд.

Параметры
  • from_filterstring

    Сопоставлять SMS только от этого отправителя (частичное совпадение)

  • number_idstringобязательный

    Числовой ID (UUID) или номер телефона (например, +17243213654 или 7243213654)

  • poll_interval_secondsnumber

    Секунды между опросами (3-30, по умолчанию 5)

  • timeout_secondsnumber

    Максимальное время ожидания в секундах (10-300, по умолчанию 120)

2.0.0основная
1.0.2
1.0.1
1.0.0

Выберите клиент, чтобы установить rchanllc/joltsms-mcp-server:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "rchanllc-joltsms-mcp-server-3e50c7zce9": {
      "env": {
        "JOLTSMS_API_KEY": "jolt_sk_your_key_here"
      },
      "args": [
        "-y",
        "@joltsms/mcp-server"
      ],
      "command": "npx"
    }
  }
}
CursorCursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "rchanllc-joltsms-mcp-server-3e50c7zce9": {
      "env": {
        "JOLTSMS_API_KEY": "jolt_sk_your_key_here"
      },
      "args": [
        "-y",
        "@joltsms/mcp-server"
      ],
      "command": "npx"
    }
  }
}
VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "rchanllc-joltsms-mcp-server-3e50c7zce9": {
      "type": "stdio",
      "env": {
        "JOLTSMS_API_KEY": "jolt_sk_your_key_here"
      },
      "args": [
        "-y",
        "@joltsms/mcp-server"
      ],
      "command": "npx"
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"rchanllc-joltsms-mcp-server-3e50c7zce9\",\"type\":\"stdio\",\"env\":{\"JOLTSMS_API_KEY\":\"jolt_sk_your_key_here\"},\"args\":[\"-y\",\"@joltsms/mcp-server\"],\"command\":\"npx\"}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "rchanllc-joltsms-mcp-server-3e50c7zce9": {
      "env": {
        "JOLTSMS_API_KEY": "jolt_sk_your_key_here"
      },
      "args": [
        "-y",
        "@joltsms/mcp-server"
      ],
      "command": "npx"
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add rchanllc-joltsms-mcp-server-3e50c7zce9 --env JOLTSMS_API_KEY=jolt_sk_your_key_here -- npx -y @joltsms/mcp-server

Либо через JSON-конфиг:

claude mcp add-json rchanllc-joltsms-mcp-server-3e50c7zce9 "{\"env\":{\"JOLTSMS_API_KEY\":\"jolt_sk_your_key_here\"},\"args\":[\"-y\",\"@joltsms/mcp-server\"],\"command\":\"npx\"}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add rchanllc-joltsms-mcp-server-3e50c7zce9 --env JOLTSMS_API_KEY=jolt_sk_your_key_here -- npx -y @joltsms/mcp-server

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.rchanllc-joltsms-mcp-server-3e50c7zce9]
command = "npx"
args = ["-y", "@joltsms/mcp-server"]

[mcp_servers.rchanllc-joltsms-mcp-server-3e50c7zce9.env]
JOLTSMS_API_KEY = "jolt_sk_your_key_here"
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите rchanllc/joltsms-mcp-server, а в поле команды запуска — строку ниже:
npx -y @joltsms/mcp-server

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "rchanllc-joltsms-mcp-server-3e50c7zce9": {
      "env": {
        "JOLTSMS_API_KEY": "jolt_sk_your_key_here"
      },
      "args": [
        "-y",
        "@joltsms/mcp-server"
      ],
      "command": "npx"
    }
  }
}
ClineCline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "rchanllc-joltsms-mcp-server-3e50c7zce9": {
      "env": {
        "JOLTSMS_API_KEY": "jolt_sk_your_key_here"
      },
      "args": [
        "-y",
        "@joltsms/mcp-server"
      ],
      "command": "npx",
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например rchanllc-joltsms-mcp-server-3e50c7zce9.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: rchanllc-joltsms-mcp-server-3e50c7zce9
    command: npx
    args:
      - "-y"
      - "@joltsms/mcp-server"
    env:
      JOLTSMS_API_KEY: jolt_sk_your_key_here
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "rchanllc-joltsms-mcp-server-3e50c7zce9": {
      "env": {
        "JOLTSMS_API_KEY": "jolt_sk_your_key_here"
      },
      "args": [
        "-y",
        "@joltsms/mcp-server"
      ],
      "command": "npx"
    }
  }
}

Похожие MCP-сервера

chaindead/telegram-mcp

chaindead/telegram-mcp

от chaindead

Telegram MCP сервер подключает AI-ассистентов к вашему аккаунту: чтение диалогов, отправка сообщений, отслеживание уведомлений. Работает с Claude, Cursor. Упрощает управление перепиской и автоматизацию ответов.

Go⭐ 349
gerkensm/callcenter.js-mcp

gerkensm/callcenter.js-mcp

от gerkensm

MCP-сервер для голосовых звонков через VoIP с ИИ-агентом. Скажите Claude, кому позвонить и что обсудить — он сам наберет номер, проведет диалог и обработает ответ. Полезен для автоматизации звонков, прототипов и экспериментов. Работает с SIP-провайдерами, поддерживает кодеки G.722 и G.711, запуск...

TypeScript⭐ 25
overpod/mcp-telegram

overpod/mcp-telegram

от overpod

MCP-сервер для подключения Claude и ChatGPT к Telegram через MTProto. Работает как юзербот под вашим аккаунтом: полный доступ к чатам, сообщениям, медиа, стикерам, сторис и управлению профилем. Всё...

TypeScript⭐ 54
agenticmail/agenticmail

agenticmail/agenticmail

официальный

от agenticmail

MCP сервер наделяет AI-агентов реальными email и номерами телефонов для отправки и получения писем, SMS и кодов верификации. Встроенная память, голосовые вызовы и медиа-инструменты расширяют их возможности.

TypeScript⭐ 239
saseq/discord-mcp

saseq/discord-mcp

от saseq

MCP-сервер для Discord API, интегрирующий ботов с ИИ-ассистентами. Даёт AI полный контроль над сервером: управление каналами, сообщениями и модерацией. Идеален для автоматизации Discord-сообществ.

Java⭐ 553
iletimerkezi/iletimerkezi-mcp-server

iletimerkezi/iletimerkezi-mcp-server

от iletimerkezi

MCP сервер для работы с SMS-платформой iletiMerkezi: отправка сообщений, проверка отчётов доставки, управление отправителями и чёрным списком. Включает 11 инструментов, синхронизированных с API. Подходит разработчикам, автоматизирующим бизнес-коммуникации.

TypeScript⭐ 2
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин