Skip to content
Back to search

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 the category, checkable with one API call.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/sv-number--skills/badge.svg)](/listings/sv-number--skills)

HTML

<a href="/listings/sv-number--skills"><img src="/api/listings/sv-number--skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/plugin.json · Manifest · 20 lines
  1. {
  2. "name": "sv-number",
  3. "version": "1.0.2",
  4. "description": "Order a private phone number over the API, receive the SMS verification code, and hand the number back. Free start: promo code SVFREE gives one free number per account. Enter it on the top-up page in the coupon field. The code works for the first 1000 activations.",
  5. "author": {
  6. "name": "SV Number",
  7. "url": "https://sms-verification-number.com"
  8. },
  9. "homepage": "https://sms-verification-number.com",
  10. "repository": "https://github.com/sv-number/skills",
  11. "license": "MIT",
  12. "keywords": [
  13. "sms-verification",
  14. "virtual-phone-number",
  15. "otp",
  16. "totp",
  17. "agent-skill"
  18. ],
  19. "skills": "./"
  20. }
README.md · README · 110 lines
  1. # SV Number agent skill
  2. Your agent hits a signup wall: "we sent a code to your phone". It has no phone. This skill
  3. gives it one on demand, in the country the service expects, and reads the code back over
  4. the API.
  5. Free start: promo code SVFREE gives one free number per account. Enter it in the promo code field on your profile page (sms-verification-number.com/en/user/profile/), next to the API key, and click Apply. The code works for the first 1000 activations.
  6. One markdown file. No SDK, no dashboard, no human at the keyboard.
  7. ```
  8. > Read the sv-number skill and register me a Telegram account on an Indonesian number.
  9. ordered +62 838 1234 5678
  10. code 123456
  11. account created
  12. ```
  13. ## What it lets an agent do
  14. ### Sign up anywhere, not just where you live
  15. Most verification checks look at the country the number came from. An Indonesian
  16. marketplace refuses a US number before the SMS is even sent. The agent names the country in
  17. the request and that whole class of failure disappears.
  18. The catalogue carries 200+ countries, the widest coverage in this category. You do not have
  19. to take that on faith, and you should not: one call returns the list, so count it yourself.
  20. ```bash
  21. curl -s "https://sms-verification-number.com/stubs/handler_api?api_key=$SVN_API_KEY\
  22. &action=getCountryAndOperators&lang=en" | jq length
  23. ```
  24. ### Read the code, not an inbox
  25. The API returns the verification code itself, already parsed out of the message. There is
  26. no regex to write per service and nothing to fix when a service rewrites its wording.
  27. ### Pay for the code, not for the month
  28. Money is held when the number is ordered and charged when the code lands. Nothing in 20
  29. minutes and it returns to the balance by itself.
  30. ### Keep the number private
  31. One activation, one holder. Nobody else receives its codes, which is exactly the part that
  32. free shared pools get wrong.
  33. ### Steer by what the pool is doing, not by price
  34. The catalogue call returns, per service and country, the share of codes that arrived for
  35. other users and how many numbers are live right now. Where the share is measured, an agent
  36. that reads it stops paying for countries that never deliver; where it is not, the size of
  37. the live pool tells the same story.
  38. ### Finish the second factor too
  39. When the account asks for an authenticator, the agent stores the TOTP secret next to its
  40. API key and computes the six digits locally, by RFC 6238. The secret never leaves the
  41. machine.
  42. ## Start
  43. ```bash
  44. curl -O https://raw.githubusercontent.com/sv-number/skills/main/sv-number/SKILL.md
  45. export SVN_API_KEY=your_key_here
  46. ```
  47. The layout follows the [Agent Skills specification](https://agentskills.io/specification):
  48. a directory named after the skill, holding `SKILL.md` and `scripts/`. Point any runner at
  49. it and it works as is, in Claude Code, Codex or anything else that reads a skill. The key comes from
  50. [your profile](https://sms-verification-number.com/en/user/profile/) after
  51. [signup](https://sms-verification-number.com/en/register/). The balance has to be funded:
  52. apart from the SVFREE start number.
  53. ## The cycle
  54. ```
  55. getNumber -> ACCESS_NUMBER:id:phone order a number, money is held
  56. getStatus -> STATUS_WAIT_CODE poll every 3 to 5 seconds
  57. -> STATUS_OK:123456 the code
  58. setStatus 6 -> ACCESS_ACTIVATION done, the charge stays
  59. setStatus 8 -> ACCESS_CANCEL nothing came, money back
  60. ```
  61. Runnable versions: [`sv-number/scripts/order_number.py`](sv-number/scripts/order_number.py)
  62. and [`sv-number/scripts/order_number.mjs`](sv-number/scripts/order_number.mjs).
  63. ## What it is not
  64. Receiving codes is the whole job. These numbers do not send SMS and do not take calls, and
  65. they are not for banking, payment or government accounts. If your agent needs a permanent
  66. number that holds a conversation with people, you want a carrier product instead.
  67. ## Rules the skill enforces
  68. The API key stays in the agent's environment and goes nowhere else. An activation is used
  69. for the service it was ordered under, because that is what keeps delivery rates high for
  70. everyone. Every activation gets closed: `setStatus 6` when the code was used, `setStatus 8`
  71. when nothing arrived. A forgotten activation holds money until it expires.
  72. ## Links
  73. - Skill file: [`sv-number/SKILL.md`](sv-number/SKILL.md)
  74. - The same skill as a page: https://sms-verification-number.com/en/agent-skill/
  75. - Full API reference: https://sms-verification-number.com/en/api-sms-activate/
  76. - Live coverage and prices: https://sms-verification-number.com/en/number-for-ai-agents/
  77. MIT for the skill and the examples. The service behind it is commercial.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.