Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| VIRTUALSMS_API_KEY | Yes | Your VirtualSMS API key (required for auth tools) | |
| VIRTUALSMS_BASE_URL | No | API base URL | https://virtualsms.io |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {} |
| prompts | {} |
| resources | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_services | Get all available SMS verification services (Telegram, WhatsApp, Google, etc.). Use this to discover valid service codes before buying a number. |
| list_countries | Get all available countries for SMS verification. Use this to discover valid country codes before buying a number. |
| get_price | Check the price and availability for a specific service + country combination. Always check price before buying to confirm availability. |
| get_balance | Check your VirtualSMS account balance in USD. Requires VIRTUALSMS_API_KEY to be set. |
| create_number_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. |
| get_sms_code | 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. |
| 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. |
| wait_for_sms_code | 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. |
| find_cheapest_countries | 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. |
| 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. |
| swap_phone_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. |
| list_active_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. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| verify-whatsapp | 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. |
| verify-telegram | Complete workflow to verify a Telegram account with a virtual number. Automatically selects cheapest available country and waits for the SMS code. |
| verify-google | Get a Google account verification code via virtual phone number. Useful for creating or recovering Google/Gmail accounts. |
| find-cheapest-number | Find the cheapest virtual phone number for any service. Returns top countries sorted by price with stock availability. |
| verify-any-service | Universal SMS verification workflow. Searches for the service by name, finds the cheapest country, buys a number, and waits for the verification code. |
| recover-verification | Recover an interrupted SMS verification session. Lists active orders and checks for pending verification codes — useful after a crash or timeout. |
| check-account-status | Check your VirtualSMS account balance and list all active orders in one shot. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| Quickstart Guide | Step-by-step guide to get your first SMS verification code with VirtualSMS MCP. |
| Popular Services Reference | Commonly used service codes for WhatsApp, Telegram, Google, and other top services. |
| Pricing Tips | Tips on finding the cheapest virtual numbers and maximizing your VirtualSMS budget. |