Skip to content
Back to search

mcp-server

MCP server for AI agents that need a phone number: order a private number in 200+ countries, read the SMS verification code, hand it back. The widest country coverage in the category, and you can check it with one API call.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/sv-number/mcp-server with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/sv-number/mcp-server'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/sv-number--mcp-server/badge.svg)](/listings/sv-number--mcp-server)

HTML

<a href="/listings/sv-number--mcp-server"><img src="/api/listings/sv-number--mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Claude Code:

claude mcp add sv-number --env SVN_API_KEY=your_key_here -- npx -y sv-number-mcp

Anything that reads a JSON config (Codex, Cursor, Claude Desktop):

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

The key comes from [your profile](https://sms-verification-number.com/en/user/profile/) after [signup](https://sms-verification-number.com/en/register/). The balance has to be funded: there is no free tier on this API. The key is read from the environment and never leaves the process, no tool returns it and no error message quotes it.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 105 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # SV Number MCP server
  2. Phone numbers as tools. Your agent orders a private number in the country a service
  3. expects, reads the SMS verification code straight from the API, and hands the number back.
  4. Nine tools over stdio, no SDK to learn.
  5. Free start: promo code SVFREE gives one free number per account. Enter it in the promo code field on your profile page (sms-verification-number.com/en/user/profile/), next to the API key, and click Apply. The code works for the first 1000 activations.
  6. 200+ countries, the widest coverage in this category. Every other claim on this page is
  7. checkable too, but this one takes a single call: run `list_countries` and count the rows.
  8. ```
  9. order_number(service="tg", country=6) -> +62 838 1234 5678
  10. wait_for_code(activationId) -> 123456
  11. finish_activation(activationId) -> done
  12. ```
  13. ## Install
  14. Claude Code:
  15. ```bash
  16. claude mcp add sv-number --env SVN_API_KEY=your_key_here -- npx -y sv-number-mcp
  17. ```
  18. Anything that reads a JSON config (Codex, Cursor, Claude Desktop):
  19. ```json
  20. {
  21. "mcpServers": {
  22. "sv-number": {
  23. "command": "npx",
  24. "args": ["-y", "sv-number-mcp"],
  25. "env": { "SVN_API_KEY": "your_key_here" }
  26. }
  27. }
  28. }
  29. ```
  30. The key comes from [your profile](https://sms-verification-number.com/en/user/profile/)
  31. after [signup](https://sms-verification-number.com/en/register/). A new account has no key
  32. yet: generate it on the profile page first. The balance has to be
  33. funded, apart from the SVFREE start number. The key is read from the environment and never
  34. leaves the process, no tool returns it and no error message quotes it.
  35. ## Tools
  36. | Tool | What it does |
  37. | --- | --- |
  38. | `get_balance` | what is left on the account |
  39. | `list_countries` | every country with its id and operators |
  40. | `list_services` | find 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 |
  41. | `order_number` | order a private number for one service in one country |
  42. | `wait_for_code` | poll until the code lands and return it, already parsed out of the SMS |
  43. | `finish_activation` | close a successful activation |
  44. | `cancel_activation` | cancel and get the money back |
  45. | `request_another_sms` | ask for one more code on the same number |
  46. | `totp_code` | compute the authenticator code locally, by RFC 6238 |
  47. `list_services` answers with `matches` ranked best first plus `notInList`, the fallback
  48. service. It takes a site name or a URL, so `discord.com` finds `Discord`, and it ranks a
  49. whole word above a substring so `x` puts `X.com (Twitter)` above `Maxim`. Codes are
  50. arbitrary and must never be recalled from memory: `uk` is Airbnb, `re` is Coinbase, `tn` is
  51. LinkedIn. When nothing matches, the answer says so and points at another country, because
  52. the catalogue is not the same everywhere, and at `ot` ("Not on list"), which receives SMS
  53. from any sender that is not in the list. A site that has its own code sends to that code,
  54. so `ot` is a fallback and not a wildcard.
  55. `deliveredPercent` is the delivery rate for that service and country, and `null` when the
  56. pair has no statistics yet, which is the common case. Where there is a number, pick by it
  57. instead of by price; where there is not, `online` shows how big the live pool is, which is
  58. the next best signal.
  59. ## What the server handles for you
  60. Every call carries `lang`. The API answers without it, but then it prices in another
  61. currency, so the server never leaves it out. Text markers that the API returns
  62. instead of JSON are checked before anything is parsed, and turned into a sentence an agent
  63. can act on: `NO_NUMBERS` becomes "change country, or set operator to any" rather than a
  64. bare token. Polling runs at a sane interval instead of hammering `getStatus`, and
  65. `wait_for_code` stops at the 20 minute life of a number.
  66. ## What it is not
  67. Receiving verification codes is the whole job. These numbers do not send SMS, do not take
  68. calls, and are not meant for banking, payment or government accounts. An agent that needs a
  69. permanent number to hold a conversation wants a carrier product instead.
  70. ## Config
  71. | Variable | Default |
  72. | --- | --- |
  73. | `SVN_API_KEY` | required |
  74. | `SVN_API_BASE` | `https://sms-verification-number.com/stubs/handler_api` |
  75. | `SVN_LANG` | `en`, sets both the language and the currency of the answers |
  76. | `SVN_POLL_SECONDS` | `4` |
  77. ## Related
  78. - The same product as a markdown skill: https://github.com/sv-number/skills
  79. - API reference: https://sms-verification-number.com/en/api-sms-activate/
  80. - Coverage and prices: https://sms-verification-number.com/en/number-for-ai-agents/
  81. - Browser extension: get a number and insert the SMS code into signup forms. Install from Chrome Web Store: https://chromewebstore.google.com/detail/hideihfncekabkmpilfonfanhjbdjmhh
  82. MIT. The service behind it is commercial.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.