servers / codex-sms-verification
codex-sms-verification MCP server
communitystreamable_httplocaldestructive capablehealthy
OpenAI Codex CLI — real-SIM SMS verification via VirtualSMS MCP. Drop-in .codex/config.toml, 18 tools, 2000+ services, 145+ countries.
01Tools · 18
How to read this: tool names here are observed from a live tools/list handshake. The Risk label is a heuristic inferred from the tool name (write/destructive verbs), not from executing the tool — a conservative guess, not a verified capability. We never escalate risk from a description. Found one that's wrong? Tell us — we fix on report.
| Tool | Risk | Side effects | Approval |
|---|---|---|---|
| virtualsms_list_services Get all available SMS verification services (Telegram, WhatsApp, Google, etc.). Use this to discover valid service codes before buying a number. | read | false | unknown |
| virtualsms_list_countries Get all available countries for SMS verification. Use this to discover valid country codes before buying a number. | read | false | unknown |
| virtualsms_get_price Check the price and availability for a specific service + country combination. Always check price before buying to confirm availability. | read | false | unknown |
| virtualsms_get_balance Check your VirtualSMS account balance in USD. Requires VIRTUALSMS_API_KEY to be set. | read | false | unknown |
| 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. | write | true | unknown |
| 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 block until delivery. | read | false | unknown |
| 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 `cancel_available_at` on the order before calling. Calling earlier returns a `cooldown_active` error from this MCP server (no backend round-trip). | destructive | true | true |
| 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. | unknown | unknown | unknown |
| 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. | read | false | unknown |
| 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. | read | false | unknown |
| 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. Check `swap_available_at` on the order before calling. Calling earlier returns a `cooldown_active` error from this MCP server (no backend round-trip). | read | false | unknown |
| 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. | read | false | unknown |
| 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. | write | true | unknown |
| 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. | destructive | true | true |
| 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. | write | true | unknown |
| 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. | read | false | unknown |
| virtualsms_get_profile Full account profile: email, Telegram link status, current balance, lifetime spend, total orders, active API keys, and account creation date. | read | false | unknown |
| virtualsms_get_transactions Transaction history for the account with optional filters for type, date range, and pagination. Types: "deposit", "purchase", "refund", "admin_credit". | read | false | unknown |
02Install & source
https://mcp.virtualsms.io/mcp
remote_url- repohttps://github.com/virtualsms-io/codex-sms-verification
- homepagehttps://virtualsms.io/mcp
- licenseMIT
- adoption19 stars · 1 forks
05Provenance & freshness
sourcesGitHub repo search [p4]
last_checked2026-07-09 08:02Z
next_check2026-07-11 07:58Z
cadenceevery 48h
verifiedtools_list:passed handshake:passed metadata:passed
index_statusindex — 8 unique facts >= 5
06Badge
Add the “as seen on MCPExplorer” badge to your README. 
[](https://mcpexplorer.com/servers/codex-sms-verification)
Next step
This is one server. A loadout combines the right servers, governance, and proven plays for a whole job — assembled deliberately, not tool-dumped.
Explore loadouts →