VirtualSMS Agent Skill: account verification, number rentals and matching-country proxies across 145+ countries and 2,500+ services for Claude, Cursor, Codex, Windsurf, and any MCP-compatible AI agent.

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.

This repository is a public Agent Skill, an Agent Skills-compliant package that lets AI agents (Claude Code, Cursor, Codex, Windsurf, OpenClaw, Cline, Zed, and any MCP-aware client) automatically discover and use VirtualSMS for phone-number verification, rental and proxy tasks.

VirtualSMS numbers are carrier-issued mobile numbers, backed by real physical SIM cards on operators like Vodafone, O2 and T-Mobile, not VoIP, passing carrier-lookup checks that flag VoIP/eSIM numbers as fraudulent, across 145+ countries and 2,500+ services.

claude mcp add --scope user virtualsms -- npx -y virtualsms-mcp
export VIRTUALSMS_API_KEY=sk_live_...

Then drop a copy of SKILL.md into your project's .claude/skills/sms-skill/ directory, or install via your skill marketplace.

See examples/mcp-install.md.

curl -H "Authorization: Bearer $VIRTUALSMS_API_KEY" \
  https://virtualsms.io/api/v2/services

x402 endpoints accept pay-per-call USDC on Base mainnet, no account required. See examples/x402-payment.md.

• 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)

• Countries: 145+
• Services: 2,500+ (Telegram, Discord, WhatsApp, Google, Twitter/X, Tinder, Uber, banking, gig-economy, niche...)
• Pricing: from $0.05/code, real-time pricing returned by API. Never hardcode; call find_cheapest or get_price.
• Transports: MCP server (40 tools), REST API, x402 (USDC on Base)

This skill is published for indexing by:

• Skills.sh leaderboard
• SkillsMP marketplace
• Claude Code Marketplaces
• SkillsLLM
• AgentSkill.sh
• Agent Skill Index
• Skills Directory
• SkillsAuth

If you're a directory maintainer and want this skill listed manually, open an issue and we'll provide whatever metadata your indexer needs.

• virtualsms-io/mcp-server: the MCP server source
• virtualsms-io/api-docs: REST API documentation
• virtualsms-io/examples: Python / Node.js / cURL recipes
• virtualsms-io/claude-skill-sms-verification: Claude-Desktop-specific skill drop-in
• virtualsms-io/cursor-rules-sms-verification: Cursor .mdc rules
• virtualsms-io/codex-sms-verification: Codex CLI config
• virtualsms-io/windsurf-workflow-sms: Windsurf .windsurfrules
• virtualsms-io/openclaw-skill-sms: OpenClaw skill manifest

PRs welcome for additional examples, client configs, or documentation improvements. For SKILL.md format changes, follow the Agent Skills specification.

MIT (c) VirtualSMS: see LICENSE.

• virtualsms.io: main site
• virtualsms.io/api: REST API docs
• mcp.virtualsms.io: hosted MCP endpoint
• status.virtualsms.io: uptime
• virtualsms.io/contact: support