Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI: remote server All methods and platforms ↓
claude mcp add --transport http virtualsms-mcp https://virtualsms-mcp--virtualsms.run.tools
Open on GitHub

What 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.tools

Step 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.

Similar MCP servers

All MCP servers for Agent setup: memory, context, orchestration →

Project sponsors

Companies that keep this analytics open