{
  "markdown": "# SV Number MCP server\n\nPhone numbers as tools. Your agent orders a private number in the country a service\nexpects, reads the SMS verification code straight from the API, and hands the number back.\nNine tools over stdio, no SDK to learn.\n\n200+ countries, the widest coverage in this category. Every other claim on this page is\ncheckable too, but this one takes a single call: run `list_countries` and count the rows.\n\n```\norder_number(service=\"tg\", country=6)   ->  +62 838 1234 5678\nwait_for_code(activationId)             ->  123456\nfinish_activation(activationId)         ->  done\n```\n\n## Install\n\nClaude Code:\n\n```bash\nclaude mcp add sv-number --env SVN_API_KEY=your_key_here -- npx -y sv-number-mcp\n```\n\nAnything that reads a JSON config (Codex, Cursor, Claude Desktop):\n\n```json\n{\n  \"mcpServers\": {\n    \"sv-number\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"sv-number-mcp\"],\n      \"env\": { \"SVN_API_KEY\": \"your_key_here\" }\n    }\n  }\n}\n```\n\nThe key comes from [your profile](https://sms-verification-number.com/en/user/profile/)\nafter [signup](https://sms-verification-number.com/en/register/). The balance has to be\nfunded: there is no free tier on this API. The key is read from the environment and never\nleaves the process, no tool returns it and no error message quotes it.\n\n## Tools\n\n| Tool | What it does |\n| --- | --- |\n| `get_balance` | what is left on the account |\n| `list_countries` | every country with its id and operators |\n| `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 |\n| `order_number` | order a private number for one service in one country |\n| `wait_for_code` | poll until the code lands and return it, already parsed out of the SMS |\n| `finish_activation` | close a successful activation |\n| `cancel_activation` | cancel and get the money back |\n| `request_another_sms` | ask for one more code on the same number |\n| `totp_code` | compute the authenticator code locally, by RFC 6238 |\n\n`list_services` answers with `matches` ranked best first plus `notInList`, the fallback\nservice. It takes a site name or a URL, so `discord.com` finds `Discord`, and it ranks a\nwhole word above a substring so `x` puts `X.com (Twitter)` above `Maxim`. Codes are\narbitrary and must never be recalled from memory: `uk` is Airbnb, `re` is Coinbase, `tn` is\nLinkedIn. When nothing matches, the answer says so and points at another country, because\nthe catalogue is not the same everywhere, and at `ot` (\"Not on list\"), which receives SMS\nfrom any sender that is not in the list. A site that has its own code sends to that code,\nso `ot` is a fallback and not a wildcard.\n\n`deliveredPercent` is the delivery rate for that service and country, and `null` when the\npair has no statistics yet, which is the common case. Where there is a number, pick by it\ninstead of by price; where there is not, `online` shows how big the live pool is, which is\nthe next best signal.\n\n## What the server handles for you\n\nEvery call carries `lang`. The API answers without it, but then it prices in another\ncurrency, so the server never leaves it out. Text markers that the API returns\ninstead of JSON are checked before anything is parsed, and turned into a sentence an agent\ncan act on: `NO_NUMBERS` becomes \"change country, or set operator to any\" rather than a\nbare token. Polling runs at a sane interval instead of hammering `getStatus`, and\n`wait_for_code` stops at the 20 minute life of a number.\n\n## What it is not\n\nReceiving verification codes is the whole job. These numbers do not send SMS, do not take\ncalls, and are not meant for banking, payment or government accounts. An agent that needs a\npermanent number to hold a conversation wants a carrier product instead.\n\n## Config\n\n| Variable | Default |\n| --- | --- |\n| `SVN_API_KEY` | required |\n| `SVN_API_BASE` | `https://sms-verification-number.com/stubs/handler_api` |\n| `SVN_LANG` | `en`, sets both the language and the currency of the answers |\n| `SVN_POLL_SECONDS` | `4` |\n\n## Related\n\n- The same product as a markdown skill: https://github.com/sv-number/skills\n- API reference: https://sms-verification-number.com/en/api-sms-activate/\n- Coverage and prices: https://sms-verification-number.com/en/number-for-ai-agents/\n\nMIT. The service behind it is commercial.\n",
  "bytes": 4340,
  "sha": "fead0431e78191d395af33514e4abdad6b40533ac367378494eecb23ef1462f0",
  "repo_slug": "sv-number/mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_sv_number_mcp_server_23c198f8/readme"
}