asms
Phone numbers for AI agents: SMS verification codes and rented numbers that receive SMS.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
claude mcp add --transport http asms 'https://asms.ai/mcp' --header 'Authorization: <Optional: "Bearer <asms API key>" from https://asms.ai/dashboard. Clients that support MCP sign-in (OAuth) don'\''t need it.>'{
"mcpServers": {
"asms": {
"type": "http",
"url": "https://asms.ai/mcp",
"headers": {
"Authorization": "<Optional: \"Bearer <asms API key>\" from https://asms.ai/dashboard. Clients that support MCP sign-in (OAuth) don't need it.>"
}
}
}
}Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
asms 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/mcpRemote 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 |
| 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
Frequently asked questions
What is asms?
Phone numbers for AI agents: SMS verification codes and rented numbers that receive SMS.
How do I install asms?
It runs as a remote server. In Claude Code: claude mcp add --transport http asms 'https://asms.ai/mcp' --header 'Authorization: <Optional: "Bearer <asms API key>" from https://asms.ai/dashboard. Clients that support MCP sign-in (OAuth) don'\''t need it.>'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does asms need an API key?
Yes. It expects Authorization, which you set in its configuration.
Is asms open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains asms?
It is published by asms-ai. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.