Platfone - Receive SMS & Virtual Numbers MCP

официальный

Платформа виртуальных телефонных номеров для AI-агентов — аренда номеров в более чем 200 странах, получение SMS и управление полным жизненным циклом активации

GitHub

Что можно делать с Platfone Receive SMS & Virtual Numbers MCP?

Проверить баланс счета — Попросите ИИ получить ваши общие, зарезервированные и доступные средства с помощью get_balance.
Проверить стоимость и доступность — Проверьте цены и доступность номеров для пары страна-услуга с помощью check_price перед заказом.
Заказать виртуальный номер — Арендуйте временный номер телефона по стране и названию услуги через order_number, чтобы получить ID активации и номер телефона.
Опрашивать полученные SMS — Проверьте, пришел ли SMS-код для активации, с помощью check_sms, возвращается статус и рекомендации по опросу.
Запросить новое SMS — Запустите бесплатную повторную попытку получить еще одно SMS на тот же номер с помощью retry_activation.
Отменить и вернуть средства — Освободите активную активацию и верните зарезервированные средства с помощью cancel_activation до получения SMS.

Документация

Platfone MCP Server

Platfone предоставляет виртуальные телефонные номера для верификации аккаунтов, тестирования и автоматизации рабочих процессов. Platfone MCP сервер позволяет AI-агентам получать временные номера и принимать SMS-сообщения от MCP-совместимых клиентов, таких как Claude, VS Code Copilot, Codex и др.

📖 Документация · 🔧 Руководство по настройке · 🔑 Получить API ключ · 📦 npm

Почему MCP?

Вместо ручной интеграции API, AI-агенты могут:

Автономно заказывать номера по стране и названию сервиса
Ожидать SMS-коды
Повторять попытки или отменять активации

Всё через структурированные вызовы инструментов — без необходимости в собственном бэкенде.

Возможности

Полный жизненный цикл активации — от заказа номера до получения SMS
Кэшированный каталог с ETag — страны и сервисы кэшируются в памяти с TTL 5 минут и условным обновлением на основе ETag — никогда не передаются агенту
Удобные для человека входные данные — используйте "Израиль" или "Telegram" вместо идентификаторов; имена автоматически разрешаются на стороне сервера
Двойной транспорт — stdio и http из единой кодовой базы
Аутентификация по API ключу — работает с вашим существующим API ключом Platfone

Установка

См. полное Руководство по установке для подробных инструкций.

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

NPM:

PLATFONE_API_KEY=your_key npx @platfone/mcp

Инструменты

Инструмент	Описание
`get_balance`	Проверить баланс аккаунта: общие, зарезервированные и доступные средства.
`check_price`	Проверить цену и доступность для пары страна + сервис перед заказом.
`order_number`	Заказать виртуальный номер телефона. Принимает названия ("Израиль") или ID ("il"). Возвращает `activation_id` + `phone`.
`check_sms`	Проверить состояние активации. Возвращает SMS-код при получении или текущий статус с инструкциями по опросу.
`retry_activation`	Запросить еще одно SMS на тот же номер. Бесплатно.
`cancel_activation`	Отменить активную активацию до получения SMS. Возвращает зарезервированную сумму.

Примечание: Каталоги стран и сервисов кэшируются на стороне сервера и автоматически разрешаются из читаемых имен. Агент никогда не получает полный каталог — только разрешенные идентификаторы или подсказки для устранения неоднозначности.

Типичный рабочий процесс AI-агента

1. check_price         (country: "Israel", service: "Telegram")  → verify cost & availability
2. order_number        (country: "Israel", service: "Telegram")  → returns activation_id + phone
3. check_sms           (activation_id)                            → poll or check once for SMS

Опциональные шаги:

retry_activation — запросить еще одно SMS на тот же номер (бесплатно)
cancel_activation — отменить до получения SMS (возврат средств на баланс)

Разработка

Прочтите полное Руководство по разработке для инструкций по настройке и советов по тестированию.

Устранение неполадок

Ошибка	Решение
`UnauthorizedException`	Проверьте, действителен ли ваш `PLATFONE_API_KEY`
`PaymentRequiredException`	Пополните баланс Platfone
`NoNumbersAvailableException`	Попробуйте другую страну или сервис
`TooManyRequestsException`	Превышен лимит запросов — подождите и повторите попытку
`MaxPriceExceededException`	Повторите `order_number` с предложенным `max_price` и возвращенным `order_id`
`TooManyActivationsException`	Достигнут максимум одновременных активных активаций — отмените или дождитесь истечения срока

Лицензия

См. LICENSE.md. Лицензировано под MIT License.

Использование API Platfone регулируется Условиями предоставления услуг и Политикой конфиденциальности.