Practical overview
When it fits
Use it when an agent workflow needs a short-lived phone number to receive an SMS verification code and return that code to the workflow.
Who it is for
- Developers configuring an MCP client to give an AI agent access to SMS-based activation tools.
- Agent builders adding number lookup, ordering and code retrieval to a signup workflow.
Documented uses
- Find a service by name or URL and inspect available service and country information.
- Order a number for a selected service and country, then retrieve its SMS verification code.
- Finish or cancel an activation, request another SMS, check account balance, or generate an RFC 6238 authenticator code locally.
Requirements & limits
The README requires signup to obtain an API key and says the API balance must be funded; it has no free tier. Setup instructions cover Claude Code and JSON-configured clients including Codex, Cursor and Claude Desktop.
- The server communicates over stdio and exposes nine tools.
- Service listings include price, live online pool and delivery-rate information; delivery statistics may be null for a service-country pair.
- The documented number workflow is limited to receiving SMS: numbers do not send messages or take calls.
- The README says the numbers are not intended for banking, payment or government accounts and describes a 20-minute number lifetime.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Configure the MCP server in Claude Code
Add the SV Number MCP server to Claude Code using an API key.
Before you start
- Claude Code
- Node.js tooling to run the package with npx
- An SVN_API_KEY obtained after signup
- A funded service balance; the API has no free tier
Steps
Obtain an API key from your profile after signup.
Run the README's Claude Code command with the key supplied as SVN_API_KEY and the package command npx -y sv-number-mcp.
Expected outcome
The server is added to Claude Code's MCP configuration.
Guide limitations
- This setup guide does not document a verification or activation run.
- The service requires a funded balance.
Add the server to a JSON-configured MCP client
Configure the server in a client that reads an MCP JSON configuration.
Before you start
- A JSON-configured client such as Codex, Cursor or Claude Desktop
- Node.js tooling to run the package with npx
- An SVN_API_KEY obtained after signup
- A funded service balance; the API has no free tier
Steps
Obtain an API key from your profile after signup.
Add the README's mcpServers entry for sv-number, setting command to npx, args to -y sv-number-mcp, and SVN_API_KEY in env.
Expected outcome
The server entry is present in the client's MCP JSON configuration.
Guide limitations
- The README documents configuration, not client-specific confirmation steps or a completed activation.
- The service requires a funded balance.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 14 October 2026
- Original website title
- sv-number/mcp-server · Official homepage title · retained in its source language

