About asms
asms is an MCP server for AI agents that need SMS verification or rented phone numbers. It also exposes account balance, pricing, inventory and order status, with spending actions requiring approval.
Key features
- 01Order one-time SMS verification numbers
- 02Rent numbers that receive SMS
- 03Check verification codes and rental messages
- 04View balance, prices, stock and orders
- 05Require approval for spending actions
Use cases
- 01Verify an account with a one-time code
- 02Test an app's SMS login flow
- 03Receive messages on a number rented for later verification
MCP support
The remote Streamable HTTP server exposes tools for ordering verification numbers, renting numbers, reading SMS and managing orders. Connect with OAuth or an API key.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://asms.ai/mcpclaude mcp add --transport http ai-asms-asms https://asms.ai/mcp{"mcpServers":{"ai-asms-asms":{"type":"http","url":"https://asms.ai/mcp"}}}Open in Cursor{"servers":{"ai-asms-asms":{"type":"http","url":"https://asms.ai/mcp"}}}Open in VS Code{"mcpServers":{"ai-asms-asms":{"type":"http","url":"https://asms.ai/mcp"}}}{"mcpServers":{"ai-asms-asms":{"serverUrl":"https://asms.ai/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
https://asms.ai/mcpAuth requiredTools
Details
From the project READMEasms MCP server
Phone numbers for AI agents. Connect asms.ai to Claude, ChatGPT, Codex, Cursor, Grok or any MCP client, and your agent can:
- get SMS verification codes: a one-time number for a service, charged only when the code arrives and refunded automatically when none does;
- rent phone numbers: a number of your own for a day to a year that receives every SMS sent to it, for testing your app's SMS login or an account you'll verify again later;
- check the account: balance, prices, stock and open orders.
Everything is paid from your asms wallet, and the tools that spend are marked so your client asks you first.
https://asms.ai/mcp
Remote server, Streamable HTTP. Sign in with your asms account (OAuth), or send an API key from your dashboard as Authorization: Bearer <key>.
Setup
Full step-by-step pages, including a prompt your agent can follow on its own, are at asms.ai/agents.
| Client | Quick setup |
|---|---|
| Claude Code | claude mcp add --transport http asms https://asms.ai/mcp, then /mcp to sign in |
| Claude (claude.ai, Desktop) | Customize → Connectors → Add custom connector → https://asms.ai/mcp |
| Codex | codex mcp add asms --url https://asms.ai/mcp --bearer-token-env-var ASMS_API_KEY |
| ChatGPT | Plugins → Add custom MCP server → https://asms.ai/mcp, OAuth |
| Cursor | Add to Cursor or ~/.cursor/mcp.json |
| VS Code | Install in VS Code or .vscode/mcp.json |
| Windsurf | serverUrl entry in Cascade's mcp_config.json |
| Gemini CLI | gemini mcp add --transport http asms https://asms.ai/mcp |
| opencode | remote entry in opencode.json |
| Cline | url + "type": "streamableHttp" entry in cline_mcp_settings.json (llms-install.md) |
| Grok | grok.com Connectors → Custom, or the xAI API mcp tool |
| OpenAI API | Responses API {"type": "mcp", "server_url": "https://asms.ai/mcp"} |
Most clients that take a URL and headers accept:
{
"mcpServers": {
"asms": {
"url": "https://asms.ai/mcp",
"headers": { "Authorization": "Bearer <ASMS_API_KEY>" }
}
}
}
Tools
| Tool | What it does | Needs your OK |
|---|---|---|
get_balance | Wallet balance | |
get_pricing | Verification code prices by country and service | |
get_inventory | Numbers in stock by country and service | |
create_otp_order | Order a number for one verification code | yes |
poll_sms | Check for the code on an order | |
list_active_orders | Orders waiting for a code or already received | |
cancel_order | Cancel an order (rarely needed: unfilled orders refund themselves) | yes |
get_rental_offers | Rental countries, periods and prices | |
rent_number | Rent a number for a period | yes |
list_rentals | Your rented numbers and their end dates | |
read_rental_sms | SMS received by a rented number | |
cancel_rental | Cancel a rental for a refund (5 to 120 minutes after renting, before any SMS) | yes |
Pricing
Connecting is free. Verification codes are priced per service and country and charged only when the code arrives; rentals are priced per country and period. See asms.ai/pricing.
Also
- Agent skills for Claude Code, Codex, Cursor and other agents
- REST API, same key and wallet
- llms.txt
License
MIT
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.