Skip to content
Agentmart
Submit a tool

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

IndexedMITLocal (stdio)★ 537
Write a review

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.

We use your email only for this newsletter. Privacy

About

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

Use cases: identity-access, api-integration

No 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_balance
  • list_countries
  • list_services
  • request_another_sms
  • totp_code

Write 3 · Create, change, send or run things.

  • cancel_activation
  • finish_activation
  • order_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_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.

  • finish_activation

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

  • get_balance

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

  • list_countries

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

  • 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.

  • 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.

  • 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.

  • 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.

  • 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.

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
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)