virtualsms-io/mcp-server

Покупает прокси-трафик (ГБ) для выбранного типа пула. Возвращает учётные данные прокси и оставшийся баланс. country_code здесь используется только как мягкое предпочтение при выделении ресурсов. Для фактического таргетинга на уровне конкретного соединения (country/state/city/zip/asn) или для готовой строки подключения используйте virtualsms_generate_proxy_endpoint после покупки. Чтобы закрепить таргетинг по умолчанию для субпользователя, используйте virtualsms_set_proxy_targeting.

Массово отменяет все активные ордера в вашем аккаунте. Возвращает количество отменённых ордеров и все ошибки. Полезен для быстрой очистки после пакетного запуска или тестовой сессии.

Отменяет заказ и запрашивает возврат средств. Работает только если SMS ещё не получено. Используйте это, если сервис работает слишком долго или вы хотите попробовать другой номер. Восстановление: отмена доступна только через 120 секунд после покупки. Проверьте cancel_available_at в заказе перед вызовом. Вызов раньше возвращает ошибку cooldown_active от этого MCP-сервера (без обращения к бэкенду).

Отменяет аренду с полным возвратом средств. Действует только в течение 20 минут после покупки И до получения любого SMS. Работает для любого уровня. За пределами этого окна аренда продолжается до естественного завершения.

Выполняет публичный поиск оператора связи и типа линии для произвольного номера телефона в формате E.164 (мобильный/стационарный/VoIP, риск спама). Не требует ключа API.

Покупает виртуальный номер телефона для SMS-верификации. Возвращает order_id и phone_number. Коды обычно приходят в течение ~10-60 секунд после покупки. Используйте get_sms для опроса кода верификации или wait_for_sms для ожидания до его получения.

Арендует номер телефона на длительный период (в отличие от одноразового номера через create_order). Два тарифа: "full_access" - локальный запас SIM-карт, работает с ЛЮБЫМ сервисом на этом номере. "platform" - поставка через нашу глобальную сеть поставщиков, привязан к ОДНОМУ выбранному сервису, срок аренды только 1/3/7 дней. У обоих тарифов одинаковые условия возврата: полный возврат в течение 20 минут после покупки и до получения первого SMS. Сначала проверьте rentals_available и rentals_price/rentals_pricing, чтобы подтвердить страну/сервис/срок.

Продлевает активную аренду на дополнительный период. Списывает средства с вашего баланса по текущей цене из каталога за этот период.

Находит самые дешёвые страны для указанного сервиса, отсортированные по цене. Возвращает доступные страны с ценами и уровнями запасов, чтобы вы могли выбрать лучший вариант.

Создаёт готовые к использованию строки прокси-подключения для собственного прокси: нацеливание на страну/штат/город/почтовый индекс/ASN, с ротацией или липкой сессией, HTTP или SOCKS5, в формате host:port:user:pass / user:pass@host:port / curl. Ничего не покупается и не изменяется на стороне сервера. Этот инструмент только составляет строку подключения из существующих учётных данных прокси (та же конвенция, что и в генераторе endpoint'ов панели VirtualSMS). Нацеливание на суб-страновые уровни (штат/город/почтовый индекс/ASN) тарифицирует собственные гигабайты прокси с коэффициентом 2x на пулах non-premium, бесплатно на residential_premium.

Проверяет баланс учетной записи VirtualSMS в долларах США. Требует, чтобы VIRTUALSMS_API_KEY был установлен.

Получает полные сведения о конкретном заказе, включая статус, номер телефона, услугу, страну, временные метки и любой полученный SMS-код/текст. Используйте этот инструмент, когда у вас есть order_id и требуется получить последнее состояние, выходящее за пределы того, что возвращает get_sms.

Проверяет цену и доступность для конкретной комбинации услуги и страны. Всегда проверяет цену перед покупкой, чтобы подтвердить доступность.

Полный профиль аккаунта: email, статус привязки Telegram, текущий баланс, общие расходы за всё время, общее количество заказов, активные API-ключи и дата создания аккаунта.

Получает объем использованного/оставшегося кеша в ГБ и количество запросов для одного прокси. Дешево, без upstream-вызова. Считывает кешированное значение, обновляемое примерно каждые 5 минут.

Получает ежедневный трафик (ГБ) и количество запросов для одного прокси за последние 7 или 30 дней.

Получает полные детали конкретной аренды по ID, включая уровень, номер телефона, страну, блокировку сервиса, статус, срок действия и любые полученные SMS. Сначала используйте list_rentals, если у вас нет rental_id.

Проверяет, получен ли SMS-код подтверждения для заказа. Возвращает status, phone_number и (при доставке) массив messages[] вместе с извлечённым кодом. Опрашивайте этот инструмент каждые 5-10 секунд после покупки номера или используйте wait_for_sms для блокировки до получения.

Статистика использования аккаунта, агрегированная из истории заказов: общее количество заказов, процент успешных, общая сумма расходов, популярные услуги/страны и разбивка по статусам за настраиваемый период.

История транзакций для аккаунта с опциональными фильтрами по типу, диапазону дат и пагинацией. Типы: "deposit", "purchase", "refund", "admin_credit".

Получает все доступные страны для SMS-верификации. Используйте это, чтобы узнать допустимые коды стран перед покупкой номера.

Выводит список ваших активных заказов. Необходимо для восстановления после сбоя. Если ваша сессия была прервана, воспользуйтесь этим, чтобы найти ожидающие заказы и их номера телефонов, затем используйте get_sms для получения кодов.

Перечисляет все прокси на вашем аккаунте с оставшимися ГБ и учётными данными для входа. Возвращает значения proxy_id для использования с get_proxy_usage, rotate_proxy, set_proxy_targeting и generate_proxy_endpoint.

Перечисляет доступные типы пулов прокси, страны и цену за ГБ. Используйте это перед покупкой прокси-трафика.

Перечисляет доступные города, штаты, ASN или ZIP-коды для типа пула и страны. Используйте его, чтобы получить допустимые значения location_code перед вызовом virtualsms_generate_proxy_endpoint или virtualsms_set_proxy_targeting с таргетингом внутри страны. Публичный эндпоинт, покупка не требуется. Недоступен для residential_premium (только residential, mobile, datacenter).

Выводит список ваших аренд в обоих уровнях, с возможностью фильтрации по статусу. Возвращает rental_id, tier, country, phone number, status и expiry для каждой. Используйте get_rental для получения полной информации об одной аренде.

Получает все доступные SMS-сервисы для верификации (Telegram, WhatsApp, Google и т.д.). Используйте это, чтобы узнать действительные коды сервисов перед покупкой номера.

Перечисляет прошлые заказы с опциональными фильтрами по статусу, услуге, стране и окну просмотра в днях. Возвращает до 50 заказов (ограничение сервера), отсортированных от самых новых к старым.

Выводит список стран с данными о наличии в аренде, доступных количествах и ценах. tier=full_access (по умолчанию) показывает инвентарь local-SIM; tier=platform показывает страны, доступные через нашу глобальную сеть поставщиков (с количеством услуг на страну и популярными услугами). Используйте это перед созданием аренды.

Получает розничную цену на основе каталога для комбинации аренды уровня платформы (сервис, страна, продолжительность).

Выводит список всех активных тарифных планов аренды (тариф Full Access: инвентарь локальных SIM-карт, длительности и цены). Это сырая выгрузка каталога, и она может содержать строки, которые недоступны для покупки сегодня, поэтому перед созданием аренды сверьтесь с rentals_available (авторитетный источник по каждой стране). Используйте rentals_price для тарификации платформы (по странам, по услугам) вместо этого.

Выводит список услуг, доступных для платформенной аренды в указанной стране, с указанием физических остатков на складе и розничной цены. Платформенная аренда привязывается к ОДНОЙ выбранной услуге на номер. Используйте эту команду, чтобы подобрать корректный код услуги перед её созданием.

Запрашивает у провайдера повторную отправку SMS на ТОТ ЖЕ номер телефона для существующего заказа (заказ должен находиться в статусе waiting/created). Не все типы заказов поддерживают это. Некоторые провайдеры вместо этого поддерживают только swap_number, который возвращает НОВЫЙ номер.

Запрашивает новый IP для существующего прокси. Полезно, когда конечная точка помечает текущий исходящий IP.

Находит правильный код сервиса с помощью естественного языка. Не знаете точный код? Просто выполните поиск "uber", "binance", "steam" и т.д. Возвращает подходящие сервисы с оценками схожести.

Сохраняет настройку геотаргетинга по умолчанию (страна и опционально города/ASN) для существующего подпользователя прокси. Только страна бесплатно. Добавление городов или ASN тарифицируется по 2x за гигабайт из ВАШЕГО собственного пула (не из residential_premium, где уточнённый таргетинг включён бесплатно). Это изменяет СОХРАНЁННУЮ настройку по умолчанию. Для одноразовой строки подключения с любым таргетингом (включая штат/индекс) используйте virtualsms_generate_proxy_endpoint.

Бета-версия, только по приглашениям. Запускает подобранный по стране облачный браузер, которым вы управляете самостоятельно: возвращает viewer_url, аутентифицированную ссылку для просмотра в реальном времени, которую вы открываете, чтобы наблюдать за сеансом и управлять им (ручное управление), плюс опционально номер телефона заказа и временную шкалу. Навигация с помощью агента — это отдельные подключаемые инструменты сеанса. Объединяется с create_order для получения OTP и браузера в одном потоке агента.

Заменяет номер телефона в существующем заказе. Получает новый номер для того же сервиса и страны без дополнительной платы. Используйте, когда текущий номер не принимает SMS. Cooldown: замена доступна только через 120 секунд после покупки. Проверьте swap_available_at в заказе перед вызовом. Вызов раньше возвращает ошибку cooldown_active с этого MCP-сервера (без обращения к бэкенду).

Выполняет один запрос через прокси и сообщает внешний IP, страну, город, провайдера и задержку. Проверяет, что прокси работает, и определяет страну, из которой он выходит. Расходует небольшой объём из выделенного трафика прокси (в ГБ). Частота вызова ограничена: примерно один раз в 20 секунд на прокси.

Ожидает (блокируется) до получения SMS для существующего order_id или до истечения таймаута. Коды обычно приходят в течение ~10-60 секунд. Этот вызов БЛОКИРУЕТ выполнение на время до timeout_seconds (по умолчанию 60, максимум 600) перед возвратом. Использует доставку через WebSocket в реальном времени с автоматическим переходом на опрос. Передайте order_id из create_order. Чтобы купить И дождаться за один шаг, вызовите create_order, затем этот инструмент.