mcp.virtualsms.io

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

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

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

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

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_

Check if an SMS verification code has been received for an order. Returns status, phone_number, and (when delivered) messages[] array plus an extracte

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 diff

Wait (block) until the SMS arrives on an existing order_id, or until timeout. Uses real-time WebSocket delivery with automatic polling fallback. Pass

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 de

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

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 is

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

Get the full details of a specific order, including status, phone number, service, country, timestamps, and any received SMS code/text. Use this when

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

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-

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

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

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