Give your AI agent a phone number.
One MCP server connects asms to Claude, ChatGPT, Codex, Cursor, Grok and any MCP client. Your agent gets verification codes from $0.50 and numbers you rent for a day to a year, paid from your asms wallet.
https://asms.ai/mcp{
"mcpServers": {
"asms": {
"url": "https://asms.ai/mcp",
"headers": { "Authorization": "Bearer <ASMS_API_KEY>" }
}
}
}Set up asms in your agent
Step-by-step setup for each client, plus a prompt your agent can follow on its own.
Claude Code
One command in your terminal, then sign in with asms or pass an API key.
Claude
claude.ai and Claude Desktop: add a custom connector and sign in with asms.
Codex
Codex CLI, IDE extension and app: codex mcp add, then sign in or use a key.
ChatGPT
Add asms as a custom MCP server in ChatGPT and sign in with your asms account.
Cursor
One-click install, or a few lines in mcp.json.
VS Code
GitHub Copilot agent mode: one-click install or .vscode/mcp.json.
Windsurf
Add asms to Cascade's MCP config.
Gemini CLI
gemini mcp add, then sign in or use an API key.
opencode
A remote MCP entry in opencode.json, with sign-in or an API key.
Grok
grok.com custom connector, or the remote MCP tool in the xAI API.
OpenAI API
The remote MCP tool in the Responses API, for your own agents.
any MCP client
The URL, auth and tools, for any client that speaks remote MCP.
How it works
Connect
Add the asms MCP server to your agent: sign in with asms, or use an API key.
Ask in plain words
“Get me a UK number for WhatsApp and wait for the code.” The agent picks the tools.
Approve what it spends
Ordering and renting are marked as spending, so your agent asks before it pays.
The tools
| Tool | What it does | Needs your OK? |
|---|---|---|
get_balance | Wallet balance | No |
get_pricing | Verification code prices | No |
get_inventory | Verification number stock | No |
create_otp_order | Order a verification number | Yes |
poll_sms | Check for the verification code | No |
list_active_orders | List verification orders | No |
cancel_order | Cancel a verification order | Yes |
get_rental_offers | Number rental prices | No |
rent_number | Rent a phone number | Yes |
list_rentals | List rented numbers | No |
read_rental_sms | Read a rented number's SMS | No |
cancel_rental | Cancel a rental for a refund | Yes |
Prefer plain HTTP? The same account works with the REST API.
Questions
What is the asms MCP server?+
A remote Model Context Protocol server at https://asms.ai/mcp. Any AI client that supports remote MCP (Claude, ChatGPT, Codex, Cursor, VS Code, Gemini CLI, Grok and more) can use it to get verification codes and rented phone numbers from your asms account.
Do I need an API key?+
Not for clients that support sign-in: you log in with your asms account and approve. Clients without sign-in use an API key from your dashboard, sent as Authorization: Bearer <key>.
What does it cost?+
Connecting is free. You pay from your asms wallet: verification codes from $0.50, charged only when a code arrives and refunded automatically when none does, and rented numbers priced by country and period. Top up by card, PayPal or crypto.
Will my agent spend money without asking?+
Ordering a code and renting a number are marked as spending tools, so clients that support it ask for your approval first, and asms tells the agent to confirm the price with you before buying. Reading prices, balances and messages never spends anything.
What's the difference between a code and a rented number?+
A verification code order gives you a number for one code, for one service, and refunds itself if nothing arrives. A rented number is yours for a set period, from a day to a year, and receives every SMS sent to it: useful for testing your own app's SMS login or for an account you'll need to verify again later.
Connect in a minute
Create an account, top up from a few dollars, and add asms to your agent.