VirtualSMS

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.

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.

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.

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.

Check your VirtualSMS account balance in USD. Requires VIRTUALSMS\_API\_KEY to be set.

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.

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

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

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.

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.

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

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

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.

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

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.

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.

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.

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.

Commonly used service codes for WhatsApp, Telegram, Google, and other top services.

Tips on finding the cheapest virtual numbers and maximizing your VirtualSMS budget.

Step-by-step guide to get your first SMS verification code with VirtualSMS MCP.

Check your VirtualSMS account balance and list all active orders in one shot.

Find the cheapest virtual phone number for any service. Returns top countries sorted by price with stock availability.

Recover an interrupted SMS verification session. Lists active orders and checks for pending verification codes — useful after a crash or timeout.

Universal SMS verification workflow. Searches for the service by name, finds the cheapest country, buys a number, and waits for the verification code.

Get a Google account verification code via virtual phone number. Useful for creating or recovering Google/Gmail accounts.

Complete workflow to verify a Telegram account with a virtual number. Automatically selects cheapest available country and waits for the SMS code.

Complete workflow to get a WhatsApp verification code using a virtual number. Finds the cheapest available country, buys a number, and waits for the SMS code automatically.