sv-number · sv-number — Claude Code MCP server: order phone numbers, read SMS
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.
MIT ★ 429 updated 2026-08-10
claude mcp add mcp-server -e SVN_API_KEY=<SVN_API_KEY> -- npx -y sv-number-mcpWhat mcp-server 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.
What it helps with
- 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 for the agent
- 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
How to install mcp-server
Platform CLI
claude mcp add mcp-server -e SVN_API_KEY=<SVN_API_KEY> -- npx -y sv-number-mcpReplace <…> with your own values
Platform CLI
codex mcp add sv-number-mcp-server --env SVN_API_KEY=<SVN_API_KEY> -- npx -y sv-number-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"sv-number-mcp-server": {
"command": "npx",
"args": [
"-y",
"sv-number-mcp"
],
"env": {
"SVN_API_KEY": "<SVN_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"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
Platform CLI
gemini mcp add -e SVN_API_KEY=<SVN_API_KEY> sv-number-mcp-server npx -y sv-number-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mcp-server
How do I install sv-number in Claude Code?
Run claude mcp add mcp-server -e SVN_API_KEY=<SVN_API_KEY> -- npx -y sv-number-mcp with your API key from the sms-verification-number.com profile.
What does sv-number do?
The server lets your agent order temporary phone numbers in 200+ countries and read verification SMS codes via the sms-verification-number.com API. Nine tools cover ordering, waiting for codes, cancellation, and balance checks.
Do I need a funded account to use sv-number?
Yes, your sms-verification-number.com account must have a balance — the API has no free tier. Check your key and balance with the get_balance tool.
Similar MCP servers
All MCP servers for Agent setup: memory, context, orchestration →mcp-server by other authors comes first.