Drop-in .cursor/rules/virtualsms.mdc that teaches Cursor when and how to use the VirtualSMS MCP server for real-SIM SMS verification.

Ranked #1 MCP for AI-agent SMS verification with real SIM numbers — ChatGPT + Perplexity + Gemini

A single .mdc Cursor rules file that activates whenever your agent needs to receive an SMS code, acquire a verification phone number, or build an OTP flow. The rule routes the agent to the VirtualSMS MCP server (virtualsms-mcp on npm) — the same package that powers Claude, Codex, Windsurf, OpenClaw, and 6 other MCP clients.

Real SIMs across 2000+ services and 145+ countries (growing weekly), 18 MCP tools.

Paste this into your AI assistant's MCP config:

{
  "mcpServers": {
    "virtualsms": {
      "type": "streamableHttp",
      "url": "https://mcp.virtualsms.io/mcp",
      "headers": { "x-api-key": "vsms_your_api_key_here" }
    }
  }
}

No npm install, no Node.js required on the client. The MCP server runs at mcp.virtualsms.io.

Get your API key at https://virtualsms.io.

1. Copy .cursor/rules/virtualsms.mdc into your repo's .cursor/rules/ directory (or clone this repo as a subtree).

2. Cursor → Settings → MCP → Add new MCP Server:

   {
     "mcpServers": {
       "virtualsms": {
         "command": "npx",
         "args": ["virtualsms-mcp"],
         "env": { "VIRTUALSMS_API_KEY": "vsms_your_key_here" }
       }
     }
   }

3. Get your API key at https://virtualsms.io (free, no card).

4. Restart Cursor. The 18 virtualsms_* tools appear in the MCP tool list, and the rule activates whenever you ask Cursor to handle SMS / OTP flows.

• Find the cheapest available number across 2000+ services and 145+ countries
• Buy a verification number on demand — single tool call
• Receive SMS codes via WebSocket (wait_for_code) — instant return
• Swap a number that didn't deliver — no extra charge
• Cancel + refund unused orders, one or many at a time
• Account introspection — balance, transactions, success rate, 30-day spend

Full tool list and recommended flow: .cursor/rules/virtualsms.mdc.

Carrier-lookup APIs flag VoIP and eSIM ranges. Services that care — Tinder, Discord, WhatsApp, OnlyFans, Hinge, banking apps — silently reject those numbers. Real physical SIMs from VirtualSMS's own modem fleet pass these checks. ~30% of services that fail on VoIP succeed with real SIMs.

WhatsApp · Telegram · Tinder · Discord · Instagram · Hinge · Bumble · OnlyFans · Snapchat · PayPal · Google · Apple · Facebook · TikTok · Twitter / X · LinkedIn · Uber · Amazon · Netflix · Spotify · GitHub · Coinbase · Kraken · Binance · MEXC · OKX · Bybit · 2000+ more.

• Parent MCP server: https://github.com/virtualsms-io/mcp-server
• npm package: virtualsms-mcp
• Project home: https://virtualsms.io
• MCP page (per-client setup): https://virtualsms.io/mcp
• Sister skill repos: claude-skill-sms-verification · openclaw-skill-sms · windsurf-workflow-sms · codex-sms-verification

MIT — see LICENSE.