# Sv Number MCP Server (MCP server)

> Sv Number MCP Server is an MCP server that adds messaging tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Phone numbers for AI agents: order a private number, read the SMS verification code, hand it back. It has 546 GitHub stars, is released under the MIT license and runs locally with npx -y sv-number-mcp.

Phone numbers as tools. Your agent orders a private number in the country a service expects, reads the SMS verification code straight from the API, and hands the number back. Nine tools over stdio, no SDK to learn.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/sv-number/mcp-server |
| GitHub stars | 546 |
| License | MIT |
| Language | JavaScript |
| Transport | stdio |
| Packages | npm: sv-number-mcp |
| Remote URL | none |
| Needs API key | yes |
| Official | no |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | Communication |
| Latest release | none |
| Last commit | Aug 10, 2026 |
| MCP registry name | io.github.sv-number/mcp-server |

## Install

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "sv-number-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "sv-number-mcp"
      ],
      "env": {
        "SVN_API_KEY": "your-value"
      }
    }
  }
}
```

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --env SVN_API_KEY=your-value --transport stdio sv-number-mcp-server -- npx -y sv-number-mcp
```

### Cursor (.cursor/mcp.json)

```json
{
  "mcpServers": {
    "sv-number-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "sv-number-mcp"
      ],
      "env": {
        "SVN_API_KEY": "your-value"
      }
    }
  }
}
```

Project file; use ~/.cursor/mcp.json to enable it in every project.

### VS Code (.vscode/mcp.json)

```json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "svn_api_key",
      "description": "SVN_API_KEY",
      "password": true
    }
  ],
  "servers": {
    "sv-number-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "sv-number-mcp"
      ],
      "env": {
        "SVN_API_KEY": "${input:svn_api_key}"
      }
    }
  }
}
```

Config formats checked against the official docs on 2026-10-07.

## Environment variables

- `SVN_API_KEY` (secret) (required): API key from the sms-verification-number.com profile page

## Tools

- `get_balance`: what is left on the account
- `list_countries`: every country with its id and operators
- `list_services`: find the code for a site: search by name or domain, best match first, price, how many are online, and the share of…
- `order_number`: order a private number for one service in one country
- `wait_for_code`: poll until the code lands and return it, already parsed out of the SMS
- `finish_activation`: close a successful activation
- `cancel_activation`: cancel and get the money back
- `request_another_sms`: ask for one more code on the same number
- `totp_code`: compute the authenticator code locally, by RFC 6238

## Similar MCP servers

- [Strata](https://appsgit.com/mcp-servers/strata): MCP server for progressive tool usage at any scale (see https://klavis.ai). (5,807 stars, Apache-2.0, official)
- [Vexa](https://appsgit.com/mcp-servers/vexa): Meeting bot and transcripts for Google Meet, Teams and Zoom. (2,856 stars, Apache-2.0, official, needs API key)
- [MCP Server for WinDbg Crash Analysis](https://appsgit.com/mcp-servers/mcp-server-for-windbg-crash-analysis): A Model Context Protocol server for Windows crash dump analysis using WinDbg/CDB. (1,607 stars, MIT)
- [Rocketmq Rust](https://appsgit.com/mcp-servers/rocketmq-rust): 🚀 Apache RocketMQ built in Rust 🦀 — faster, safer, and more memory-efficient. (1,524 stars, Apache-2.0)
- [Wassette](https://appsgit.com/mcp-servers/wassette): Wassette: A security-oriented runtime that runs WebAssembly Components via MCP. (957 stars, MIT, official)
- [Line Bot MCP Server](https://appsgit.com/mcp-servers/line-bot-mcp-server): MCP server that integrates the LINE Messaging API to connect an AI Agent to the LINE Official Account. (783 stars, Apache-2.0, official, needs API key)

---

Canonical page: https://appsgit.com/mcp-servers/sv-number-mcp-server
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.