# mcp-server

The mcp-server server gives your agent nine tools to order temporary phone numbers and read verification codes from SMS via the sms-verification-number.com API.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 429 repo stars
- Author: sv-number
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/sv-number/mcp-server
- Updated: 2026-08-10
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/sv-number-mcp-server

## What it does

The agent calls `order_number` with a service code and country, gets a number, waits for the SMS with `wait_for_code`, and retrieves the code already extracted from the message. The server polls the API at a sensible interval, translates error tokens into actionable sentences, and stops polling after 20 minutes. The catalogue covers 200+ countries; `list_services` searches for a site's code by name or domain and shows the delivery rate where statistics exist.

You need an API key from your sms-verification-number.com profile and a funded balance — there's no free tier. The key is read from the `SVN_API_KEY` environment variable and never leaves the process. The server receives codes but won't send messages or work for bank or government registrations.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `SVN_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mcp-server -e SVN_API_KEY=<SVN_API_KEY> -- npx -y sv-number-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add sv-number-mcp-server --env SVN_API_KEY=<SVN_API_KEY> -- npx -y sv-number-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "sv-number-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "sv-number-mcp"
            ],
            "env": {
                "SVN_API_KEY": "<SVN_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "sv-number-mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "sv-number-mcp"
            ],
            "env": {
                "SVN_API_KEY": "<SVN_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e SVN_API_KEY=<SVN_API_KEY> sv-number-mcp-server npx -y sv-number-mcp
```
Replace <…> with your own values

## When to use it
- order a number for Telegram or Discord signup
- retrieve a verification code and close the activation
- find a site's service code by domain and pick the country with the best delivery rate
- check your balance and list available operators
- generate a TOTP code locally per RFC 6238

## Example prompts
- Order a number for Telegram in Indonesia and wait for the code
- Show my balance on sms-verification-number.com and list countries with operators
- Find the service code for discord.com, show prices and delivery rates

## Similar
- [sms-10dlc-registration](https://affpapa.org/en/nevibecode/skills/sms-10dlc-registration.md) — skill · 2900 installs
- [sent-profile-provisioning](https://affpapa.org/en/nevibecode/skills/sent-profile-provisioning.md) — skill · 2700 installs
- [sms-alert](https://affpapa.org/en/nevibecode/skills/sms-alert.md) — skill · 185 installs
- [api](https://affpapa.org/en/nevibecode/mcp/api.md) — MCP server
- [Buy UK eSIM](https://affpapa.org/en/nevibecode/mcp/buy-uk-esim.md) — MCP server · 1005 installs
- [twilio-whatsapp-manage-senders](https://affpapa.org/en/nevibecode/skills/twilio-whatsapp-manage-senders.md) — skill · 1 install

## Other versions with the same name
- [mcp-server · heyputer](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — ★ 44226 repo stars
- [mcp-server · mapbox](https://affpapa.org/en/nevibecode/mcp/mapbox-mcp-server.md) — ★ 373 repo stars
- [mcp-server · packmindhub](https://affpapa.org/en/nevibecode/mcp/packmindhub-mcp-server.md) — ★ 327 repo stars
- [mcp-server · bingowon](https://affpapa.org/en/nevibecode/mcp/bingowon-mcp-server.md) — ★ 117 repo stars
- [mcp-server · ui5](https://affpapa.org/en/nevibecode/mcp/ui5-mcp-server.md) — ★ 109 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
