sms-skill

VirtualSMS Agent Skill — real-SIM SMS verification across 145+ countries and 2,500+ services for Claude, Cursor, Codex, Windsurf, and any MCP-compatible AI agent.

What is this?

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 tasks.

VirtualSMS provides physical-SIM phone numbers for receiving SMS and OTP codes — passing carrier-lookup checks that flag VoIP/eSIM numbers as fraudulent — across 145+ countries and 2,500+ services.

Quick install

Claude Code / Claude Desktop

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.

Cursor / Windsurf / Codex / OpenClaw

See examples/mcp-install.md.

Direct REST or x402 (no MCP)

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.

What's in this repo

Path	Purpose
SKILL.md	Canonical Agent Skill manifest (frontmatter + instructions)
examples/	End-to-end recipes for common verification tasks
docs/api-reference.md	REST + MCP endpoint reference
package.json	npm metadata for ecosystem discovery
LICENSE	MIT

Coverage

• 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 country_pricing.
• Transports: MCP server, REST API, x402 (USDC on Base)

Discovery on AI agent directories

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.

Related repos

• 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

Contributing

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

License

MIT © VirtualSMS — see LICENSE.

Links

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