Drop-in .windsurfrules that teaches Cascade 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 .windsurfrules file that activates Cascade's awareness of the VirtualSMS MCP server whenever your agent needs to receive an SMS code, acquire a verification phone number, or build an OTP flow. Same virtualsms-mcp npm package that powers Claude, Cursor, Codex, 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. Drop .windsurfrules into your repo root (or fork this repo and reference its raw URL).

2. Cascade → Settings → MCP servers → add:

   {
     "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 Windsurf. Cascade now knows when to invoke the 18 virtualsms_* tools.

• Find the cheapest available number across 2000+ services and 145+ countries
• Buy a verification number on demand — single tool call returns the number plus an order id
• Receive SMS codes via WebSocket (wait_for_code) — instant return for interactive agent flows
• Or poll on your own schedule (check_sms) for batch / cron jobs
• Swap a number that didn't deliver — no extra charge
• Cancel + refund unused orders, one or many
• Account introspection — balance, transactions, success rate, 30-day spend

Full reference: .windsurfrules.

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 carrier checks. ~30% of services that break 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 · cursor-rules-sms-verification · codex-sms-verification

MIT — see LICENSE.