VirtualSMS — Claude Code MCP server: receiving SMS verification codes
VirtualSMS receives SMS verification codes using physical SIM cards across 145+ countries. Helps AI agents register accounts in 2000+ services without VoIP flags.
no license 7,933 installs updated 2026-03-15
claude mcp add --transport http virtualsms-mcp https://virtualsms-mcp--virtualsms.run.toolsWhat VirtualSMS does
This MCP server connects AI agents to real physical SIM numbers. Physical routing passes carrier lookup checks that block eSIM and VoIP numbers on strict fraud-monitoring services like Telegram, WhatsApp, PayPal, or Google. Coverage spans 2000+ services and 145+ countries.
The server provides 18 tools for pricing discovery, number purchases, and code retrieval. The virtualsms_wait_for_sms tool buys a number and waits for the message via WebSocket, falling back to polling if the connection drops. If an incoming message fails to arrive, virtualsms_swap_number replaces the line at no extra cost before an SMS is delivered.
You must configure VIRTUALSMS_API_KEY before querying balances or placing orders. Order history requests have a hard server limit of 50 entries per retrieval.
What it helps with
- receive verification codes for accounts on WhatsApp, Telegram, or Google
- bypass anti-fraud carrier lookup checks targeting virtual VoIP numbers
- find the cheapest available country for a specific service using
virtualsms_find_cheapest - replace non-responsive phone numbers without duplicate charges via
virtualsms_swap_number
Example prompts for the agent
- Purchase a number for Telegram registration and wait for the code
- Check the cheapest countries available for WhatsApp verification
- Check my current account balance using VirtualSMS
How to install VirtualSMS
Platform CLI: remote server
claude mcp add --transport http virtualsms-mcp https://virtualsms-mcp--virtualsms.run.toolsPlatform CLI: remote server
codex mcp add virtualsms --url https://virtualsms-mcp--virtualsms.run.toolsConfig file
{
"mcpServers": {
"virtualsms": {
"url": "https://virtualsms-mcp--virtualsms.run.tools"
}
}
}Config file
{
"servers": {
"virtualsms": {
"type": "http",
"url": "https://virtualsms-mcp--virtualsms.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http virtualsms https://virtualsms-mcp--virtualsms.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about VirtualSMS
How to install VirtualSMS in Claude Code?
Run claude mcp add --transport http virtualsms-mcp https://virtualsms-mcp--virtualsms.run.tools in your terminal.
What does VirtualSMS do?
It allows AI assistants to rent temporary phone numbers on physical SIMs and receive SMS codes across 2000+ platforms.
What happens if a verification code does not arrive?
Call virtualsms_swap_number to get a new number for the same country and service without additional fees, or invoke virtualsms_cancel_order to request a refund.