Authorization notice. Skills is dual-use. Only use it on software, sites and systems you own or have explicit permission to test.
Credentials. The SVN_API_KEY grants access to your balance, so keep it in the agent environment and do not paste it into prompts or logs.
Who it is forA developer or agent operator whose automated signup is blocked by a 'we sent a code to your phone' step and who needs a number in a specific country.
The problemThe agent has no phone number, and verification checks often reject numbers from the wrong country before any SMS is sent.
The outcomeThe agent holds a number in the requested country, receives the verification code through the API, and closes the activation so the charge stays or the money returns.
What you need first
- An SV Number account with a funded balance, since the README says there is no free tier
- An API key from your SV Number profile, exported as SVN_API_KEY
- curl and jq, plus Python or Node.js if you run the bundled scripts
- An agent runner that reads Agent Skills, such as Claude Code or Codex
Steps
- Run
curl -O https://raw.githubusercontent.com/sv-number/skills/main/sv-number/SKILL.mdto download the skill file. - Run
export SVN_API_KEY=your_key_herewith your key from your SV Number profile. - Run
python sv-number/scripts/order_number.pyornode sv-number/scripts/order_number.mjsafter the skill is in place. (inferred, check the README) - Let the script call getNumber, then poll getStatus every 3 to 5 seconds until it returns STATUS_OK with the code.
- Confirm the script calls setStatus 6 after the code is used, or setStatus 8 if nothing arrived.
Prompt for your agent
Read the sv-number skill in the sv-number-skills repo and order a number for <service name> in <country>. Expected output: a phone number, the verification code, and a confirmation that the activation was closed with setStatus 6 or 8. Verify that the activation status is no longer waiting before you report success.
Caveat. The README says these numbers are not for banking, payment or government accounts and do not send SMS or take calls, so use them only for receiving codes.
Use this in your AI agent
Ask your agent
Using the Deduped MCP, get the setup steps for sv-number/skills and "Receive a signup SMS code on a number in a chosen country"
Add Deduped to Claude Code once
claude mcp add --transport http deduped https://dedupedai.com/mcp
Every Monday: the 5 hottest repos and exactly how to use them. Free, one email a week, unsubscribe anytime.
Get them freeShare: X LinkedIn Hacker News Email Copy link
Third-party repos we don't own. AI-written use cases can be wrong. Disclaimer