VirtualSMS

How to connect

• virtualsms_list_services

  Get all available SMS verification services (Telegram, WhatsApp, Google, etc.). Use this to discover valid service codes before buying a number.

• virtualsms_list_countries

  Get all available countries for SMS verification. Use this to discover valid country codes before buying a number.

• virtualsms_get_price

  Check the price and availability for a specific service + country combination. Always check price before buying to confirm availability.

• virtualsms_get_balance

  Check your VirtualSMS account balance in USD. Requires VIRTUALSMS_API_KEY to be set.

• virtualsms_create_order

  Purchase a virtual phone number for SMS verification. Returns order_id and phone_number. Use check_sms to poll for the verification code, or use wait_for_code to do it automatically.

• virtualsms_get_sms

  Check if an SMS verification code has been received for an order. Poll this every 5-10 seconds after buying a number. For automatic polling, use wait_for_code instead.

• virtualsms_cancel_order

  Cancel an order and request a refund. Only works if no SMS has been received yet. Use this if the service is taking too long or you want to try a different number.

• virtualsms_wait_for_sms

  RECOMMENDED: One-step tool that buys a number AND waits for the SMS code automatically. Uses real-time WebSocket delivery with automatic polling fallback. Always returns order_id in the response — even on timeout — so you can use check_sms to recover.

• virtualsms_find_cheapest

  Find the cheapest countries for a given service, sorted by price. Returns available countries with prices and stock levels so you can pick the best deal.

• virtualsms_search_services

  Find the right service code using natural language. Don't know the exact code? Just search "uber", "binance", "steam" etc. Returns matching services with similarity scores.

• virtualsms_swap_number

  Swap a phone number on an existing order. Gets a new number for the same service and country without additional charge. Use when the current number isn't receiving SMS.

• virtualsms_list_orders

  List your active orders. Essential for crash recovery — if your session was interrupted, use this to find pending orders and their phone numbers, then use check_sms to retrieve codes.

• virtualsms_get_order

  Get the full details of a specific order, including status, phone number, service, country, timestamps, and any received SMS code/text. Use this when you have an order_id and need the latest state beyond what check_sms returns.

• virtualsms_cancel_all_orders

  Bulk-cancel every currently active order in your account. Returns the number of orders cancelled plus any failures. Useful for quick cleanup after a batch run or test session.

• virtualsms_order_history

  List past orders with optional filters for status, service, country, and a lookback window in days. Returns up to 50 orders (server cap) ordered most-recent-first.

• virtualsms_get_stats

  Account usage stats aggregated from your order history: total orders, success rate, total spend, top services/countries, and status breakdown over a configurable lookback window.

• virtualsms_get_profile

  Full account profile: email, Telegram link status, current balance, lifetime spend, total orders, active API keys, and account creation date.

• virtualsms_get_transactions

  Transaction history for the account with optional filters for type, date range, and pagination. Types: "deposit", "purchase", "refund", "admin_credit".

Related servers