Sv-number MCP Server

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…

Local serverstdioMIT

What is the Sv-number MCP Server?

mcp-server is an MCP project maintained in the sv-number/mcp-server repository. The maintainer describes its purpose as “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…”. Read the project documentation for the complete scope.

Installation

The documented npm package is sv-number-mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares SVN_API_KEY. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
get_balancewhat is left on the account
list_countriesevery country with its id and operators
list_servicesfind the code for a site: search by name or domain, best match first, price, how many are online, and the share of codes that actually arrived
order_numberorder a private number for one service in one country
wait_for_codepoll until the code lands and return it, already parsed out of the SMS
finish_activationclose a successful activation
cancel_activationcancel and get the money back
request_another_smsask for one more code on the same number
totp_codecompute the authenticator code locally, by RFC 6238

How to install the Sv-number MCP Server

{
  "mcpServers": {
    "sv-number": {
      "command": "npx",
      "args": [
        "-y",
        "sv-number-mcp"
      ],
      "env": {
        "SVN_API_KEY": "YOUR_SVN_API_KEY"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
SVN_API_KEYDeclared in the maintainer’s client configuration.Yes