| name | sms-skill |
| description | Receive SMS verification codes via carrier-issued mobile phone numbers across 145+ countries and 2,500+ services. Use this skill whenever an AI agent needs to verify a phone number, receive an OTP/2FA code, sign up for a service that requires SMS verification, rent a long-term number, or buy a matching-country proxy. The skill exposes 40 tools through the VirtualSMS MCP server (also available as REST API and x402 micropayment endpoint) covering balance checks, country/service discovery, ordering numbers, polling for SMS delivery, swapping unfulfilled orders, managing rentals, and buying proxies. Trigger on any user request mentioning SMS verification, phone number rental, OTP, 2FA codes, account signup automation, Telegram/Discord/WhatsApp/Google verification, proxies, or activation codes. |
| license | MIT |
| compatibility | Works with Claude Desktop, Claude Code, Cursor, Codex CLI, Windsurf, Cline, Zed, OpenClaw, and any MCP-compatible client. Also usable directly via REST API or x402-gated HTTP calls. Requires a VirtualSMS API key (sign up free at https://virtualsms.io) or a Base-mainnet wallet for x402 payments. Network access required. |
| metadata | {"author":"virtualsms-io","homepage":"https://virtualsms.io","mcp_server":"https://mcp.virtualsms.io","api_docs":"https://virtualsms.io/api","npm_package":"virtualsms-mcp","category":"communication","tags":"sms, otp, 2fa, verification, phone-numbers, rentals, proxy, mcp, x402, agent-tools","countries":"145+","services":"2500+"} |
VirtualSMS: Account Verification for AI Agents
VirtualSMS is an account verification platform for developers and AI agents. It combines one-time SMS verification, dedicated number rentals, matching-country proxies and private cloud browser sessions behind one API, one MCP server and one prepaid balance.
When to use this skill
Activate this skill whenever the user (or another agent) needs to:
- Sign up for a service that requires phone verification (Telegram, Discord, WhatsApp, Google, Twitter/X, Tinder, Uber, etc.)
- Receive a one-time password (OTP) or 2FA code on a real phone number
- Rent a dedicated number (1 to 30 days) for ongoing inbound SMS
- Buy a matching-country residential, mobile or datacenter proxy
- Launch a private cloud browser session alongside a number and proxy (beta)
- Verify an account at scale across multiple countries
- Automate signup flows that hit an SMS gate
- Look up which countries / services / prices are currently available
VirtualSMS numbers are carrier-issued mobile numbers, backed by real physical SIM cards on operators like Vodafone, O2 and T-Mobile, not VoIP, so they pass carrier-lookup checks (HLR/Twilio Lookup/etc.) that flag VoIP and eSIM-only numbers as fraudulent.
What this skill does
Exposes a stable contract for account verification, number rentals and proxies via three interchangeable transports:
- MCP server (recommended):
npx virtualsms-mcp or remote https://mcp.virtualsms.io. 40 tools registered.
- REST API:
https://virtualsms.io/api/v2/*, bearer-auth with API key.
- x402 endpoint: pay-per-call with USDC on Base mainnet, no account needed.
All three transports back the same data plane.
Prerequisites
- API key from https://virtualsms.io (free signup), OR
- Base-mainnet wallet with USDC balance for x402-gated endpoints
- Network access to
*.virtualsms.io
Setup
Claude Code / Claude Desktop (recommended)
claude mcp add --scope user virtualsms -- npx -y virtualsms-mcp
Cursor
Add to .cursor/mcp.json:
{
"mcpServers": {
"virtualsms": {
"command": "npx",
"args": ["-y", "virtualsms-mcp"],
"env": { "VIRTUALSMS_API_KEY": "sk_live_..." }
}
}
}
Codex CLI / Windsurf / OpenClaw
See examples/mcp-install.md for per-client config snippets.
Direct REST (no MCP)
curl -H "Authorization: Bearer $VIRTUALSMS_API_KEY" \
https://virtualsms.io/api/v2/services
Tool inventory
40 MCP tools total. Discovery, account, order, rental and proxy tools are
itemized below; private cloud browser session tools (beta) are not yet
itemized here, see mcp.virtualsms.io for the current full list.
Discovery (6 tools)
| Tool | What it returns |
|---|
list_services | All 2,500+ services available across countries |
list_countries | All 145+ countries with stock indicators |
get_price | Price for a specific (service, country) pair |
find_cheapest | Lowest available price for a service, across countries |
search_services | Natural-language service match ("telega" -> Telegram) |
check_number | Validate or inspect a phone number |
Account (4 tools)
| Tool | Purpose |
|---|
get_balance | Current USD balance |
get_profile | Account email, tier, plan |
get_stats | Lifetime activations + spend |
get_transactions | Deposit + spend ledger |
Order management (11 tools)
| Tool | Purpose |
|---|
create_order | Buy a number for (service, country) |
get_order | Read current state of an order |
list_orders | Paginated active + recent orders |
order_history | Past orders with filters |
get_sms | Poll for SMS on an order (use for cron / batch) |
wait_for_sms | WebSocket wait, returns instantly when SMS arrives |
swap_number | Replace a number that did not receive SMS (free) |
cancel_order | Cancel before SMS arrives (full refund if no SMS yet) |
cancel_all_orders | Bulk cancel |
retry_order | Retry a failed or expired order |
start_manual_registration_session | Manual, browser-assisted registration flow |
Rentals (10 tools)
| Tool | Purpose |
|---|
create_rental | Start a dedicated-number rental |
get_rental | Read rental state |
list_rentals | List active and past rentals |
extend_rental | Add time to an active rental |
cancel_rental | Cancel a rental |
release_rental | End a rental early |
rentals_available | Check rental availability |
rentals_price | Price for a single rental option |
rentals_pricing | Full rental pricing table |
rentals_services | Services eligible for rental |
Proxies (4 tools)
| Tool | Purpose |
|---|
buy_proxy | Purchase a matching-country proxy |
list_proxies | List proxies you have purchased |
list_proxy_catalog | Browse the proxy catalog |
rotate_proxy | Rotate a proxy to a new IP |
Recommended flow
1. find_cheapest(service="telegram", country=null)
2. create_order(service="telegram", country="ru") -> returns order_id + phone_number
3. Trigger the verification on the target site using phone_number
4. wait_for_sms(order_id, timeout=180) -> returns code
5. If no code: swap_number(order_id) (free) and retry, OR cancel_order(order_id) for full refund
Pricing
Pricing is pulled from the live API: exact prices are returned by get_price and find_cheapest at request time. Indicative range starts from $0.05/code for high-volume services and scales by country and service. Always quote real prices from the API, never hardcode.
x402 endpoints are settled per-call in USDC on Base mainnet, no account, no minimum.
Numbers
Most "virtual number" services route through VoIP/eSIM ranges that fail carrier-lookup checks (Twilio Lookup, HLR queries, NumVerify, etc.). Services that care about verification quality (banks, KYC platforms, large social networks) reject those ranges. VirtualSMS numbers are carrier-issued mobile numbers, backed by real physical SIM cards, across 145+ countries, so they survive deep-verification flows.
Safety notes
- Don't rent numbers for fraud, account takeover, harassment, or any prohibited use. VirtualSMS retains the right to refuse service and ban accounts that violate the terms at https://virtualsms.io/terms.
- One number is not one user. A number may be reused for different services across renters; always poll only your own
order_id to read the SMS.
- Codes expire. If
wait_for_sms times out, prefer swap_number (free) over creating a new order.
- API keys are bearer credentials. Treat like passwords; rotate from https://virtualsms.io/dashboard if leaked.
Examples
See examples/ for end-to-end recipes:
examples/verify-discord.md: sign up for Discord with a Russian numberexamples/verify-telegram.md: receive a Telegram login codeexamples/rent-long-term.md: rent a number for a week of inbound SMSexamples/x402-payment.md: pay-per-call without an accountexamples/mcp-install.md: install snippets for 6+ MCP-compatible clients
API reference
See docs/api-reference.md for full REST + MCP endpoint documentation.
Links
License
MIT: see LICENSE.
