AnonymSMS is now asms.ai:Read
asms.ai
Pay Per Service (OTP)Per Service (Long Term)Rent a Number (Long Term)APIAI AgentsPricingFAQ
Log inGet started
MCP for AI agents

Use asms with Claude Code

Add asms to Claude Code with one command. Claude can then get verification codes, rent numbers and read their SMS while it works in your terminal.

Set it up Get an API key
Sign in or API key Codes from $0.50, refunded if none arrives Asks before it spends
Claude Code

> Get me a US number for Telegram and give me the code when it arrives.

● asms.get_pricing({ "country": "us", "service": "telegram" }) → in stock

US Telegram numbers are in stock at the listed price, and you're only charged if a code arrives. Order one?

> Yes, go ahead.

● asms.create_otp_order({ "country": "us", "service": "telegram" }) → +1 347 •••-••18

● asms.poll_sms({ "orderId": "…" }) → code received

Your number is +1 347 •••-••18 and the Telegram code is 504913.

What you can ask Claude Code

Once asms is connected, Claude Code can order numbers, read the SMS they receive and check your account, all paid from your asms wallet.

Get a verification code

“Order a UK number for WhatsApp and wait for the code.”

Rent a number you keep

“Rent a US number for a month for our app's SMS login tests, and show me any texts it gets.”

Check the account

“What's my asms balance, and which orders are still waiting for a code?”

Setup

Sign in with your asms account, or use an API key from your dashboard. Either way Claude Code uses your asms wallet.

The quick way: paste a prompt

Paste this into Claude Code. It reads this page and follows the steps for agents below.

prompt
Connect the asms MCP server to Claude Code by following the steps for AI agents at https://asms.ai/agents/claude-code. My asms API key is in the ASMS_API_KEY environment variable; don't print it.

Or step by step

  1. 1

    Add the server

    Then run /mcp inside Claude Code and sign in with your asms account.

    sign in with asms
    claude mcp add --transport http asms https://asms.ai/mcp
  2. 2

    Or use an API key instead

    Create a key in your dashboard and keep it in ASMS_API_KEY. Add --scope user to use asms in every project.

    API key
    claude mcp add --transport http asms https://asms.ai/mcp \
  --header "Authorization: Bearer $ASMS_API_KEY"
  3. 3

    Check it

    Then ask: “What's my asms balance?”

    should show asms ✔ Connected
    claude mcp list

For AI agents reading this page

If a user asked you to connect asms to Claude Code, follow these steps in order.

  1. Check whether the ASMS_API_KEY environment variable is set, without printing its value. If it is not set, the user can either sign in with asms when Claude Code prompts for it, or create a key at https://asms.ai/dashboard#api-keys and set ASMS_API_KEY.
  2. Register the server: run `claude mcp add --transport http asms https://asms.ai/mcp --header "Authorization: Bearer $ASMS_API_KEY"` (or without --header, then the user signs in with /mcp).
  3. Check it worked: run `claude mcp get asms` and confirm it says Connected (or “Needs authentication”, which means the user still has to sign in with /mcp).
  4. If tools don't appear, ask the user to restart Claude Code (`claude --continue` keeps the conversation).
  5. Start read-only: call get_balance, then get_pricing or get_rental_offers, and report what you found.
  6. Before any tool that spends from the wallet (create_otp_order, rent_number), tell the user the price and wait for their OK.
  7. Never create an asms account or API key, top up the wallet, or approve a sign-in on the user's behalf, and never print the key.

Reference

MCP endpointhttps://asms.ai/mcp
TransportStreamable HTTP (stateless)
AuthOAuth sign-in with asms, or the header Authorization: Bearer <ASMS_API_KEY>
REST APIhttps://asms.ai/api-docs
For LLMshttps://asms.ai/llms.txt

Tools

ToolWhat it doesNeeds your OK?
get_balanceWallet balanceNo
get_pricingVerification code pricesNo
get_inventoryVerification number stockNo
create_otp_orderOrder a verification numberYes
poll_smsCheck for the verification codeNo
list_active_ordersList verification ordersNo
cancel_orderCancel a verification orderYes
get_rental_offersNumber rental pricesNo
rent_numberRent a phone numberYes
list_rentalsList rented numbersNo
read_rental_smsRead a rented number's SMSNo
cancel_rentalCancel a rental for a refundYes

Other agents and tools

Claude Codex ChatGPT Cursor VS Code Windsurf Gemini CLI opencode Grok OpenAI API any MCP client

Questions

Can I share the setup with my team?+

Yes. Add it with --scope project and Claude Code writes a .mcp.json file in your repo. Each person then signs in with their own asms account, or sets their own ASMS_API_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 Claude Code 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.

How do I disconnect it?+

Delete the API key in your asms dashboard, or remove asms under Connected apps if you signed in. Either one cuts off access straight away.

Give Claude Code a phone number

Create an account, top up from a few dollars, and connect. Codes from $0.50, refunded automatically when none arrives.

Create your account All agents