sv-number/mcp-server
Phone numbers for AI agents: order a private number, read the SMS verification code, hand it back.
Connector by sv-number · GitHub account verified by the MCP Registry
Install
Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.
npx agentmarket install connector/sv-number-mcp-server
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Use cases: identity-access, api-integration
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.
- Tools
- 5 read · 3 write · 0 delete · 1 not yet classified
- Secrets
- 1 (API keys, tokens or passwords)
- Install scripts
- Not scanned yet
- Runs as
- Node.js package
Tools by what they do 9
Read from the source code; the running server may list different tools.
Read 5 · Look things up without changing anything.
get_balancelist_countrieslist_servicesrequest_another_smstotp_code
Write 3 · Create, change, send or run things.
cancel_activationfinish_activationorder_number
Not yet classified 1 · We could not tell from the name and description.
wait_for_code
Secrets and settings it asks for
Secrets: values you paste in that let it act as you.
SVN_API_KEY
Tools (9)
Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].
cancel_activationCancel 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.
finish_activationClose an activation after the code was used. Do this on every success: a forgotten activation holds money until it expires.
get_balanceCurrent account balance. Ordering a number needs a funded balance; there is no free tier.
list_countriesEvery country the numbers can come from, with its id and operators. Use the id in order_number.
list_servicesServices 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.
order_numberOrder 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.
request_another_smsAsk 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.
totp_codeCompute 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.
wait_for_codeWait 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.
Signals
- Stars
- 537
- Forks
- 7
- Open issues
- 0
- Contributors
- 1
- Last commit
- Aug 10, 2026 (2 months ago)
- Last release
- Aug 9, 2026 (2 months ago)
From GitHub (fetched Oct 24, 2026).
Details
- Registry name
io.github.sv-number/mcp-server- Version
- 1.0.2
- Auth
- API key
- Packages
- npm sv-number-mcp
- License
- MIT
- Repository
- github.com/sv-number/mcp-server
- First seen
- Oct 24, 2026
- Last checked
- Oct 24, 2026
Cite this page
sv-number/mcp-server. Agent Mart. https://agentmart.dev/connectors/sv-number-mcp-server (last updated 2026-10-24)