servers / sv-number

sv-number MCP server

communitystdiolocaldestructive capablehealthy

MCP server for AI agents that need a phone number: order a private number in any country, read the SMS verification code, hand it back.


01Tools · 9

How to read this: tool names here are observed from a live tools/list handshake. The Risk label is a heuristic inferred from the tool name (write/destructive verbs), not from executing the tool — a conservative guess, not a verified capability. We never escalate risk from a description. Found one that's wrong? Tell us — we fix on report.

ToolRiskSide effectsApproval
totp_code
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.
unknownunknownunknown
finish_activation
Close an activation after the code was used. Do this on every success: a forgotten activation holds money until it expires.
unknownunknownunknown
get_balance
Current account balance. Ordering a number needs a funded balance; there is no free tier.
readfalseunknown
wait_for_code
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.
readfalseunknown
order_number
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.
writetrueunknown
list_countries
Every country the numbers can come from, with its id and operators. Use the id in order_number.
readfalseunknown
cancel_activation
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.
destructivetruetrue
request_another_sms
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.
unknownunknownunknown
list_services
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.
readfalseunknown

02Install & source
npx -y sv-number-mcp
npx

05Provenance & freshness
sourcesGitHub repo search [p4]
last_checked2026-08-16 20:08Z
next_check2026-08-16 22:48Z
cadenceevery 3h
verifiedtools_list:passed handshake:passed metadata:passed tools_list:passed handshake:passed metadata:passed tools_list:passed handshake:passed metadata:passed tools_list:passed
index_statusindex8 unique facts >= 5

06Badge

Add the “as seen on MCPExplorer” badge to your README. sv-number MCP — as seen on mcpexplorer.com

[![sv-number MCP — as seen on mcpexplorer.com](https://mcpexplorer.com/badge/sv-number.svg)](https://mcpexplorer.com/servers/sv-number)

Next step

This is one server. A loadout combines the right servers, governance, and proven plays for a whole job — assembled deliberately, not tool-dumped.

Explore loadouts →