# VirtualSMS

Real SIM phone numbers for AI agents performing SMS verification across 2000+ services (WhatsApp, Telegram, Tinder, Discord, Instagram, OnlyFans, Hinge, Bumble, PayPal, Google, Apple, Binance) and 14…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y smithery mcp add virtualsms/virtualsms-mcp

# Browse available tools
npx -y smithery tool list virtualsms/virtualsms-mcp

# Get full schema for a tool
npx -y smithery tool get virtualsms/virtualsms-mcp virtualsms_list_services

# Call a tool
npx -y smithery tool call virtualsms/virtualsms-mcp virtualsms_list_services '{}'
```

## Direct MCP Connection

Endpoint: `https://virtualsms-mcp--virtualsms.run.tools`

## Tools (18)

- `virtualsms_list_services` — Get all available SMS verification services (Telegram, WhatsApp, Google, etc.). Use this to discover valid service code…
- `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 conf…
- `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 …
- `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. F…
- `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…
- `virtualsms_wait_for_sms` — RECOMMENDED: One-step tool that buys a number AND waits for the SMS code automatically. Uses real-time WebSocket delive…
- `virtualsms_find_cheapest` — Find the cheapest countries for a given service, sorted by price. Returns available countries with prices and stock lev…
- `virtualsms_search_services` — Find the right service code using natural language. Don't know the exact code? Just search "uber", "binance", "steam" e…
- `virtualsms_swap_number` — Swap a phone number on an existing order. Gets a new number for the same service and country without additional charge.…
- `virtualsms_list_orders` — List your active orders. Essential for crash recovery — if your session was interrupted, use this to find pending order…
- `virtualsms_get_order` — Get the full details of a specific order, including status, phone number, service, country, timestamps, and any receive…
- `virtualsms_cancel_all_orders` — Bulk-cancel every currently active order in your account. Returns the number of orders cancelled plus any failures. Use…
- `virtualsms_order_history` — List past orders with optional filters for status, service, country, and a lookback window in days. Returns up to 50 or…
- `virtualsms_get_stats` — Account usage stats aggregated from your order history: total orders, success rate, total spend, top services/countries…
- `virtualsms_get_profile` — Full account profile: email, Telegram link status, current balance, lifetime spend, total orders, active API keys, and …
- `virtualsms_get_transactions` — Transaction history for the account with optional filters for type, date range, and pagination. Types: "deposit", "purc…

```bash
# Get full input/output schema for a tool
npx -y smithery tool get virtualsms/virtualsms-mcp <tool-name>
```

## Resources

- `virtualsms://docs/quickstart` — Step-by-step guide to get your first SMS verification code with VirtualSMS MCP.
- `virtualsms://docs/popular-services` — Commonly used service codes for WhatsApp, Telegram, Google, and other top services.
- `virtualsms://docs/pricing-tips` — Tips on finding the cheapest virtual numbers and maximizing your VirtualSMS budget.

## Prompts (7)

- `verify-whatsapp` (country) — Complete workflow to get a WhatsApp verification code using a virtual number. Finds the cheapest available country, buy…
- `verify-telegram` (country) — Complete workflow to verify a Telegram account with a virtual number. Automatically selects cheapest available country …
- `verify-google` (country) — Get a Google account verification code via virtual phone number. Useful for creating or recovering Google/Gmail account…
- `find-cheapest-number` (service, limit) — Find the cheapest virtual phone number for any service. Returns top countries sorted by price with stock availability.
- `verify-any-service` (service, country) — Universal SMS verification workflow. Searches for the service by name, finds the cheapest country, buys a number, and w…
- `recover-verification` — Recover an interrupted SMS verification session. Lists active orders and checks for pending verification codes — useful…
- `check-account-status` — Check your VirtualSMS account balance and list all active orders in one shot.

---

License: MIT