# asms.ai

> asms.ai gives people and AI agents phone numbers to receive SMS on: one-time numbers for verification codes (from $0.50, charged only when a code arrives, refunded automatically otherwise), numbers rented for a day to a year that receive every SMS sent to them, and free public numbers. Online since 2018.

## MCP server

- Endpoint: https://asms.ai/mcp (Streamable HTTP, stateless)
- Auth: OAuth sign-in with an asms account, or the header "Authorization: Bearer <ASMS_API_KEY>" with a key from https://asms.ai/dashboard
- Tools that spend from the wallet are marked destructive; confirm the price with the user before calling them.
- Tools:
  - get_balance: Wallet balance
  - get_pricing: Verification code prices
  - get_inventory: Verification number stock
  - create_otp_order: Order a verification number (spends or refunds wallet money)
  - poll_sms: Check for the verification code
  - list_active_orders: List verification orders
  - cancel_order: Cancel a verification order (spends or refunds wallet money)
  - get_rental_offers: Number rental prices
  - rent_number: Rent a phone number (spends or refunds wallet money)
  - list_rentals: List rented numbers
  - read_rental_sms: Read a rented number's SMS
  - cancel_rental: Cancel a rental for a refund (spends or refunds wallet money)

## Setup per client

- [All agents](https://asms.ai/agents)
- [Use asms with Claude Code](https://asms.ai/agents/claude-code): One command in your terminal, then sign in with asms or pass an API key.
- [Use asms with Claude](https://asms.ai/agents/claude): claude.ai and Claude Desktop: add a custom connector and sign in with asms.
- [Use asms with Codex](https://asms.ai/agents/codex): Codex CLI, IDE extension and app: codex mcp add, then sign in or use a key.
- [Use asms with ChatGPT](https://asms.ai/agents/chatgpt): Add asms as a custom MCP server in ChatGPT and sign in with your asms account.
- [Use asms with Cursor](https://asms.ai/agents/cursor): One-click install, or a few lines in mcp.json.
- [Use asms with VS Code](https://asms.ai/agents/vscode): GitHub Copilot agent mode: one-click install or .vscode/mcp.json.
- [Use asms with Windsurf](https://asms.ai/agents/windsurf): Add asms to Cascade's MCP config.
- [Use asms with Gemini CLI](https://asms.ai/agents/gemini-cli): gemini mcp add, then sign in or use an API key.
- [Use asms with opencode](https://asms.ai/agents/opencode): A remote MCP entry in opencode.json, with sign-in or an API key.
- [Use asms with Grok](https://asms.ai/agents/grok): grok.com custom connector, or the remote MCP tool in the xAI API.
- [Use asms with OpenAI API](https://asms.ai/agents/openai-api): The remote MCP tool in the Responses API, for your own agents.
- [Use asms with any MCP client](https://asms.ai/agents/mcp-server): The URL, auth and tools, for any client that speaks remote MCP.

## REST API

- [API docs](https://asms.ai/api-docs): same key, same wallet
- GET https://asms.ai/api/v1/balance
- GET https://asms.ai/api/v1/otp/services?country=us
- POST https://asms.ai/api/v1/otp/order {"service":"telegram","country":"us"}
- GET https://asms.ai/api/v1/otp/sms?id=<activationId>
- [OpenAPI](https://asms.ai/api/v1/openapi.json)

## Products

- [Verification codes (pay per code)](https://asms.ai/otp)
- [Rent a number](https://asms.ai/numbers)
- [Pricing](https://asms.ai/pricing)
- [Free public numbers](https://asms.ai/free-phone-numbers)
- [FAQ](https://asms.ai/faq)