Rent for 20 minutes Referral program 🤑 Numbers rental from 1 day API Customer Service
Buy a number Transaction history Customer Service Referral program 🤑 Numbers rental from 1 day API
It seems you are offline. Please check your connection and try again.
Last updated: 23.10.2026
For AI agents

Phone numbers for AI agents through MCP and API

SV Number provides AI agents with temporary phone numbers for receiving SMS verification codes via its Model Context Protocol (MCP) server and API. Rent a number for a chosen service and country for 20 minutes. After setting up and funding the account, your agent can order a number and retrieve the code without manual intervention.

Get an API key Read the agent skill
MCP
Connect Claude Code, Cursor, and other MCP-compatible clients.
API
Check current prices and availability before ordering, without needing an API subscription.
SMS
Receive incoming verification codes. Voice calls and outgoing SMS are not included.
20 min
The phone number is assigned only to your activation during the rental window.

Price and availability vary based on the selected service and country. Your agent can verify both before placing an order. Check the current options in the buying widget.

What your agent does with a number

The owner must set up an account, API key, and funded balance. Once set up, the agent can request a number, retrieve incoming SMS codes, and complete the activation through MCP or API.

Sign up where the service expects a local number

Select the country and service before ordering a phone number. A service may verify the number's country, its history, and its own verification requirements. Choosing a country does not ensure that the service will accept the number or approve an account.

Countries, operators and what is online right now come from getCountryAndOperators and getServicesAndCostWithStatistics. Your agent chooses on live data instead of a list pinned in its prompt.

Pick a country

Indonesia India Brazil United Kingdom United States Viet Nam Nigeria + 204 more

Same request shape for every one of them: country=<id>.

Read the code, not an inbox

The API hands back the verification code itself, already parsed out of the SMS. Your agent polls one endpoint and gets STATUS_OK:123456 back. There is no message text to pick the digits out of, and no regex to fix when a service rewrites its wording.

The phone number is assigned exclusively to your activation during the 20-minute window. You can receive multiple SMS from the selected service during that time.

Telegram 4 s ago

Your login code: 123456. Do not give this code to anyone, even if they say they are from Telegram.

123456

Returned by getStatus as STATUS_OK:123456

Carry the second factor too

If an account requires an authenticator code, your agent can compute it locally from the authenticator secret using RFC 6238. Store API keys and authenticator secrets securely, keeping them out of prompts and public files.

The recipe with working code is in the agent skill, next to the calls that order a number and read the SMS.

Authenticator code

418 209

Computed from the stored secret. Nothing leaves the machine.

Give your agent a number in minutes

Connect the SV Number MCP server to Claude Code, Cursor, or another MCP-compatible client, use the published agent skill, or call the SMS API directly. The integration can check price and availability, order a number, retrieve its SMS code, and complete the activation.

Claude Code

claude code
# hand the skill to your agent and give it the key
$ curl -O https://sms-verification-number.com/en/agent-skill/
$ export SVN_API_KEY=your_key_here

# then just ask
> Read skills.md and register me a Telegram account on an Indonesian number.

Codex

codex
# the skill is plain markdown, any agent runner can read it
$ curl -O https://sms-verification-number.com/en/agent-skill/
$ export SVN_API_KEY=your_key_here

# point the agent at the file and let it work the API itself
> Follow skills.md. Order a number in Brazil for WhatsApp and give me the code.

MCP server

mcp
# nine native tools instead of raw HTTP: list_countries, list_services,
# order_number, wait_for_code, finish_activation, cancel_activation, totp_code
$ claude mcp add sv-number --env SVN_API_KEY=your_key_here -- npx -y sv-number-mcp

# read the key from the environment; keep it out of prompts

Same tools in Codex, Cursor or anything that reads an MCP config.

Plain curl

curl
# 1. what is available and how well it delivers
$ curl '…?action=getServicesAndCostWithStatistics&country=6&lang=en'

# 2. take a number (maxPrice guards against demand spikes)
$ curl '…?action=getNumber&service=tg&country=6&maxPrice=1.50&lang=en'

# 3. poll every 3-5 s
$ curl '…?action=getStatus&id=234242&lang=en'

# 4. finish (6) or cancel and be refunded (8)
$ curl '…?action=setStatus&id=234242&status=6&lang=en'
Get an API key Read the API documentation

Why one permanent number stops being enough

A permanent phone number and a 20-minute activation serve different purposes. Use SV Number when an agent needs a temporary number for receiving a verification code for a specific service and country.

One number, kept forever

A permanent number may be suitable for accounts that require ongoing access to the same number. For separate registrations, a service may ask for a different phone number. Acceptance depends on that service; having a number does not guarantee an approved account.

A new number for each signup

Rent a phone number for one selected service and country for 20 minutes. The number is assigned only to your activation during that time. After receiving the necessary SMS codes, complete the activation. A temporary rental does not guarantee that the number has not been used previously.

Need a phone number that stays for a while, for an account that keeps receiving codes? Rent one from a day.

How SV Number compares with the carrier products

Each page reads what the other side publishes and puts it next to ours, including the rows where they win.

What it costs

No subscription or seat fee is needed for the SMS API. Orders are deducted from your account balance. The current price is displayed before ordering, and an activation with no incoming SMS is refunded to your balance.

Pay per activation

Check the current price before ordering

  • Private phone number, 211 countries, full API access
  • No code in 20 minutes and the money returns to your balance automatically
  • 150 requests per second; what you can run is bounded by your balance
Get an API key

Rent from a day

  • The same number keeps receiving codes
  • For accounts that have to stay reachable
  • Ordered from the site; prices sit in the widget
See rental prices

What happens when it goes wrong

Verification fails sometimes. What matters is who pays for it.

If the code never arrives

If no SMS arrives within 20 minutes, the activation charge is automatically refunded to your balance. An unused activation can also be canceled when cancellation is permitted. If cancellation is not yet allowed, wait and retry. See the refund policy.

How often the code actually arrives

getServicesAndCostWithStatistics returns, for each app and country, the share of codes that reached other users, alongside how many numbers are live right now. Where the share is measured, your agent can move to a better country before it spends anything instead of finding out by waiting.

Method names your code already knows

The methods are the ones used across this market: getNumber, getStatus and setStatus. An existing client mostly needs a new base URL, plus the lang parameter on every call: it picks the currency of the answer, and the default is not dollars.

Questions agents ask first

How does my agent get an API key?
Register an account, add funds, and obtain an API key from your profile. Then connect the MCP server or use the API. The agent can request numbers and retrieve SMS codes after completing this setup.

What happens if the SMS never arrives?
If no SMS arrives, the activation expires after 20 minutes, and its charge is automatically refunded to your balance. You can cancel an unused activation when cancellation is allowed. If the API does not yet permit cancellation, wait and retry.

Can the number stay longer than 20 minutes?
An activation lasts 20 minutes for the selected service. You can receive multiple SMS from that service during the window. If you need longer access to a number, use the separate rental-by-day product, subject to its availability and terms.

Can my agent send SMS or make calls from the number?
No. These numbers receive verification codes and nothing else. If your agent has to text people or hold phone calls, you need a carrier product, not this one.

Who else can see the code?
The phone number is assigned only to your activation during the 20-minute rental window. It is not assigned to another customer for that activation simultaneously.

Which countries and services are available?
Read the current country list from getCountryAndOperators and the current service list and prices from getServicesAndCost. Lists, stock, and prices can change; check them before ordering instead of relying on a saved count.

How many activations can run at once?
The documented limit is 150 requests per second, and no daily quota is documented at all, so how much your agent can run comes down to your balance. Poll each order every three to five seconds rather than in a tight loop.

Connect your AI agent to SV Number

Top up once, hand over the key, and let it work.

Get an API key Read the agent skill
The site uses cookies. This is necessary for its proper operation and traffic analysis. Read more OK