# VirtualSMS

VirtualSMS receives SMS verification codes using physical SIM cards across 145+ countries. Helps AI agents register accounts in 2000+ services without VoIP flags.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 7933 installs
- Author: virtualsms
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/virtualsms/virtualsms-mcp
- Updated: 2026-03-15
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/virtualsms

## What it 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.

## Requirements
- Remote server: `https://virtualsms-mcp--virtualsms.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http virtualsms-mcp https://virtualsms-mcp--virtualsms.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add virtualsms --url https://virtualsms-mcp--virtualsms.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "virtualsms": {
            "url": "https://virtualsms-mcp--virtualsms.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "virtualsms": {
            "type": "http",
            "url": "https://virtualsms-mcp--virtualsms.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http virtualsms https://virtualsms-mcp--virtualsms.run.tools
```

## When to use it
- 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
- 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

## Similar
- [sms](https://affpapa.org/en/nevibecode/mcp/sms.md) — MCP server · ★ 9 repo stars
- [Quackr](https://affpapa.org/en/nevibecode/mcp/quackr.md) — MCP server
- [asms](https://affpapa.org/en/nevibecode/mcp/asms.md) — MCP server
- [create-phone-number](https://affpapa.org/en/nevibecode/skills/create-phone-number.md) — skill · 973 installs
- [voidmob-mcp](https://affpapa.org/en/nevibecode/mcp/voidmob-mcp.md) — MCP server · ★ 13 repo stars
- [security-patterns](https://affpapa.org/en/nevibecode/skills/eyadkelleh-security-patterns.md) — skill · 663 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
