Phone numbers for AI agents: SMS verification codes and rented numbers that receive SMS.
Connect Remote server
claude mcp add --transport http asms https://asms.ai/mcp --header "Authorization: Bearer <YOUR_API_KEY>"
{
"mcpServers": {
"asms": {
"url": "https://asms.ai/mcp",
"headers": {
"Authorization": "Bearer <YOUR_API_KEY>"
}
}
}
}
{
"servers": {
"asms": {
"type": "http",
"url": "https://asms.ai/mcp",
"headers": {
"Authorization": "Bearer <YOUR_API_KEY>"
}
}
}
}
Settings > Connectors > Add custom connector
URL: https://asms.ai/mcp
Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools 14 found in our last check
get_balanceGet the current wallet balance for the authenticated account.
get_pricingGet the retail price per OTP activation for a service in a country. Omit `service` to list prices for every available service.
get_inventoryGet how many numbers are in stock for a service in a country. Omit `service` to list stock for every available service.
create_otp_orderBuy 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…
poll_smsCheck 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) a…
list_active_ordersList recent OTP orders for the account (awaiting a code or already received).
cancel_orderRarely 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…
get_rental_offersList 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.
rent_numberRent 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 an…
list_rentalsList 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.
read_rental_smsRead the SMS a rented number has received during this rental, newest first. Poll again every few seconds while waiting for a message.
cancel_rentalCancel 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.
renew_rentalKeep 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. WARN…
set_rental_auto_renewWith 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 t…
Headers
| Name | Description |
|---|---|
AuthorizationOptional, secret | Optional: "Bearer <asms API key>" from https://asms.ai/dashboard. Clients that support MCP sign-in (OAuth) don't need it. |
Details
| Endpoint | https://asms.ai/mcp (Streamable HTTP) |
| First published | 29 Oct 2026 |
| Last updated | 29 Oct 2026 |
| Registry name | ai.asms/asms |
More communication servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.
