Skip to content

Skills

Give your AI agent a phone number: order a private number in 200+ countries over the API, read the SMS verification code, hand the number back. The widest country coverage in…

Install

$git clone https://github.com/sv-number/skills

Install command taken from the project's README or registry entry. Always review code before running it.

SV Number agent skill

Your agent hits a signup wall: "we sent a code to your phone". It has no phone. This skill gives it one on demand, in the country the service expects, and reads the code back over the API.

One markdown file. No SDK, no dashboard, no human at the keyboard.

> Read the sv-number skill and register me a Telegram account on an Indonesian number.

  ordered +62 838 1234 5678
  code 123456
  account created

What it lets an agent do

Sign up anywhere, not just where you live

Most verification checks look at the country the number came from. An Indonesian marketplace refuses a US number before the SMS is even sent. The agent names the country in the request and that whole class of failure disappears.

The catalogue carries 200+ countries, the widest coverage in this category. You do not have to take that on faith, and you should not: one call returns the list, so count it yourself.

curl -s "https://sms-verification-number.com/stubs/handler_api?api_key=$SVN_API_KEY\
&action=getCountryAndOperators&lang=en" | jq length

Read the code, not an inbox

The API returns the verification code itself, already parsed out of the message. There is no regex to write per service and nothing to fix when a service rewrites its wording.

Pay for the code, not for the month

Money is held when the number is ordered and charged when the code lands. Nothing in 20 minutes and it returns to the balance by itself.

Keep the number private

One activation, one holder. Nobody else receives its codes, which is exactly the part that free shared pools get wrong.

Steer by what the pool is doing, not by price

The catalogue call returns, per service and country, the share of codes that arrived for other users and how many numbers are live right now. Where the share is measured, an agent that reads it stops paying for countries that never deliver; where it is not, the size of the live pool tells the same story.

Finish the second factor too

When the account asks for an authenticator, the agent stores the TOTP secret next to its API key and computes the six digits locally, by RFC 6238. The secret never leaves the machine.

Start

curl -O https://raw.githubusercontent.com/sv-number/skills/main/sv-number/SKILL.md
export SVN_API_KEY=your_key_here

The layout follows the Agent Skills specification: a directory named after the skill, holding SKILL.md and scripts/. Point any runner at it and it works as is, in Claude Code, Codex or anything else that reads a skill. The key comes from your profile after signup. The balance has to be funded: there is no free tier on this API.

The cycle

getNumber   -> ACCESS_NUMBER:id:phone      order a number, money is held
getStatus   -> STATUS_WAIT_CODE            poll every 3 to 5 seconds
            -> STATUS_OK:123456            the code
setStatus 6 -> ACCESS_ACTIVATION           done, the charge stays
setStatus 8 -> ACCESS_CANCEL               nothing came, money back

Runnable versions: sv-number/scripts/order_number.py and sv-number/scripts/order_number.mjs.

What it is not

Similar plugs

Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local…

Why use many token when few token do trick. Viral skill + proxy for coding agents that cuts 65% of tokens by talking like a caveman.

The 1st Collaborative AI Design Agent Workspace. Local-first and open source. Create prototypes, websites, apps, dashboards, presentations, images, and videos with your team…

Explore related