SMS8 - SMS GATEWAY using your phone

SMS8 MCP-сервер

SMS-шлюз → sms8.io  ·  SMS Gateway MCP для vibe-разработчиков и программистов → mcp.sms8.io

Отправляйте SMS, создавайте и проверяйте OTP-коды, ожидайте входящие коды и настраивайте вебхуки из Claude Code, Cursor, Windsurf, OpenCode и любого другого AI-инструмента для разработки, поддерживающего Model Context Protocol. SMS маршрутизируются через сопряженный телефон Android с помощью платформы SMS8.

Рабочий сервер: https://mcp.sms8.io Панель управления: https://app.sms8.io Маркетинговый сайт: https://sms8.io

Зачем это нужно

Создаете приложение и хотите добавить SMS-уведомления, OTP-коды, двусторонний обмен сообщениями или верификацию телефона для автономных агентов? Большинство вариантов требуют регистрации в программах операторов, выделения телефонных номеров, оплаты за каждое сообщение или аренды одноразовой SIM-карты на сессию. SMS8 маршрутизирует SMS через ваш собственный телефон. MCP-сервер предоставляет вашему AI-ассистенту девять инструментов, которые он может вызывать напрямую, поэтому добавление SMS в проект занимает одну команду вместо часа интеграционной работы.

Что вы получаете

Инструмент	Назначение
setup_sms8	Проверяет API-ключ, возвращает контекст аккаунта и примеры кода
send_sms	Отправляет одно SMS через сопряженное устройство Android
send_otp	Генерирует и отправляет проверочный код
verify_otp	Сравнивает введенный код с последним выданным OTP
wait_for_otp	НОВИНКА. Блокируется до получения OTP на сопряженном Android; извлекает код
get_messages	Возвращает недавние входящие или отправленные SMS
list_devices	Выводит список сопряженных устройств Android
get_balance	НОВИНКА. Облегченная проверка кредитов и продления
create_webhook	Регистрирует URL обратного вызова для входящих SMS и событий доставки

Все инструменты используют тот же конвейер отправки, что и панель управления SMS8. Кредиты, повторные попытки, маршрутизация между устройствами и подпись вебхуков работают идентично прямому вызову API.

SMS8 против Twilio против MessageBird

Возможность	SMS8	Twilio	MessageBird
Встроенный MCP-сервер	Да	Нет	Нет
Плата за сообщение	Отсутствует	$0.0079+	$0.05+
Требуется A2P 10DLC	Нет	Да	Да
Выделение телефонного номера	Не требуется	$1+/мес	$2+/мес
Время настройки	60 секунд	От дней до недель	Дни
Встроенная проверка OTP	Да	Дополнительный сервис	Дополнительный сервис
Открытый исходный код MCP	MIT	Нет	Нет

Установка через npm

Шесть пакетов покрывают все сценарии — выберите подходящий для вашего проекта.

Пакет	Команда запуска	Вариант использования
sms8-mcp	npx -y sms8-mcp	Лаунчер MCP для Claude Code, Cursor, Windsurf, OpenCode
sms8-cli	npx sms8-cli send +1234 "hi"	Терминальный CLI для отправки / OTP / входящих / устройств
react-sms-otp	npm i react-sms-otp	React useSms8Otp() + <OtpForm /> + <OtpInput /> (разделители, RTL, маска, рендер-пропсы)
sms-otp-verify	npm i sms-otp-verify	Тот же код, SEO-ориентированное имя для поиска "sms otp verify" / "otp input"
capacitor-sms-otp-send-verify	npm i capacitor-sms-otp-send-verify	Плагин Capacitor для Ionic-приложений — нативный iOS Swift + Android Kotlin + веб-запасной вариант
cordova-plugin-sms-otp-send	cordova plugin add cordova-plugin-sms-otp-send	Плагин Cordova для Ionic-приложений — нативный iOS Swift + Android Kotlin
sms-otp-using-myphone	npx sms-otp-using-myphone send +1234	Бренд того же CLI, только для OTP
phone-sms-gateway	npx phone-sms-gateway send +1234 "hi"	Бренд того же CLI, телефон как шлюз
send-sms-from-android	npx send-sms-from-android send +1234 "hi"	Бренд того же CLI, ориентированный на Android

Пример MCP (Claude Code, Cursor, Windsurf — одинаковая форма конфигурации):

{
  "mcpServers": {
    "sms8": {
      "command": "npx",
      "args": ["-y", "sms8-mcp"],
      "env": { "SMS8_API_KEY": "sk_xxx" }
    }
  }
}

Пример CLI:

export SMS8_API_KEY=sk_xxx
npx sms8-cli send +14155550100 "Hello"
CODE=$(npx sms8-cli otp wait +Google --timeout=120)

Пример React:

import { OtpForm } from 'react-sms-otp';

<OtpForm
  apiKey={process.env.NEXT_PUBLIC_SMS8_API_KEY!}
  onVerified={(phone) => router.push('/dashboard')}
/>

Исходный код всех шести пакетов находится в npm-packages/.

iOS + Android SDK

Для нативных мобильных приложений папка sdks/ содержит SDK для Kotlin (Android) и Swift (iOS) с API отправки / проверки + помощниками автозаполнения SMS (Google SMS Retriever на Android, тип контента oneTimeCode на iOS).

SDK	Установка	Автозаполнение
sms8-swift	Swift Package Manager — см. README	iOS OTPTextField представление SwiftUI
sms8-android	JitPack — см. README	SMSRetriever.start(activity) — разрешение на SMS не требуется

Оба SDK распространяются под лицензией MIT, используют один и тот же API-ключ SMS8 и нацелены на те же сценарии использования, альтернативные Twilio Verify.

Быстрый старт

1. Создайте аккаунт SMS8

Зарегистрируйтесь на app.sms8.io. Бесплатный 5-дневный пробный период, кредитная карта не требуется. Сопрягите свой телефон Android через QR-код и скопируйте API-ключ из раздела Профиль, затем API.

2. Добавьте MCP-сервер в свой инструмент

Размещенный HTTP (Claude Code, Cursor, Windsurf, Codex, Devin)

{
  "mcpServers": {
    "sms8": {
      "url": "https://mcp.sms8.io",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer YOUR_SMS8_API_KEY"
      }
    }
  }
}

Плагин Claude Code (одна команда)

/plugin marketplace add 1fancy/sms8-sms-gateway
/plugin install sms8-sms-gateway

Затем export SMS8_API_KEY=sk_xxx в вашей оболочке перед запуском Claude Code.

npx для клиентов stdio

{
  "mcpServers": {
    "sms8": {
      "command": "npx",
      "args": ["-y", "@sms8/mcp"],
      "env": { "SMS8_API_KEY": "sk_your_key" }
    }
  }
}

3. Мастер настройки

Панель управления на app.sms8.io/mcp-setup.php предварительно заполняет JSON для каждого AI-инструмента, показывает QR-код для сопряжения устройства, если необходимо, и включает форму для тестовой отправки SMS.

4. Спросите свой AI

Add SMS verification to my signup flow using the sms8 MCP.

AI вызовет setup_sms8, затем send_otp и verify_otp и напишет рабочий код, который заработает с первой попытки.

Варианты использования

Это реальные однострочные команды, которые можно вставить в Claude Code, Cursor или Windsurf.

Верификация телефона при регистрации

Wire phone-number verification into this app using the sms8 MCP. Use
send_otp on /signup, verify_otp on /verify-phone. Render the remaining
attempts on error.

Уведомления о доставке заказа

When an order ships, send the customer an SMS with their tracking link
via the sms8 MCP.

Двусторонний почтовый ящик поддержки

Register a webhook with the sms8 MCP at https://my-app.com/sms-inbox.
Scaffold the handler that verifies the HMAC signature and routes inbound
SMS to the support queue.

Беспарольный вход по SMS

Replace the magic-link email login with SMS OTPs using the sms8 MCP.
6-digit code, 5-minute expiry, 5 attempts.

SMS 2FA для страниц администратора

Add SMS 2FA to /admin login via the sms8 MCP. Lock the account after
5 failed verify_otp attempts.

Готовые примеры кода

Каждый файл в examples/ готов к использованию, не имеет зависимостей и может быть скопирован. Это то, что AI генерирует после рукопожатия setup_sms8.

• php-send.php: минимальный класс Sms8Sender с send, sendOtp, verifyOtp
• js-fetch.js: клиент для Node / браузера / Cloudflare Worker (ESM и CommonJS)
• otp-flow.php: полный процесс верификации телефона (startSignup + verifySignup)
• webhook-handler.php: обработчик входящих SMS с проверкой HMAC-подписи

Часто задаваемые вопросы

Что такое MCP-сервер SMS8?

Конечная точка HTTPS на mcp.sms8.io, реализующая Model Context Protocol. AI-инструменты для разработки вызывают его интерфейс JSON-RPC для отправки SMS, создания OTP-кодов и настройки вебхуков. SMS маршрутизируются через сопряженный телефон Android с помощью платформы SMS8.

Чем это отличается от Twilio?

SMS8 использует ваш собственный телефон Android в качестве шлюза с вашей существующей SIM-картой. Нет платы за сообщение оператору, не требуется регистрация A2P 10DLC и выделение телефонного номера. Вы платите фиксированную сумму по тарифу и отправляете неограниченное количество SMS. MCP-сервер предоставляет семь инструментов, которые ваш AI-ассистент может вызывать напрямую, чего Twilio не предлагает.

Работает ли это с Claude Code?

Да. Добавьте MCP-сервер в ~/.config/claude/mcp-servers.json с HTTP-транспортом, указывающим на https://mcp.sms8.io, и ваш API-ключ SMS8 в качестве Bearer-токена. Или выполните /plugin marketplace add 1fancy/sms8-sms-gateway, а затем /plugin install sms8-sms-gateway.

Работает ли это с Cursor и Windsurf?

Да. Оба поддерживают HTTP MCP-серверы. Добавьте https://mcp.sms8.io с вашим API-ключом в качестве Bearer-заголовка в ~/.cursor/mcp.json (Cursor) или ~/.codeium/windsurf/mcp_config.json (Windsurf). Мастер настройки на app.sms8.io/mcp-setup.php предварительно заполняет JSON для каждого инструмента.

Может ли AI автоматически добавить проверку OTP?

Да. Встроенный навык Claude Code (skills/send-sms/SKILL.md) учит ассистента, когда вызывать send_otp и verify_otp и как обернуть существующий маршрут регистрации или входа шагом верификации. Достаточно команды вроде "добавь верификацию телефона к /signup".

Является ли исходный код открытым?

Да, под лицензией MIT. Сервер, все семь реализаций инструментов, npm-лаунчер (@sms8/mcp), манифест плагина Claude Code и примеры кода находятся в этом репозитории.

Что происходит с моим API-ключом?

Ваш API-ключ аутентифицирует каждый вызов инструмента MCP через заголовок Authorization: Bearer (или X-Api-Key). Размещенный сервер проверяет его по вашему аккаунту SMS8, затем маршрутизирует вызов через существующий конвейер отправки SMS8. Ответ setup_sms8 возвращает только последние четыре символа вашего ключа, поэтому он никогда не попадает в историю чата AI или логи.

Безопасно ли использовать это в продакшене?

Да. Серверная защита включает:

• Ограничение скорости для каждого ключа, унаследованное от API SMS8
• Жесткий лимит в 5 OTP на номер телефона за 24 часа, не настраивается пользователем
• Задержка повторной отправки от 30 до 600 секунд (по умолчанию 60 секунд)
• Конечные точки OTP только для POST; GET возвращает 405; файлы cookie игнорируются
• Проверки ограничения скорости, обернутые в транзакции с блокировкой строк; параллельные вызовы не могут превысить лимиты
• HMAC-SHA256 подписи вебхуков
• Комплексный список блокировки SSRF на create_webhook, охватывающий RFC1918, CGNAT, link-local, IPv4-mapped IPv6 и хосты, разрешенные через DNS
• CORS объявляется только для методов обнаружения; tools/call не включает CORS, поэтому вредоносная веб-страница не может инициировать отправку SMS

Могу ли я разместить MCP-сервер самостоятельно?

Да. Клонируйте репозиторий, установите SMS8_APP_PATH в каталог установки SMS8 и запустите:

git clone https://github.com/1fancy/sms8-sms-gateway.git
cd sms8-sms-gateway
export SMS8_APP_PATH=/path/to/your/sms8-install
php -S 127.0.0.1:8080 index.php

Размещенный сервер на mcp.sms8.io бесплатен и проще для большинства пользователей.

Что такое "vibe coding"?

Vibe coding — это создание работающего программного обеспечения путем описания желаемого на простом английском языке AI-ассистенту вместо написания каждой строки вручную. SMS8 MCP делает один из самых частых запросов ("добавь SMS-уведомления") возможным без необходимости заходить в портал оператора или оформлять документы A2P.

Безопасность и секреты

Этот репозиторий не содержит секретов. Все учетные данные хранятся в переменных окружения или конфигурации MCP вашего AI-инструмента:

SMS8_API_KEY=sk_…        # from app.sms8.io → Profile → API
SMS8_WEBHOOK_SECRET=…    # from app.sms8.io → Webhook

Полную информацию о безопасности см. в разделе FAQ выше. Отдельный отчет об аудите безопасности доступен по запросу.

Структура репозитория

.
├── README.md                       this file
├── LICENSE                         MIT
├── index.php                       MCP server entry (JSON-RPC dispatcher)
├── landing.html                    marketing landing at mcp.sms8.io
├── .claude-plugin/plugin.json      Claude Code plugin manifest
├── .mcp.json                       MCP server config referenced by the plugin
├── skills/send-sms/SKILL.md        teaches Claude when to invoke SMS8 tools
├── npm-packages/                   five published npm packages
│   ├── sms8-mcp/                   MCP stdio bridge (sms8-mcp)
│   ├── sms8-cli/                   universal CLI (sms8)
│   ├── sms-otp-using-myphone/      OTP-only brand of the CLI
│   ├── phone-sms-gateway/          phone-as-gateway brand of the CLI
│   └── send-sms-from-android/      Android-first brand of the CLI
├── lib/                            Auth, JsonRpc, ToolRegistry
├── tools/                          7 tool implementations
└── examples/                       PHP and JS drop-in samples

План развития

• HTTP MCP-сервер работает на mcp.sms8.io
• Конечные точки OTP с ограничением злоупотреблений на номер телефона
• npm-пакеты sms8-mcp, sms8-cli, sms-otp-using-myphone, phone-sms-gateway, send-sms-from-android
• Плагин и навык Claude Code
• Поддержка MMS
• Автоматическая маршрутизация входящих SMS в AI для генерации ответов
• Настраиваемые в панели управления лимиты скорости для каждого инструмента
• Примеры кода на Python, Go и Ruby

Участие в разработке

Предложения и запросы на включение изменений приветствуются на github.com/1fancy/sms8-sms-gateway. Перед крупными изменениями открывайте обсуждение.

Лицензия

MIT. См. LICENSE.

Ключевые слова

model context protocol, mcp server, mcp sms, claude code sms, claude code mcp, cursor mcp, windsurf mcp, sms api, otp api, sms gateway, android sms gateway, twilio alternative, vibe coding, ai sms integration, sms notifications, send sms from claude, send sms from cursor, phone verification api, sms otp, 2fa sms, webhook sms, inbound sms, two-way sms, unlimited sms, no per-message fees, no A2P 10DLC, ai coding tools, sms8