# asms

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: asms-ai
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/asms-ai/asms-mcp
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/asms

## What it 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.

## Requirements
- Remote server: `https://asms.ai/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http asms https://asms.ai/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add asms --url https://asms.ai/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "asms": {
            "url": "https://asms.ai/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "asms": {
            "type": "http",
            "url": "https://asms.ai/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http asms https://asms.ai/mcp
```

## When to use it
- 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
- 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.

## Similar
- [Quackr](https://affpapa.org/en/nevibecode/mcp/quackr.md) — MCP server
- [VirtualSMS](https://affpapa.org/en/nevibecode/mcp/virtualsms.md) — MCP server · 7933 installs
- [sms](https://affpapa.org/en/nevibecode/mcp/sms.md) — MCP server · ★ 9 repo stars
- [sent-account-readiness](https://affpapa.org/en/nevibecode/skills/sent-account-readiness.md) — skill · 2900 installs
- [Voxisim](https://affpapa.org/en/nevibecode/mcp/voxisim.md) — MCP server · ★ 19 repo stars
- [Hail](https://affpapa.org/en/nevibecode/mcp/hail.md) — MCP server · ★ 34 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
