asms — Claude Code MCP server: what it does, how to install
Hands your agent phone numbers: a one-off number for a verification code, or a rental that keeps taking messages. Paid from an asms wallet.
MIT updated 2026-10-29
claude mcp add --transport http asms https://asms.ai/mcpWhat asms does
The server is remote and speaks Streamable HTTP at https://asms.ai/mcp. Your agent gets three sets of tools: a single-use number for one verification code (create_otp_order, poll_sms), rentals running from a day up to a year (rent_number, read_rental_sms), and account lookups for balance, prices, stock and open orders.
Auth is either OAuth through an asms account or a dashboard key passed as Authorization: Bearer <key>. Tools that spend money are flagged, so the client asks you first. A code costs nothing until the SMS lands; with no SMS, the refund happens on its own. Rentals can be cancelled for a refund between 5 and 120 minutes after ordering, but only before the first message hits the number. Once it does, that window is gone.
Claude Code needs a single command, then /mcp to sign in. Cursor and GitHub Copilot take a JSON entry, while Codex and Gemini CLI each have their own mcp add command.
What it helps with
- get a verification code without a personal SIM
- rent a number for a month to test SMS login
- compare code prices per country before ordering
- check which numbers are in stock right now
- read the messages that reached a rented number
Example prompts for the agent
- Order a number for this signup and wait for the SMS.
- What does a code cost for this service, and is a number in stock?
- Rent a number for a week and show me the messages it received.
How to install asms
Platform CLI: remote server
claude mcp add --transport http asms https://asms.ai/mcpPlatform CLI: remote server
codex mcp add asms --url https://asms.ai/mcpConfig file
{
"mcpServers": {
"asms": {
"url": "https://asms.ai/mcp"
}
}
}Config file
{
"servers": {
"asms": {
"type": "http",
"url": "https://asms.ai/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http asms https://asms.ai/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about asms
How do I install asms in Claude Code?
Run claude mcp add --transport http asms https://asms.ai/mcp, then type /mcp and sign in with your asms account.
What does asms do?
It gives an agent phone numbers: a single-use one for an SMS code or a rental that keeps receiving messages, plus tools for balance, pricing and stock.
Can I cancel a rental?
Yes, with a refund, if you cancel between 5 and 120 minutes after renting and before any SMS arrives. A message that already came in ends that option.