Log inSubmit server
MCP Server logo

MCP Server

by sv-number

Order temporary verification numbers, retrieve SMS codes, manage activations, and calculate RFC 6238 TOTP codes through MCP.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install MCP Server

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "mcp-server-160": {
      "command": "npx",
      "args": [
        "-y",
        "sv-number-mcp"
      ],
      "env": {
        "SVN_API_KEY": "YOUR_VALUE_HERE",
        "SVN_API_BASE": "YOUR_VALUE_HERE",
        "SVN_LANG": "YOUR_VALUE_HERE",
        "SVN_POLL_SECONDS": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 9 tools correctly (8d ago).

Overview

The sv-number/mcp-server MCP server connects AI agents to the SV Number SMS-verification API over stdio. It helps agents select a country and service, order a private number, retrieve a parsed SMS verification code, and close or cancel the activation. Additional tools expose account balance, service availability, repeat SMS requests, and local RFC 6238 TOTP generation. Use it for short-lived service verification flows, not for calls, outbound SMS, or permanent phone access.

Use cases

  • Order a temporary number for service verification
  • Retrieve and parse an SMS verification code
  • Compare service availability across countries
  • Retry an activation with another SMS
  • Generate an RFC 6238 TOTP code

Key features

  • Temporary number ordering
  • SMS code polling and parsing
  • Country, operator, and service discovery
  • Activation completion, cancellation, and refunds
  • RFC 6238 TOTP generation
  • Configurable API endpoint and polling interval

Tools9

What MCP Server lets your agent do. Expand a tool for its parameters.

Verified live~1.1k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

5/5 checks healthy over the last 44d

What it can do

From the 9 tools this server returned when we ran it.

Handles credentials · 2Makes network requests · 1Read-only tools · 9
Network at startup3 connections
Files written at startupNone
Install scriptsprepare
npm provenanceNot published
Package age67 days
Maintainers1

Observed 2026-10-14 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 6d ago via OSV.dev · sv-number-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars545Stargazers on the source repository.
npm downloads155Package downloads in the last 30 days.
Last commit2mo agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed9Callable tools this server registers over MCP.
Directory activity2 viewsConfig copies, upvotes, and views on AllMCPs.

How MCP Server works

What sv-number/mcp-server MCP server does

The sv-number/mcp-server MCP server gives an agent a workflow for obtaining temporary phone numbers and receiving verification codes through the SV Number API. It can inspect the account balance, browse supported countries and operators, search the service catalogue, and select a number for a specific service and country.

After an activation is ordered, the agent can wait for an incoming SMS and receive the code extracted from that message. Successful activations can be finished, while unwanted activations can be cancelled for a refund. The server can also request another SMS for an existing number and calculate an authenticator code locally using RFC 6238.

The service catalogue accepts a site name or URL. Results are ranked by match quality and include pricing, the number of currently available numbers, and—when statistics exist—the percentage of codes delivered for that service and country. The catalogue also identifies services that are not listed and can suggest alternatives.

How it works

The server runs as a stdio MCP process and exposes nine tools. A typical sequence is to find the relevant service code, inspect countries or operators, order a number, wait for the code, and then finish or cancel the activation. wait_for_code polls at a controlled interval and stops when the number's 20-minute lifetime ends.

Each API request includes a language setting. That setting also controls the currency used in responses. The server checks textual API status markers before parsing responses and converts conditions such as unavailable numbers into guidance an agent can use. The API key remains in the process environment; tools and error messages do not return or quote it.

Setup and configuration

Install the sv-number/mcp-server MCP server with the sv-number-mcp npm package through npx. Claude Code can register it with claude mcp add, while JSON-based clients such as Codex, Cursor, and Claude Desktop can define a command of npx, the -y and sv-number-mcp arguments, and the environment configuration.

SVN_API_KEY is required. Obtain the key from an SV Number user profile after registering, then fund the account before making API calls; the API has no free tier. Optional settings include SVN_API_BASE, which defaults to the documented handler endpoint, SVN_LANG, which defaults to en, and SVN_POLL_SECONDS, which defaults to 4.

Tools and capabilities

  • get_balance reports remaining account credit.
  • list_countries returns country identifiers and available operators.
  • list_services searches by service name or domain and ranks matches.
  • order_number requests a number for one service in one country.
  • wait_for_code waits for and parses the received SMS code.
  • finish_activation closes a successful activation.
  • cancel_activation cancels an activation and requests a refund.
  • request_another_sms asks for another message on the same number.
  • totp_code computes an RFC 6238 authenticator code locally.

Limitations and notes

The sv-number/mcp-server MCP server is intended for receiving verification SMS messages only. Its numbers do not send SMS, support calls, or provide a permanent conversational phone line. The README also excludes banking, payment, and government accounts from the intended use.

Service codes vary by catalogue and country, so agents should query list_services rather than rely on remembered codes. Delivery statistics may be absent for many service-country combinations; when available, they are more useful than price alone, while the live online count provides a fallback signal.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about MCP Server

sv-number/mcp-server is an MCP server that connects AI agents to the SV Number SMS-verification API. Its main tools list countries and services, check balance, order a private number, wait for and parse an SMS code, finish or cancel activations, request another SMS, and calculate RFC 6238 TOTP codes locally.

Install it with `npx -y sv-number-mcp` and provide `SVN_API_KEY` in the MCP client's environment. Claude Code uses `claude mcp add`; JSON-configured clients define the command, arguments, and environment in their MCP server configuration.

`SVN_API_KEY` is required. `SVN_API_BASE` optionally changes the API endpoint, `SVN_LANG` sets language and currency and defaults to `en`, and `SVN_POLL_SECONDS` changes the polling interval and defaults to `4`.

Yes, it can order a temporary number and retrieve a parsed incoming SMS code with `wait_for_code`. The number is intended for verification flows, does not send SMS or take calls, and has a 20-minute lifetime.

Yes, Cursor can run it through a JSON MCP configuration. Set the command to `npx`, pass `-y` and `sv-number-mcp` as arguments, and provide `SVN_API_KEY` in the `env` object.

Related MCP servers

All in Communication All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/mcp-server-160?style=directory)](https://allmcps.com/mcp/mcp-server-160)
HTML Embed
<a href="https://allmcps.com/mcp/mcp-server-160"><img src="https://allmcps.com/api/badge/mcp-server-160?style=directory" alt="MCP Server on AllMCPs" /></a>