🤖Model Context Protocol

Connect AI Assistants
to VirtSMS

Order virtual numbers, check SMS codes, and manage activations through natural language. Works with Claude, Cursor, Windsurf, and any MCP-compatible AI assistant.

✅Open Standard

🚀Zero Install

🔒HTTPS Secure

🛠️14 Tools

Get Started →API Docs

MCP Server Setup

Connect your AI assistant in under 2 minutes. No installation required.

Create an API Key

Open your account menu → click API → generate a new key with one click.

Paste the Config

Copy the JSON below and paste it into your AI assistant's MCP configuration file.

Restart & Use

Restart your AI assistant. VirtSMS tools appear right away. Try "What's my balance?"

MCP Server URL

https://mcp.virtsms.com/mcp

Configuration (JSON)

{
  "mcpServers": {
    "virtsms": {
      "type": "streamableHttp",
      "url": "https://mcp.virtsms.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Replace YOUR_API_KEY with a key from your API Keys page.

Config file location by assistant:

Claude Desktop (Mac)~/Library/Application Support/Claude/claude_desktop_config.json

Claude Desktop (Windows)%APPDATA%\Claude\claude_desktop_config.json

Claude CodeRun: claude mcp add virtsms --transport http https://mcp.virtsms.com/mcp

CursorSettings → MCP → Add Server

Windsurf~/.codeium/windsurf/mcp_config.json

Available Tools

14 tools your AI assistant can use through natural language.

get_balanceCheck your account balance

get_profileView full account profile

get_statsOrders, success rate, totals

get_transactionsTransaction history with filters

list_countriesAll available countries

list_servicesServices by country with prices

get_pricingReal-time pricing & deliverability

order_numberPurchase a virtual phone number

check_smsPoll for received SMS + extract code

get_orderFull order details & message history

cancel_orderCancel with automatic refund logic

cancel_all_ordersBulk cancel all active orders

list_active_ordersAll currently active orders

order_historyPast orders with date & status filters

Example Prompts

Try saying these to your AI assistant once connected to VirtSMS.

💰"What's my VirtSMS balance?"

💵"How much does a US number cost for WhatsApp?"

📱"Get me a UK number for Telegram"

📨"Check if my SMS code arrived on activation 1234"

📋"Show all my active numbers"

🌍"Which countries are cheapest for Google verification?"

❌"Cancel all my active orders and refund my balance"

📊"Show my VirtSMS stats and success rate"

🔍"Get me the cheapest number for Instagram"

📜"Show my last 10 activations"

Common Questions

Everything you need to know before connecting.

Ready to connect your AI assistant?

Get your free API key and start using VirtSMS through natural language in minutes.