# io.github.sv-number/mcp-server (npm · sv-number-mcp)

Phone numbers for AI agents: order a private number, read the SMS verification code, hand it back.

- Trust score: 83/100 (high trust)
- Change this week: 0
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-09-22

## Components

- npm · `sv-number-mcp`: 83/100 (this document), [markdown](https://verifymcp.io/servers/sv-number-mcp-server/sv-number-mcp.md), [page](https://verifymcp.io/servers/sv-number-mcp-server/sv-number-mcp)

## Channel facts

- Registry: `npm`
- Package: `sv-number-mcp`
- Version: `1.0.2`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-09-22.

- **Supply Chain Security**: 98/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - No install/post-install scripts declared.
  - 31 of 96 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 43 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 77/100
  - AI-judged instruction clarity (good).
  - Tool/resource definitions use about 707 tokens (~78/item across 9 items; 9 tools + 0 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 100/100
  - No destabilizing schema changes in the last 30 days.
- **Tool Coverage**: 88/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 63% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 9 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 9 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### How do I install the io.github.sv-number/mcp-server server?

io.github.sv-number/mcp-server runs locally as an npm package, launched with npx -y sv-number-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add sv-number-mcp-server -- npx -y sv-number-mcp
```

### Cursor

```json
{
  "mcpServers": {
    "sv-number-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "sv-number-mcp"
      ]
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "sv-number-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "sv-number-mcp"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add sv-number-mcp-server -- npx -y sv-number-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "sv-number-mcp-server": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "sv-number-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add sv-number-mcp-server --command npx --arg -y --arg sv-number-mcp
```

### Hermes

```yaml
mcp_servers:
  sv-number-mcp-server:
    command: "npx"
    args: ["-y", "sv-number-mcp"]
```

### Netclaw

```json
{
  "McpServers": {
    "sv-number-mcp-server": {
      "Transport": "stdio",
      "Command": "npx",
      "Arguments": [
        "-y",
        "sv-number-mcp"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add sv-number-mcp-server -t stdio -c npx -a -y sv-number-mcp
```

### Other

```json
{
  "mcpServers": {
    "sv-number-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "sv-number-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-09-22 (score 83, 0)

- [security] Stability: 0.97 → pass

### 2026-09-21 (score 83, +1)

No change was recorded against any check on this day. Stability & Change Management went from 93 to 97. That category is still filling its 30-day observation window: 28 days of observed history at the previous scan, 29 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-19 (score 82, +1)

No change was recorded against any check on this day. Stability & Change Management went from 87 to 90. That category is still filling its 30-day observation window: 26 days of observed history at the previous scan, 27 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-16 (score 81, −2)

- [functional] Stability: pass → 0.80

### 2026-09-15 (score 83, 0)

- [security] Stability: 0.97 → pass

### 2026-09-14 (score 83, +1)

No change was recorded against any check on this day. Stability & Change Management went from 93 to 97. That category is still filling its 30-day observation window: 28 days of observed history at the previous scan, 29 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-12 (score 82, +1)

No change was recorded against any check on this day. Stability & Change Management went from 87 to 90. That category is still filling its 30-day observation window: 26 days of observed history at the previous scan, 27 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-09 (score 81, −2)

- [functional] Stability: pass → 0.80

## MCP tools (9)

### `get_balance` (~26 tokens)

Current account balance. Ordering a number needs a funded balance; there is no free tier.

### `list_countries` (~45 tokens)

Every country the numbers can come from, with its id and operators. Use the id in order_number.

Input parameters:

- `search` (string): Filter by country name, case-insensitive

### `list_services` (~166 tokens)

Services available in a country, best match first. Order the code of the site you are registering with: a number bought for one service does not receive another service's SMS. Search by site name or domain, both work. The codes are arbitrary, so look them up instead of guessing: uk is Airbnb, not the United Kingdom. deliveredPercent is null when the pair has no statistics yet, which is the common case; then judge the pair by how many numbers are online. When the site is not in the catalogue at all, order notInList (ot), which receives SMS from any sender that is not in the list.

Input parameters:

- `country` (integer, required): Country id from list_countries
- `search` (string): Site name or domain, for example discord or discord.com

### `order_number` (~158 tokens)

Order a private number for one service in one country. The number is held for 20 minutes and belongs to this activation alone. Money is held now and charged when the code arrives. The service code has to be the one for the site you are registering with, otherwise its SMS goes to a different pool and never reaches you.

Input parameters:

- `country` (integer, required): Country id from list_countries
- `maxPrice` (number): Ceiling per activation; prices float with demand
- `operator` (string): Operator, or any to keep the pool wide
- `service` (string, required): Service code from list_services, for example tg. It must belong to the site you are registering with, or be ot when that site is not in the catalogue

### `wait_for_code` (~79 tokens)

Wait for the verification code on an ordered number. Polls on its own and returns the code itself, already parsed out of the SMS. Trigger the SMS on the target service first.

Input parameters:

- `activationId` (string, required): Id returned by order_number
- `timeoutSeconds` (integer): How long to wait, up to the 20 minute life

### `finish_activation` (~40 tokens)

Close an activation after the code was used. Do this on every success: a forgotten activation holds money until it expires.

Input parameters:

- `activationId` (string, required)

### `cancel_activation` (~58 tokens)

Cancel an activation when no code arrived; the money returns to the balance in full. Can be called right after ordering. If the API answers that it is too early, wait a couple of minutes and repeat.

Input parameters:

- `activationId` (string, required)

### `request_another_sms` (~54 tokens)

Ask for one more code on the same number, for a password reset or a re-send. Works only after a first code has already arrived; before that the API refuses it.

Input parameters:

- `activationId` (string, required)

### `totp_code` (~81 tokens)

Compute the authenticator code for an account whose second factor was set up with a shared secret. Runs locally by RFC 6238: the secret never leaves this machine.

Input parameters:

- `algorithm` (string)
- `digits` (integer)
- `period` (integer)
- `secret` (string, required): Base32 secret shown when 2FA was enabled

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/sv-number-mcp-server/sv-number-mcp#diagnostics

## Score history

- 2026-09-22: 83
- 2026-09-21: 83
- 2026-09-20: 82
- 2026-09-19: 82
- 2026-09-18: 81
- 2026-09-17: 81
- 2026-09-16: 81
- 2026-09-15: 83
- 2026-09-14: 83
- 2026-09-13: 82
- 2026-09-12: 82
- 2026-09-11: 81
- 2026-09-10: 81
- 2026-09-09: 81
- 2026-09-08: 83
- 2026-09-07: 83
- 2026-09-06: 82
- 2026-09-05: 82
- 2026-09-04: 81
- 2026-09-03: 81
- 2026-09-02: 81
- 2026-09-01: 80
- 2026-08-31: 80
- 2026-08-30: 79
- 2026-08-29: 79
- 2026-08-28: 78
- 2026-08-27: 78
- 2026-08-26: 77
- 2026-08-25: 76
- 2026-08-24: 75

## Common questions

### What is the io.github.sv-number/mcp-server server?

io.github.sv-number/mcp-server is listed in the public MCP registry as io.github.sv-number/mcp-server. Phone numbers for AI agents: order a private number, read the SMS verification code, hand it back. This page covers its npm package (sv-number-mcp).

### Is the io.github.sv-number/mcp-server server safe to use?

io.github.sv-number/mcp-server scores 83 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 22 September 2026. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the io.github.sv-number/mcp-server server expose?

io.github.sv-number/mcp-server exposes 9 tools: get_balance, list_countries, list_services, order_number, wait_for_code, and 4 more. Their descriptions and schemas cost roughly 707 tokens of context every time the server is loaded.

### Is the io.github.sv-number/mcp-server server still maintained?

io.github.sv-number/mcp-server is still listed as active in the MCP registry. We last reached this channel on 22 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What licence is the io.github.sv-number/mcp-server server under?

io.github.sv-number/mcp-server declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

## Links

- npm package: https://www.npmjs.com/package/sv-number-mcp
- Socket report: https://socket.dev/npm/package/sv-number-mcp
- Repository: https://github.com/sv-number/mcp-server
- Website: https://sms-verification-number.com/en/number-for-ai-agents/
- Changelog RSS feed: https://verifymcp.io/servers/sv-number-mcp-server/sv-number-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/sv-number-mcp-server/sv-number-mcp.json
- HTML version of this page: https://verifymcp.io/servers/sv-number-mcp-server/sv-number-mcp