Claude Code, Cursor, Windsurf, OpenClaw, Codex, Hermes, Cline, Zed, Continue.dev

\n\n### Claude Code (CLI)\n\n```bash\nclaude mcp add --scope user virtualsms npx virtualsms-mcp -e VIRTUALSMS_API_KEY=vsms_your_api_key_here\n```\n\n### Cursor\n\nEdit `~/.cursor/mcp.json`:\n\n```json\n{\n \"mcpServers\": {\n \"virtualsms\": {\n \"command\": \"npx\",\n \"args\": [\"virtualsms-mcp\"],\n \"env\": {\n \"VIRTUALSMS_API_KEY\": \"vsms_your_api_key_here\"\n }\n }\n }\n}\n```\n\n### Windsurf\n\nEdit `~/.codeium/windsurf/mcp_config.json`:\n\n```json\n{\n \"mcpServers\": {\n \"virtualsms\": {\n \"command\": \"npx\",\n \"args\": [\"virtualsms-mcp\"],\n \"env\": {\n \"VIRTUALSMS_API_KEY\": \"vsms_your_api_key_here\"\n }\n }\n }\n}\n```\n\n### OpenClaw\n\nEdit `~/.openclaw/mcp.json`:\n\n```json\n{\n \"mcpServers\": {\n \"virtualsms\": {\n \"command\": \"npx\",\n \"args\": [\"virtualsms-mcp\"],\n \"env\": {\n \"VIRTUALSMS_API_KEY\": \"vsms_your_api_key_here\"\n }\n }\n }\n}\n```\n\n### Codex (OpenAI Codex CLI)\n\nEdit `~/.codex/config.toml`:\n\n```toml\n[mcp_servers.virtualsms]\ncommand = \"npx\"\nargs = [\"virtualsms-mcp\"]\nenv = { VIRTUALSMS_API_KEY = \"vsms_your_api_key_here\" }\n```\n\n### Hermes\n\nEdit your Hermes MCP config:\n\n```json\n{\n \"mcpServers\": {\n \"virtualsms\": {\n \"command\": \"npx\",\n \"args\": [\"virtualsms-mcp\"],\n \"env\": {\n \"VIRTUALSMS_API_KEY\": \"vsms_your_api_key_here\"\n }\n }\n }\n}\n```\n\n### Cline (VS Code)\n\nOpen the Cline MCP settings panel and add:\n\n```json\n{\n \"virtualsms\": {\n \"command\": \"npx\",\n \"args\": [\"virtualsms-mcp\"],\n \"env\": {\n \"VIRTUALSMS_API_KEY\": \"vsms_your_api_key_here\"\n }\n }\n}\n```\n\n### Zed\n\nEdit `~/.config/zed/settings.json`:\n\n```json\n{\n \"context_servers\": {\n \"virtualsms\": {\n \"command\": {\n \"path\": \"npx\",\n \"args\": [\"virtualsms-mcp\"],\n \"env\": {\n \"VIRTUALSMS_API_KEY\": \"vsms_your_api_key_here\"\n }\n }\n }\n }\n}\n```\n\n### Continue.dev\n\nEdit `~/.continue/config.yaml`:\n\n```yaml\nmcpServers:\n - name: virtualsms\n command: npx\n args:\n - virtualsms-mcp\n env:\n VIRTUALSMS_API_KEY: vsms_your_api_key_here\n```\n\n

\n\n### Does this work with ChatGPT?\n\nYes, via ChatGPT's Developer Mode. Open Settings, turn on Developer mode, then add `https://mcp.virtualsms.io/mcp` as a custom connector (Plus, Pro, Business, Enterprise and Edu plans; not available on the free tier). Setup is a URL paste rather than a config file, so it differs from the client setups above. ChatGPT only connects to remote MCP servers over SSE or streaming HTTP, so use the hosted endpoint, not the local stdio command. The [REST API](https://virtualsms.io/docs) is still there if you would rather build a custom GPT or Action instead.\n\n---\n\n## Configuration\n\n| Variable | Required | Default | Description |\n|----------|----------|---------|-------------|\n| `VIRTUALSMS_API_KEY` | Yes, for account tools | none | Your VirtualSMS API key. Keys carry a `vsms_` prefix |\n| `VIRTUALSMS_BASE_URL` | No | `https://virtualsms.io` | API base URL |\n| `VIRTUALSMS_ENABLE_SESSIONS` | No | off | Serves 3 additional session-drive tools when set to `1`, `true` or `yes`. Off by default |\n| `VIRTUALSMS_ENABLE_RELEASE` | No | off | Serves the early-release rental tool when set to `1`, `true` or `yes`. Off by default while its refund terms are being settled |\n\n---\n\n## Tools\n\n40 tools by default. Set `VIRTUALSMS_ENABLE_SESSIONS=1` to expose 3 more.\n\nTool names are shown below without the `virtualsms_` prefix for readability. The real wire names are prefixed: `virtualsms_create_order`, `virtualsms_get_sms`, and so on.\n\n

Activation and account (18 tools)

\n\nThe core SMS verification surface: discover a service, price it, buy a number, get the code.\n\n| Tool | Auth | Description |\n|---|---|---|\n| `list_services` | Yes | All available verification services. Optional `search` filter |\n| `list_countries` | Yes | All available countries. Optional `service` filter |\n| `get_price` | No | Price and availability for a service plus country pair |\n| `find_cheapest` | No | Cheapest countries for a service, sorted by price, with real stock counts |\n| `search_services` | Yes | Natural-language service lookup. \"telega\" finds Telegram |\n| `get_balance` | Yes | Account balance in USD |\n| `get_profile` | Yes | Email, Telegram link, balance, lifetime spend, total orders, active API keys |\n| `get_stats` | Yes | Orders, success rate, spend, and status/service/country breakdown |\n| `get_transactions` | Yes | Transaction history with type, date range, and pagination filters |\n| `create_order` | Yes | Buy a number for a service plus country. Returns `order_id` and `phone_number` |\n| `get_sms` | Yes | Poll an order for the code. Use for batch and cron jobs |\n| `wait_for_sms` | Yes | Block until the SMS lands on an existing `order_id`, or until timeout |\n| `get_order` | Yes | Full order detail plus every received message |\n| `list_orders` | Yes | Your active orders. Essential for crash recovery |\n| `order_history` | Yes | Past orders with status, service, country, and date filters |\n| `cancel_order` | Yes | Cancel and refund, if no SMS arrived. 120s cooldown after purchase |\n| `cancel_all_orders` | Yes | Bulk-cancel every active order |\n| `swap_number` | Yes | Swap for a new number, same service and country, no extra charge. 120s cooldown |\n\n> **`get_sms` vs `wait_for_sms`:** `wait_for_sms` is the recommended default for interactive agent workflows. It blocks and returns the moment the SMS arrives over WebSocket. Use `get_sms` for batch jobs, cron-driven polling, or when you already manage your own polling loop.\n\n> **`wait_for_sms` takes an `order_id`, not a service and country.** Call `create_order` first, then pass the returned `order_id`. That is the two-step buy-and-wait flow.\n\n

\n\n

Rentals (9 tools)

\n\nKeep a number by the day instead of buying a single verification. Two tiers:\n\n- **Full Access:** local SIM inventory, for a whole number that works across any service. Every country in stock today lists 1, 7 and 30 days, at prices that vary per country. Durations and prices are not hardcoded here on purpose: call `rentals_available` for the live list per country and treat that as authoritative.\n- **Platform:** sourced via our global supplier network, locked to one chosen service, durations of 1, 3 or 7 days. Call `rentals_price` for the exact retail price of a (service, country, duration) combo.\n\nStock, durations and pricing all differ per tier and per country, so call `rentals_available` before committing to either. An active rental can be extended with `extend_rental` at the current catalog price, in the same durations its tier allows.\n\nBoth tiers carry the same refund terms: cancel for a full refund within 20 minutes of purchase and before the first SMS arrives. Platform cancels are additionally subject to a 2 minute minimum hold, so a cancel inside the first 2 minutes is rejected and has to be retried.\n\n| Tool | Auth | Description |\n|---|---|---|\n| `rentals_pricing` | Yes | Full Access pricing tiers: durations and prices |\n| `rentals_available` | Yes | Countries with rental stock, counts, and pricing, per tier |\n| `rentals_services` | Yes | Services available for Platform-tier rental in a country, with stock and price |\n| `rentals_price` | Yes | Retail price for a service, country, and duration combination |\n| `create_rental` | Yes | Rent a number. Check availability and price first |\n| `list_rentals` | Yes | Your rentals across both tiers, filterable by status |\n| `get_rental` | Yes | Full detail for one rental: tier, number, service lock, status, expiry, SMS |\n| `extend_rental` | Yes | Extend an active rental. Charges the current catalog price |\n| `cancel_rental` | Yes | Full refund, within 20 minutes of purchase and before any SMS |\n\n

\n\n

Proxy (10 tools)

\n\nMatching-country proxies, so the number and the IP agree. Three pools: residential, mobile and datacenter. Buy traffic by the GB, then generate a connection string.\n\n| Tool | Auth | Description |\n|---|---|---|\n| `list_proxy_catalog` | Yes | Pool types, countries, and price per GB. Start here |\n| `list_proxy_locations` | No | Cities, states, ASNs, or ZIPs for a pool type plus country. No purchase required |\n| `buy_proxy` | Yes | Purchase proxy traffic in GB. Returns credentials and remaining balance |\n| `list_proxies` | Yes | Your proxies with remaining GB and credentials. Returns `proxy_id` values |\n| `generate_proxy_endpoint` | Yes | Build a ready-to-use connection string: country, state, city, ZIP or ASN targeting, rotating or sticky, HTTP or SOCKS5 |\n| `rotate_proxy` | Yes | Request a fresh exit IP for an existing proxy |\n| `test_proxy` | Yes | Prove a proxy works. Reports exit IP, country, city, ISP, and latency |\n| `get_proxy_usage` | Yes | Cached GB used and remaining, plus request count, for one proxy |\n| `get_proxy_usage_history` | Yes | Per-day traffic and request series over the last 7 or 30 days |\n| `set_proxy_targeting` | Yes | Persist a default geo-targeting on a proxy sub-user |\n\n

\n\n

Other (3 tools)

\n\n| Tool | Auth | Description |\n|---|---|---|\n| `retry_order` | Yes | Ask for the SMS to be resent to the same number. Not all order types support it |\n| `check_number` | No | Carrier and line-type lookup for any E.164 number: mobile, landline or VoIP, plus spam risk |\n| `start_manual_registration_session` | Yes | **Beta, invite-only.** Start a country-matched cloud browser you drive yourself in a live viewer. Agent-driven navigation is a separate opt-in (the session tools). Join https://t.me/VirtualSMS_io for beta access |\n\n

\n\n

Session tools (3 more, off by default)

\n\n**Beta, invite-only.** The browser stack is early. It works, but the shape of these tools can still change and there is no stability guarantee yet. Join https://t.me/VirtualSMS_io for beta access and updates.\n\nServed only when `VIRTUALSMS_ENABLE_SESSIONS` is set to `1`, `true` or `yes`. Not exposed on the default surface.\n\n| Tool | Description |\n|---|---|\n| `navigate_session` | Navigate an active browser session to a URL |\n| `session_viewer` | Live viewer URL and current status for an active session |\n| `stop_session` | Stop an active browser session and release it |\n\n

\n\n---\n\n## Typical workflows\n\n### Get a verification code\n\n```\ncreate_order(service: \"telegram\", country: \"US\")\n→ {order_id: \"abc123\", phone_number: \"+14155552671\", status: \"pending\"}\n\nwait_for_sms(order_id: \"abc123\", timeout_seconds: 180)\n→ {success: true, code: \"12345\", delivery_method: \"websocket\", elapsed_seconds: 8}\n```\n\n### Find the cheapest country first\n\n```\nfind_cheapest(service: \"telegram\", limit: 3)\n→ {cheapest_options: [{country: \"PK\", price_usd: 0.05, ...}]}\n\ncreate_order(service: \"telegram\", country: \"PK\")\nwait_for_sms(order_id: \"abc123\")\n```\n\n### Number not receiving? Swap it\n\n```\nswap_number(order_id: \"abc123\")\n→ {order_id: \"def456\", phone_number: \"+628...\", status: \"waiting\"}\n```\n\n### Rent a number for a month\n\n```\nrentals_available(tier: \"full_access\")\n→ countries holding local SIM stock, each with its own duration and price list\n\ncreate_rental(tier: \"full_access\", country: \"FR\", duration_hours: 720)\n→ {rental_id: \"rnt_1\", phone_number: \"+33...\", expires_in_days: 30}\n```\n\nStock is per country and per tier, so discover first and rent second. `rentals_available(tier: \"platform\")` covers a different, service-locked catalogue.\n\n### Pair a number with a matching-country proxy\n\n```\nlist_proxy_catalog()\nbuy_proxy(pool_type: \"residential\", gb: 1, country_code: \"GB\")\ngenerate_proxy_endpoint(proxy_id: \"px_1\", country_code: \"GB\", protocol: \"socks5\")\n```\n\n---\n\n## Questions\n\n### What is account verification infrastructure?\n\nAccount verification infrastructure is the stack that gets a real account through a signup flow that demands a phone number. It has five layers, and a gap in any one of them fails the whole chain:\n\n1. **Numbers.** A carrier-issued mobile line, because the line type gets checked.\n2. **SMS.** The verification code, delivered to that number and readable by software rather than by a human holding a handset.\n3. **Proxy.** An IP in the same country as the number, so the two agree.\n4. **Browser.** A clean environment to drive the signup itself.\n5. **Automation.** An API or an agent that runs the chain end to end, unattended.\n\nMost providers sell the first two layers and leave you to source the rest, which is exactly where the number, the IP and the browser stop telling the same story. VirtualSMS provides the infrastructure behind all five.\n\n> VirtualSMS is an account verification platform for individuals, 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.\n\n### What is an MCP server for SMS verification?\n\nMCP (Model Context Protocol) is an open standard that lets an AI client call external tools. An MCP server for SMS verification exposes phone-number and verification-code operations as tools an agent can call directly, so the agent buys the number, waits for the code and reads it back without any glue code from you. This repo is that server for VirtualSMS: 40 tools covering verification, rentals and proxies. If you are not driving an agent at all, the same operations are available as a plain REST verification API.\n\n### When should I use this?\n\n- Your AI agent needs to sign in to or register an account that demands a phone number.\n- You are testing an OTP or signup flow and want fresh numbers on demand instead of a drawer of test SIMs.\n- You need a verification code retrieved automatically, in CI or in an unattended job.\n- You need a number and a matching-country IP that agree with each other.\n- You are driving signup automation in a browser and would rather the number, the IP and the browser came from one place than three.\n- You need a temporary phone number for one code, or a dedicated one you keep for up to 30 days.\n- You want per-code pricing from $0.05 with no subscription and no monthly number rental.\n\n### When should I NOT use this?\n\nHonest answers, so you do not waste an afternoon:\n\n- **You need to send SMS.** This platform receives; it does not send. Use a messaging provider such as Twilio.\n- **You need a permanent number for your business.** Verification numbers are temporary by design, and rentals run in days, not years. Buy a real line from a carrier.\n- **You need codes on a number you already own.** There is no port-in. The numbers come from our inventory.\n- **You are running A2P marketing campaigns.** Wrong tool entirely.\n- **You are trying to evade a platform's terms of service.** Whether your use complies with the terms of the service you verify against is your responsibility, not ours.\n\n### Can Claude or Cursor receive SMS verification codes?\n\nYes, through this server. Claude Code, Claude Desktop, Cursor, Windsurf, Cline, Zed, Continue.dev, Codex, OpenClaw and Hermes are all MCP clients, and each one is a config paste away (see [Client setup](#client-setup)). Once installed, \"buy a Telegram number and wait for the code\" is a request the agent can carry out end to end. ChatGPT can reach it too, through Developer Mode custom connectors (see [Does this work with ChatGPT?](#does-this-work-with-chatgpt)), or through the [REST API](https://virtualsms.io/docs) if you would rather not enable Developer Mode.\n\n### How do AI agents receive OTP codes automatically?\n\nTwo tool calls. `create_order` buys a number for a given service and country and returns an `order_id`. `wait_for_sms` then blocks on that `order_id` and returns the moment the code arrives, pushed over WebSocket, typically in 2 to 15 seconds. The agent never polls, never sleeps in a loop, and never needs a human to read a phone. If you would rather drive your own loop, `get_sms` polls a single order instead.\n\n### How is this different from Twilio?\n\nTwilio is a full communications platform: send and receive SMS and voice, long-lived numbers, A2P campaigns, the lot. VirtualSMS does one job, which is receiving verification codes on demand. The practical differences:\n\n- **Line type.** Twilio numbers are VoIP. Many services reject VoIP numbers at signup. VirtualSMS numbers are real physical SIM cards on carrier networks, so they resolve as mobile.\n- **Pricing shape.** Twilio bills you for a number every month whether you use it or not. VirtualSMS bills per code from $0.05, with no subscription.\n- **Direction.** Twilio sends and receives. This receives.\n\nIf you need to send messages, use Twilio. If you need to receive a verification code, this is purpose-built for it.\n\n### Why real physical SIM cards instead of VoIP?\n\nVerification systems check the line type of the number you give them. VoIP numbers are cheap and disposable at scale, so they correlate with fraud, and a large share of services reject them outright at signup. Real physical SIM cards sit on carrier networks and resolve as mobile, which is exactly what those checks are looking for: a non-VoIP number that behaves like a real handset.\n\nYou do not have to take that on faith. `check_number` runs a carrier and line-type lookup on any E.164 number, needs no API key, and will tell you whether a number reads as mobile, landline or VoIP.\n\n---\n\n## Alternatives and comparisons\n\nDevelopers searching for `textverified mcp`, `sms-activate mcp`, `5sim mcp`, `daisysms mcp` or `smspool mcp` are usually asking one question: which SMS verification provider can an AI agent drive natively? This section answers that without a scoreboard.\n\n**VirtualSMS** publishes this MCP server, so any MCP client calls it directly with no wrapper code: 40 tools, 2500+ services, 145+ countries, from $0.05 per code, on real physical SIM cards, plus number rentals and matching-country proxies from the same balance.\n\n**SMS-Activate** shut down in December 2025. If your integration pointed there, it is gone, and the migration is a new API key and a new base URL rather than a rewrite: the shape of the job, buy a number then read the code, is the same here.\n\n**TextVerified**, **5SIM**, **DaisySMS** and **SMSPool** are all active SMS verification providers, each with its own API, pricing, coverage and terms. Check their current documentation for what they offer today.\n\nWe deliberately do not publish a comparison table of competitors' prices, service counts or coverage. Those numbers move week to week, we have no privileged view into anyone else's inventory, and a stale table dressed up as research is worse than no table at all. The VirtualSMS numbers above are ours and we stand behind them. Compare them against whatever you are using now.\n\n---\n\n## How it works\n\n### WebSocket and polling\n\n`wait_for_sms` uses a two-tier delivery system:\n\n1. **WebSocket, instant.** Connects to `wss://virtualsms.io/ws/orders?order_id=xxx&api_key=your_key`. When the SMS arrives the server pushes it in real time. Typical delivery: 2 to 15 seconds.\n2. **Polling fallback.** If the WebSocket fails to connect or drops, the tool falls back to polling every 5 seconds for the remaining timeout.\n\nThe `delivery_method` field in the response tells you which path was used: `websocket`, `polling`, or `instant` when the code had already landed before you called.\n\nThis server pushes over a held-open WebSocket; it never calls you back. If you would rather VirtualSMS POST events to a URL you own, the platform runs a separate webhook subscription system, configured from the dashboard and driven by the REST API rather than by this MCP server.\n\n### Architecture\n\n```\nAI Agent (Claude / Cursor / Codex / Windsurf / any MCP client)\n │\n ▼ MCP (stdio or StreamableHTTP)\nVirtualSMS MCP Server (this package)\n │\n ├──► REST API: https://virtualsms.io/docs\n │ create_order, get_sms, cancel_order, get_balance ...\n │\n └──► WebSocket: wss://virtualsms.io/ws/orders\n real-time SMS push delivery\n```\n\n### Crash recovery\n\nIf your session is interrupted mid-verification:\n\n1. **Restart the MCP server.**\n2. **List active orders:** `list_orders(status: \"pending\")`\n3. **Check for codes:** `get_sms(order_id: \"abc123\")`\n4. **Cancel if not needed:** `cancel_order(order_id: \"abc123\")`\n\n`wait_for_sms` always returns `order_id`, even on timeout, so you can recover.\n\n---\n\n## Hosted endpoint and status\n\n- **Hosted MCP endpoint:** `https://mcp.virtualsms.io/mcp`. TLS-only StreamableHTTP, fronted by Cloudflare.\n- **Platform status and uptime:** [virtualsms.io/status](https://virtualsms.io/status), polled live: website and dashboard, SMS gateway, REST API, Telegram bot and database. The hosted MCP endpoint runs as a separate service and is not yet a row on that page.\n- **Target SLA:** 99.9% on the hosted MCP path. A target we hold ourselves to rather than a contractual guarantee, and one the status page above does not yet measure.\n- **Coverage:** 145+ countries online, 2500+ services indexed.\n- **Data retention:** SMS message bodies are retained 7 days, then permanently deleted. Order metadata (phone number, service, country, timestamps) is retained for the lifetime of your account. See [SECURITY.md](https://github.com/virtualsms-io/mcp-server/blob/main/SECURITY.md) for full details.\n- **Vulnerability disclosure:** email `security@virtualsms.io` or open a [private security advisory](https://github.com/virtualsms-io/mcp-server/security/advisories/new).\n\n👉 [Sign up at VirtualSMS.io](https://virtualsms.io)\n\n---\n\n## Examples\n\nThree runnable examples are checked into this repo. Each is `node run.mjs` away once `VIRTUALSMS_API_KEY` is set.\n\n- **[`examples/01-quick-balance-check/`](https://github.com/virtualsms-io/mcp-server/blob/main/examples/01-quick-balance-check/)**: 5-second hosted MCP smoke test (`get_balance`).\n- **[`examples/02-buy-sms-and-wait-for-code/`](https://github.com/virtualsms-io/mcp-server/blob/main/examples/02-buy-sms-and-wait-for-code/)**: full verification flow, `find_cheapest` → `create_order` → `wait_for_sms` → cancel-on-timeout. The canonical pattern for AI agents.\n- **[`examples/03-claude-desktop-config/`](https://github.com/virtualsms-io/mcp-server/blob/main/examples/03-claude-desktop-config/)**: drop-in Claude Desktop config plus a transcript of \"ask Claude what's my balance\" over StreamableHTTP.\n\n## SDKs and tools\n\nThe same platform, from whatever you already write in:\n\n| Repo | What it is |\n|---|---|\n| [node-sdk](https://github.com/virtualsms-io/node-sdk) | Official Node.js / TypeScript SDK |\n| [python-sdk](https://github.com/virtualsms-io/python-sdk) | Official Python SDK |\n| [virtualsms-php-sdk](https://github.com/virtualsms-io/virtualsms-php-sdk) | Official PHP SDK |\n| [ruby-sdk](https://github.com/virtualsms-io/ruby-sdk) | Official Ruby SDK |\n| [dotnet-sdk](https://github.com/virtualsms-io/dotnet-sdk) | Official .NET SDK |\n| [go-sdk](https://github.com/virtualsms-io/go-sdk) | Official Go SDK |\n| [rust-sdk](https://github.com/virtualsms-io/rust-sdk) | Official Rust SDK |\n| [swift-sdk](https://github.com/virtualsms-io/swift-sdk) | Official Swift SDK |\n| [java-sdk](https://github.com/virtualsms-io/java-sdk) | Official Java SDK |\n| [api-docs](https://github.com/virtualsms-io/api-docs) | REST API documentation source |\n| [examples](https://github.com/virtualsms-io/examples) | Runnable examples across languages |\n| [n8n-nodes-virtualsms](https://github.com/virtualsms-io/n8n-nodes-virtualsms) | n8n community nodes |\n| [automation-integrations](https://github.com/virtualsms-io/automation-integrations) | Make, Zapier and workflow integrations |\n| [virtual-number-checker](https://github.com/virtualsms-io/virtual-number-checker) | Carrier and line-type lookup tool |\n| [claude-skill-sms-verification](https://github.com/virtualsms-io/claude-skill-sms-verification) | Claude skill for SMS verification |\n| [cursor-rules-sms-verification](https://github.com/virtualsms-io/cursor-rules-sms-verification) | Cursor rules for SMS verification |\n\n---\n\n## Build and contribute\n\n```bash\ngit clone https://github.com/virtualsms-io/mcp-server.git\ncd mcp-server\nnpm install\nnpm run build # tsc\nnpm test # vitest\nnpx tsc --noEmit # typecheck only\n```\n\nTwo transports share one tool table: `src/index.ts` (stdio) and `src/http-server.ts` (StreamableHTTP). Tool definitions and handlers live in `src/tools.ts`. If you add a tool, wire it into **both** transports. `src/__tests__/transport-parity.test.ts` fails the build if you forget, and `src/__tests__/docs-tool-names.test.ts` fails if the docs name a tool that does not exist.\n\nIssues and pull requests: [github.com/virtualsms-io/mcp-server](https://github.com/virtualsms-io/mcp-server/issues).\n\nRelease notes for v1.0.0 to v1.3.1 are in [CHANGELOG.md](https://github.com/virtualsms-io/mcp-server/blob/main/CHANGELOG.md).\n\n## Security\n\nAPI keys are passed via the `x-api-key` header (hosted) or the `VIRTUALSMS_API_KEY` environment variable (local stdio), and are rotatable from your account at [virtualsms.io](https://virtualsms.io). Full policy, retention detail and disclosure process: [SECURITY.md](https://github.com/virtualsms-io/mcp-server/blob/main/SECURITY.md).\n\nReport vulnerabilities to `security@virtualsms.io`.\n\n## License\n\nMIT. See [LICENSE](https://github.com/virtualsms-io/mcp-server/blob/main/LICENSE).\n\nBuilt by [VirtualSMS.io](https://virtualsms.io/mcp). Account verification for developers and AI agents, on real physical SIM cards: 2500+ services · 145+ countries · from $0.05 per code.\n\n","changelogMarkdown","videoKey","requiredSecretsJson","[\"X_API_KEY\"]","publishedAt","priceCents","trialDays",0,"upstream",{"_112":113,"_114":115,"_116":117,"_118":119,"_120":121,"_122":123},"requiredSecrets",[111],"tags",[96,97,98,99,100,101,102,103,104,105,106,107,108,109,110],"assets",[],"stats",{"_94":83,"_95":83},"ratingAvg","reviewCount","ai-agent","claude-mcp","cline","codex","continue-dev","cursor","hermes","openclaw","otp","phone-verification","real-sim","sms","sms-activate-alternative","sms-verification","virtual-phone-number","X_API_KEY","topics",[96,97,98,99,100,101,102,129,21,130,103,104,105,106,107,108,109,110,131,132],"license","MIT","language","TypeScript","registryName","io.github.virtualsms-io/sms","homepage","https://virtualsms.io/mcp","packages",[124],{"_125":126,"_127":128,"_72":73},"registryType","npm","identifier","virtualsms-mcp","mcp","model-context-protocol","windsurf","zed","ENV",{"_135":136,"_137":138,"_139":140},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]

mcp server