About
MCP server for ordering private phone numbers and reading SMS verification codes from agent clients.
Features
- Order private phone numbers for verification tasks in 200+ countries
- Poll for SMS codes and return parsed verification codes to the agent
- List countries, operators, and services before choosing a number
- Finish, cancel, or request another SMS for an activation
- Check account balance from an MCP client
- Generate RFC 6238 TOTP codes locally without sending the secret upstream
- Uses an SVN_API_KEY environment variable and avoids returning the API key in tool output
Use Cases
AI agent builders
Let an agent handle SMS verification flows from Claude Code, Codex, Cursor, Claude Desktop, or another MCP-compatible client.
QA and growth teams
Test signup and onboarding flows that require temporary phone numbers while keeping the steps inside an auditable agent workflow.
Automation engineers
Build repeatable phone-number verification workflows using explicit MCP tools instead of custom API glue code.
What This Server Can Do
MCP servers expose three types of capabilities to AI clients. Here's what SV Number MCP Server supports.
Tools
Supported9 toolsFunctions your AI client can call to perform actions — like querying a database, creating a file, or calling an API.
How to use: Tools run automatically when your AI client decides they're needed. Ask your AI assistant to perform a task, and it will invoke the right tool.
Resources
Not availableThis server does not expose read-only data resources.
Prompts
Not availableThis server does not provide pre-built prompt templates.
For the full list of available tools, resources, and prompts, check the README on GitHub.
Available Tools (9)
get_balanceReturn the account balance for the configured API key.
list_countriesList supported countries with IDs and operators.
list_servicesSearch services or sites by name or domain and return ranked matches with availability and price information.
order_numberOrder a private number for a chosen service and country.
wait_for_codePoll until the SMS code arrives and return the parsed code.
finish_activationMark an activation as successful.
cancel_activationCancel an activation and request a refund where supported.
request_another_smsRequest one more SMS on the same number.
totp_codeCompute authenticator codes locally using RFC 6238.