Claude
Web + Desktop
Open Settings → Connectors, add a custom connector named Voxisim, then paste the hosted endpoint.
https://api.voxisim.com/mcp One-time activation · REST + MCP
Buy a private number, catch the verification code, move on. The activation lives about 20 minutes — and if no code ever lands, by SMS or by call, you keep your money: prepaid balance is credited back and an unsettled x402 hold is released.
Start building
Sign up with an email address — no card, no sales call. The sign-in link brings you straight back to this page and hands you a key that works with both the REST API and the MCP server.
Free to create. You pay per number, never a subscription.
How it works
Every step below maps to real endpoints and real tools. Hold on to the id a purchase gives you — everything after the buy hangs off it.
List services, then countries. Availability and exact USD prices are returned live.
GET /v1/sms/activation/servicesGET /v1/sms/activation/countries sms_activation_list_servicessms_activation_list_countries Pay from prepaid balance (REST also takes accountless x402), then keep the returned activation id.
POST /v1/sms/activation/numbers sms_activation_buy_number Read status every few seconds until a code arrives or the activation is done.
GET /v1/sms/activation/numbers/{id} sms_activation_get_code Use the code immediately. If no code (SMS or call) arrives before expiry, the activation is refunded automatically.
Set up once
Connect the hosted endpoint and your agent can price options, buy a number, and hand you the code without you writing a request. Nothing to install: there is no package, no local server, and no container — just one URL and a browser sign-in.
Choose your client below and copy the block it needs.
Approve the browser OAuth prompt, or pass a vxs_ key from your secret manager if you would rather not use OAuth.
Your agent picks the right tools and carries ids between them, so a single sentence covers the whole lifecycle.
Web + Desktop
Open Settings → Connectors, add a custom connector named Voxisim, then paste the hosted endpoint.
https://api.voxisim.com/mcp App + CLI + IDE
Add one server table. Codex shares this configuration across its local app, CLI, and IDE extension.
[mcp_servers.voxisim]
url = "https://api.voxisim.com/mcp"
# Authenticate once from a terminal:
# codex mcp login voxisim Terminal
Register the remote HTTP server at user scope so it is available in every project.
claude mcp add --transport http --scope user \
voxisim https://api.voxisim.com/mcp Editor + Agent CLI
Add the remote server globally, or place the same object in .cursor/mcp.json for one project.
{
"mcpServers": {
"voxisim": {
"url": "https://api.voxisim.com/mcp"
}
}
} Agent workflow
The tools are typed and named for the job, so results come back as structured fields rather than prose an agent has to re-read. Purchases are paid from your prepaid balance; top it up in your account or redeem a voucher.
5 tools for this product
sms_activation_list_servicessms_activation_list_countriessms_activation_buy_numbersms_activation_get_codesms_activation_list_numbersTry asking your agent
Find the cheapest live country for WhatsApp, buy one activation, and wait for the verification code.
Show me the available countries and exact current prices for a Telegram activation before buying anything.
Check my active SMS activations and report any code that has arrived.
Buy a Telegram number that receives the code by voice call, and wait for it.
REST
Discovery is public — run the first block right now with no account. Buying takes either a prepaid key or a signed x402 payment, and the request body is identical either way.
A prepaid balance is simpler when you buy often. Accountless x402 is better for a one-off autonomous purchase — save the receipt_token from the first paid response so you can read back what you bought.
No account is required. Fetch live availability and exact prices before purchase. SMS is the default; add verification_type=call or voice to the countries query to price a call method.
curl 'https://api.voxisim.com/v1/sms/activation/services'
curl 'https://api.voxisim.com/v1/sms/activation/countries?service_id=SERVICE_ID'
curl 'https://api.voxisim.com/v1/sms/activation/countries?service_id=SERVICE_ID&verification_type=call'
Create an account once, top it up over x402, then use the returned vxs_ key for purchases. For a call method, add "verification_type":"call" or "voice" to the purchase body.
curl -X POST https://api.voxisim.com/v1/signup \
-H 'content-type: application/json' \
-d '{"label":"docs-quickstart"}'
curl -X POST https://api.voxisim.com/v1/sms/activation/numbers \
-H 'authorization: Bearer YOUR_VXS_API_KEY' \
-H 'content-type: application/json' \
-d '{"service_id":"SERVICE_ID","country_id":COUNTRY_ID,"verification_type":"sms"}'
Send the purchase without credentials, sign one requirement from the 402 response, then retry the same request. verification_type goes in the body here too, and the 402 quotes that method's price.
curl -i -X POST https://api.voxisim.com/v1/sms/activation/numbers \
-H 'content-type: application/json' \
-d '{"service_id":"SERVICE_ID","country_id":COUNTRY_ID,"verification_type":"sms"}'
curl -X POST https://api.voxisim.com/v1/sms/activation/numbers \
-H 'content-type: application/json' \
-H 'X-PAYMENT: BASE64_SIGNED_AUTHORIZATION' \
-d '{"service_id":"SERVICE_ID","country_id":COUNTRY_ID,"verification_type":"sms"}'
Poll every few seconds until codes is non-empty or done is true. Each code carries a type (sms, call or voice); for a flash call, phone_from is the caller's number and its last digits are the code.
curl 'https://api.voxisim.com/v1/sms/activation/numbers/YOUR_ACTIVATION_ID' \
-H 'authorization: Bearer YOUR_VXS_API_KEY'
| Method | Route | What it does |
|---|---|---|
| GET | /v1/sms/activation/services | List services and cheapest live options |
| GET | /v1/sms/activation/countries | List countries, stock, and exact prices |
| POST | /v1/sms/activation/numbers | Purchase a one-time number |
| GET | /v1/sms/activation/numbers/{id} | Read status and received codes |
| GET | /v1/sms/activation/numbers | List active or archived activations |
Operating notes
Expiry and provider hiccups are normal states, not exceptions. Branch on the typed error, re-run discovery before you retry, and never assume last run's price still holds.
If no code arrives before the roughly 20-minute expiry, whether by SMS or by call, the refund is automatic. Prepaid balance is credited back and an x402 authorization is released without ever settling — you do not have to ask.
Poll until codes is non-empty or done is true, then use the code promptly. An SMS activation catches a single code; a FlashCall activation may also catch an SMS, and a Voice activation an SMS, a flash call or a voice code — each tagged with its type. Start a new activation if you need another attempt.
vxs_ keys and x402 receipt_token values belong in a secret manager — not in prompts, source control, or logs.
invalid_argument — your service, country, or interval is stale. Re-run discovery and send a currently valid combination.payment_required — expected on the x402 path. Sign one of the offered requirements and repeat the identical request.number_unavailable or a conflict — that option just sold out. Discover again and pick another rather than replaying the same buy.provider_unavailable or rate limiting — back off and honour the retry hint in the error. Retrying immediately makes it worse.Not sure yet?
Pick the shortest lifetime that still covers your workflow. Stock and prices are live for both.
Buy a one-time phone number and receive its verification code.
Rent a phone number for a chosen duration and receive its SMS messages.
FAQ
About 20 minutes from purchase. That window is for receiving the code, not for keeping the number — once it expires the number is gone and cannot be renewed.
You are refunded automatically at expiry. There is no support ticket and no claim to file: prepaid balance is credited back, and an x402 authorization that never settled is simply released.
Two ways to get the code by phone call instead of SMS, where the service texts the code to your number. With FlashCall the service calls and hangs up, and the caller's number is the code — usually its last digits; the service tells you how many. A FlashCall activation can also receive the code by SMS. With Voice (All-in-One) the service calls and a bot reads the code out, and the same activation can also catch the code by SMS or flash call. For either call method, choose "Call me" when the service asks how to send the code.
SMS, unless you have a reason not to. Switch to a call method when the service offers to call you instead, or when the SMS route for your country is sold out. Prices differ by method and country, so compare them before you buy. Voice catches SMS, flash calls and voice codes, so it is the safe pick when you are not sure how the service will send it.
Each method has its own stock, its own countries, and its own provider prices. A country can be cheap for FlashCall, dearer for SMS, and not offered for Voice at all. Pass verification_type to the countries endpoint to see current stock and exact prices for the method you want.
An SMS activation cannot — it is scoped to a single code. A FlashCall activation may also catch an SMS, and a Voice activation an SMS, a flash call or a voice code; each code is tagged with its type. If you need to verify again, buy another one — that is also why it is the cheapest option per code.
Usually within seconds of the service sending it, but that depends entirely on the service, not on us. Poll every few seconds rather than waiting on a single long request.
No. Call the countries endpoint right before you buy — it returns current stock and the exact price, and both move with real supply.
Yes. Send the purchase with no credentials, sign the x402 challenge that comes back, and repeat the request. Discovery never needed credentials in the first place.
Reference
This page explains the workflow. For every parameter, response field, and tool input, go to the reference — it is generated from the live contract, so it cannot drift.
Connect an MCP client and ask, or copy the REST quickstart and run it.
Enter your email and we'll send a sign-in link. Open it and you'll land back here with your API key.
The sign-in link is on its way. Open it on this device and you'll come back to this page with your API key.
Copy it now. Keys are stored hashed, so this is the only time it can be shown.
Keys are stored hashed, so only the start of yours can be shown.
A new key replaces the current one immediately. Anything still using the old key stops working.