Sms MCP Server

Quick links: Quickstart · Why VirtualSMS · What you can build · Tools · Questions · Examples · Changelog · Security policy · Status. Its 40 documented tools cover proxy, order, rentals, rental.

People connecting this server to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-07-19 · ★ 8 · #386 OF 848 MAINTAINED OTHER · VERIFIED 2026-08-25

MIT · TypeScript servers · how we verify → /methodology

01 · Install Sms

before you install - you'll need

Set VIRTUALSMS_API_KEY before connecting.

Claude Code

claude mcp add virtualsms-io-mcp-server --transport http https://mcp.virtualsms.io/mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "virtualsms-io-mcp-server": {
      "url": "https://mcp.virtualsms.io/mcp"
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

https://mcp.virtualsms.io/mcp

transport: streamable-http

endpoint responds (non-MCP reply - review) · probed 2026-08-25

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions · remote - your agent's requests go to mcp.virtualsms.io

license MIT - declared in the repository

npm package virtualsms-mcp - unscoped; check the name against the project README before installing

registry namespace io.github.virtualsms-io is GitHub-verified and matches the repo owner

03 · What Sms can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can cancel and refund, if no SMS arrived. 120s cooldown after purchase, request a fresh exit IP for an existing proxy, and ask for the SMS to be resent to the same number. Not all order types support it.

Capability map

Tools grouped from the project's README - what Sms lets an agent do.

read & search

9 tools - e.g. All available countries. Optional service filter; Price and availability for a service plus country pair; Cheapest countries for a service, sorted by price, with real stock counts

list_countries · get_price · find_cheapest · get_balance · get_profile · get_stats…

Proxy

9 tools - e.g. Pool types, countries, and price per GB. Start here; Cities, states, ASNs, or ZIPs for a pool type plus country. No purchase required; Purchase proxy traffic in GB. Returns credentials and remaining…

list_proxy_catalog · list_proxy_locations · buy_proxy · generate_proxy_endpoint · rotate_proxy · test_proxy…

Order

5 tools - e.g. Buy a number for a service plus country. Returns order_id and phone_number; Full order detail plus every received message; Past orders with status, service, country, and date filters

create_order · get_order · order_history · cancel_order · retry_order

Rentals

4 tools - e.g. Full Access pricing tiers: durations and prices; Countries with rental stock, counts, and pricing, per tier; Retail price for a service, country, and duration combination

rentals_pricing · rentals_available · rentals_price · list_rentals

Rental

4 tools - e.g. Rent a number. Check availability and price first; Full detail for one rental: tier, number, service lock, status, expiry, SMS; Extend an active rental. Charges the current catalog price

create_rental · get_rental · extend_rental · cancel_rental

Services

3 tools - e.g. All available verification services. Optional search filter; Natural-language service lookup. "telega" finds Telegram; Services available for Platform-tier rental in a country, with stock and price

list_services · search_services · rentals_services

Orders

2 tools - e.g. Your active orders. Essential for crash recovery; Bulk-cancel every active order

list_orders · cancel_all_orders

Wait

1 tool - e.g. Block until the SMS lands on an existing order_id, or until timeout

wait_for_sms

Latest releases

v1.1.1 · 2026-04-24

VirtualSMS MCP Server v1.1.1 - docs + metadata polish · Non-breaking patch release. No tool changes, no API changes. Pure documentation and metadata alignment. · What changed · README: · Added 10 MCP client config…

v1.1.0 · 2026-04-24

VirtualSMS MCP Server v1.1.0 · Ranked #1 in ChatGPT's SMS verification MCP category · verified 2026-04-25 · New tools (6 added, 12 → 18 total) · Account (3 new): · get_profile - full account profile (email, Telegram…

v1.0.8 · 2026-03-20

VirtualSMS MCP Server v1.0.8 · MCP server for VirtualSMS - receive SMS verification codes with AI agents. · Get available countries and services · Rent virtual phone numbers · Receive SMS verification codes · Cancel…

04 · Who maintains Sms

sms is maintained by virtualsms-io. It's the only MCP server we track from this author; the repo dates to Mar 2026.

05 · Facts

repository: github.com/virtualsms-io/mcp-server
category: other - ranked #386 of 848 actively-maintained other servers as of 2026-08-25.
registry: io.github.virtualsms-io/sms (active, first published 2026-03-21 · 6 versions)
packages: npm:virtualsms-mcp

06 · Sms FAQ

Is Sms still maintained?

Yes - as of 2026-08-25, its last commit was 2026-07-19. We re-verify nightly.

What can Sms do?

How do I install Sms?

Run `npx -y virtualsms-mcp`. The README documents one environment variable (VIRTUALSMS_API_KEY) to set first. Set VIRTUALSMS_API_KEY before connecting. You can also paste the ready-made client config above.

Does Sms run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Sms

Alternatives to Sms

Maintained other servers if Sms isn't the fit.

More MCP servers to compare · Voidmob MCP · Lific · Webcake Landing · Kernelcad · Codex MCP Go

More TypeScript MCP servers · Media Context MCP · Jshookmcp · React Render Profile MCP · Pincer · see all