asms
Server Details
Phone numbers for AI agents: SMS verification codes and rented numbers that receive SMS.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- Repository
- asms-ai/asms-mcp
- GitHub Stars
- 0
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 14 tools
The set splits cleanly into two workflows (one-shot OTP orders vs. long-lived rentals), and the cancel_order/cancel_rental and poll_sms/read_rental_sms pairs are separated by their descriptions. Minor residual overlap between get_pricing (OTP activation price) and get_rental_offers (rental period prices), which an agent could momentarily confuse when comparing costs.
Every tool is snake_case with a verb-first pattern (create_/get_/list_/poll_/read_/rent_/renew_/cancel_/set_), applied consistently across both the OTP and rental subdomains. The resource noun is always explicit, so the pattern is predictable.
14 tools is comfortably in the well-scoped range and each one supports a concrete step: inventory/pricing discovery, ordering or renting, polling messages, renewing, and cancelling. Both subdomains have a compact, purposeful surface with no filler tools.
Both flows have full lifecycle coverage: create/poll/cancel/list for OTP orders, and rent/read/renew/cancel/list/auto-renew plus offer lookup for rentals, with get_balance and get_inventory supporting the discovery step. Gaps are minor — no single-order status lookup beyond list_active_orders, no historical/expired order listing, and no wallet top-up or transaction history.
Available Tools
14 toolscancel_orderCancel a verification orderADestructiveIdempotentInspect
Rarely needed. To retry a verification do NOT cancel: just call create_otp_order again, because every unfilled order auto-refunds within 10 minutes on its own, and cancel is blocked for the first 10 minutes anyway. Only use this to release an order you are certain you no longer need once its 10-minute hold has passed.
Inputs: orderId (required).
cancel_rentalCancel a rental for a refundADestructiveIdempotentInspect
Cancel a rented number and refund it. Only possible between 5 and 120 minutes after renting, and only if the number has received no SMS; after that the rental runs to its end date.
Inputs: number (required).
create_otp_orderOrder a verification numberADestructiveInspect
Buy a number to receive an OTP: allocates a number, debits the wallet, and returns an orderId + phoneNumber. Then poll with poll_sms. If no code arrives, do NOT cancel to retry: simply call create_otp_order again for a fresh number and keep polling that one. Unfilled orders auto-refund within 10 minutes, so you only pay for codes that actually land and there is no penalty for ordering repeatedly. When a service keeps rejecting codes, order on the "us1" (Non-VoIP AT&T) pool, which has the highest delivery rate. WARNING: this spends real wallet balance.
Inputs: country (required), service (required).
get_balanceWallet balanceARead-onlyInspect
Get the current wallet balance for the authenticated account.
Inputs: no named parameters.
get_inventoryVerification number stockARead-onlyInspect
Get how many numbers are in stock for a service in a country. Omit service to list stock for every available service.
Inputs: country (required), service.
get_pricingVerification code pricesARead-onlyInspect
Get the retail price per OTP activation for a service in a country. Omit service to list prices for every available service.
Inputs: country (required), service.
get_rental_offersNumber rental pricesARead-onlyInspect
List the rental periods and prices for a country (1 day to 12 months). A rented number is yours for the whole period and receives every SMS sent to it, unlike an OTP order, which is for one code. Omit country to list the countries numbers can be rented in.
Inputs: country.
list_active_ordersList verification ordersBRead-onlyInspect
List recent OTP orders for the account (awaiting a code or already received).
Inputs: limit.
list_rentalsList rented numbersARead-onlyInspect
List the account's rented numbers with their country, period, end date and whether auto-renew is on. Ended rentals are left out unless includeEnded is true.
Inputs: includeEnded.
poll_smsCheck for the verification codeARead-onlyInspect
Check for the SMS / OTP code on an order. Returns the code once it has arrived, otherwise an empty result: poll again after a few seconds. If nothing lands after a minute or two, the fastest path is to order a fresh number with create_otp_order (prefer the "us1" Non-VoIP pool) and leave the original: it auto-refunds within 10 minutes. Never cancel just to retry, and there is no charge for ordering again, you only pay for codes that arrive.
Inputs: orderId (required).
read_rental_smsRead a rented number's SMSBRead-onlyInspect
Read the SMS a rented number has received during this rental, newest first. Poll again every few seconds while waiting for a message.
Inputs: number (required).
renew_rentalRenew a rented numberADestructiveInspect
Keep a rented number for another period: the period is added to its current end, at today's price for that period in its country (see get_rental_offers). Possible from 2 hours after renting until 20 minutes before the end. Debits the wallet only if the renewal goes through. WARNING: this spends real wallet balance; confirm the number, period and price with the user first.
Inputs: number (required), period (required).
rent_numberRent a phone numberADestructiveInspect
Rent a phone number in a country for a period (get the periods and prices from get_rental_offers first). Debits the wallet and returns the number and when the rental ends. Read its SMS with read_rental_sms. WARNING: this spends real wallet balance; confirm the country, period and price with the user first.
Inputs: period (required), country (required).
set_rental_auto_renewTurn a rental's auto-renew on or offADestructiveIdempotentInspect
With auto-renew on, the number is renewed for its rental period from the wallet a day before it ends (6 hours before for a one-day rental); if the balance is short then, the account is emailed and nothing is charged. Turning it on lets the wallet be charged later: confirm with the user first.
Inputs: number (required), autoRenew (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Virtual phone numbers and SMS verification codes for AI agents: 800+ services, 200+ countries.
Virtual phone numbers for AI agents — rent numbers in 200+ countries, receive SMS.
Phone numbers for AI agents: get a number, read texted verification codes, place AI voice calls.
1Rent real and virtual phone numbers in 14 countries and read their SMS from your AI agent.
Related MCP Servers
- AlicenseAqualityBmaintenanceVirtual phone number platform for AI agents — rent numbers across 200+ countries, receive SMS, and manage the full activation lifecycle.662 npm4MIT
- AlicenseAqualityDmaintenanceGives AI agents real phone numbers to receive SMS and extract verification codes through tool calls.6MIT
- AlicenseAqualityCmaintenanceEnables AI agents to purchase phone numbers and retrieve one-time SMS/OTP verification codes via the CODASMS API, with support for 700+ services and 180+ countries including automatic refunds if no code arrives.732 npmMIT

VoidMob MCPofficial
AlicenseAqualityBmaintenancePhone numbers, mobile IPs and eSIMs for your AI agent.28181 npm22MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.