io.github.virtualsms-io/sms
io.github.virtualsms-io/sms · v1.2.3 · MCP 2025-11-25
Real SIM phone numbers for AI agents. 145+ countries, 2500+ services. #1 on ChatGPT and Perplexity.
Reachability
reachable
checked 2026-07-14 04:30 UTC
Registry status active
Tools pinned 18
0bfb663d6d50
Tools last changed
unchanged since first capture 2026-07-14
Provenance
Registry namespace io.github.virtualsms-io
(GitHub-account verified by the official registry)
Repository
github.com/virtualsms-io/mcp-server
Remote endpoints
https://mcp.virtualsms.io/mcp (streamable-http)
Observed changes
| When (UTC) | Event | Detail |
|---|---|---|
| 2026-07-14 03:22 | first capture | 18 tools pinned |
Pinned tool definitions (18)
| Tool | Description |
|---|---|
| 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. Returns status, phone_number, and (when delivered) messages[] array plus an extracted code. Poll this every 5-10 seconds after buying a number, or use wait_for_sms to... |
| 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. **Cooldown:** cancel is only available 120 seconds after purchase. Check... |
| virtualsms_wait_for_sms | Wait (block) until the SMS arrives on an existing order_id, or until timeout. Uses real-time WebSocket delivery with automatic polling fallback. Pass an order_id from create_order. To buy AND wait in one step, call create_order then this tool. |
| 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. **Cooldown:** swap is only available 120 seconds after purchase.... |
| 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". |
Status badge
[](https://toolpin.dev/servers/io.github.virtualsms-io/sms)
Maintain this server? Add the badge to your README — it links your users to this live status page.