Cursor Rules: SMS Verification with Real SIM Numbers

July 18, 2026 · View on GitHub

Drop-in .cursor/rules/virtualsms.mdc that teaches Cursor when and how to use the VirtualSMS MCP server for real-SIM SMS verification, number rentals, matching-country proxies and cloud browser sessions.

License: MIT npm version Powered by VirtualSMS MCP Server

What this is

VirtualSMS is an account verification platform for developers and AI agents. It combines one-time SMS verification, dedicated number rentals, matching-country proxies and private cloud browser sessions behind one API, one MCP server and one prepaid balance.

  • receive one-time SMS codes from $0.05
  • rent dedicated numbers from 1 to 30 days
  • buy matching-country residential, mobile and datacenter proxies
  • launch private cloud browser sessions that work alongside your number and proxy (beta)

A single .mdc Cursor rules file that activates whenever your agent needs to receive an SMS code, acquire a verification phone number, rent a number, get a matching-country proxy, 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 other MCP clients.

Real SIMs across 2500+ services and 145+ countries (growing weekly), 40 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.

Quick install: Local (stdio via npm)

  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 40 virtualsms_* tools appear in the MCP tool list, and the rule activates whenever you ask Cursor to handle SMS / OTP, rental, or proxy flows.

What this gets your agent

  • Receive one-time SMS codes from $0.05, across 2500+ services and 145+ countries
  • Rent dedicated numbers from 1 to 30 days
  • Buy matching-country residential, mobile and datacenter proxies
  • Launch private cloud browser sessions that work alongside your number and proxy (beta)
  • Find the cheapest available number for a service, single tool call
  • Receive SMS codes via WebSocket (wait_for_sms), instant return, or poll on your own schedule (get_sms)
  • Swap a number that didn't deliver, no extra charge
  • Cancel + refund unused orders, individually or in bulk
  • Account introspection: balance, transaction history, success rate, 30-day spend

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

Why real SIMs (not VoIP / eSIM)

Carrier-lookup APIs flag VoIP and eSIM ranges. Services that care, such as Tinder, Discord, WhatsApp, OnlyFans, Hinge and banking apps, silently reject those numbers. Carrier-issued mobile numbers, backed by real physical SIM cards on operators like Vodafone, O2 and T-Mobile, not VoIP, pass these checks. About 30% of services that fail on VoIP succeed with real SIMs.

Compatible services

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, and 2500+ more.

Cross-references

License

MIT, see LICENSE.