# AgentSIM

Real SIM-backed phone numbers for AI agents. Provision a real mobile number, capture OTP codes, and pass carrier verification. No VoIP, real T-Mobile SIM.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add agentsim/agentsim

# Browse available tools
npx -y @smithery/cli@latest tool list agentsim/agentsim

# Get full schema for a tool
npx -y @smithery/cli@latest tool get agentsim/agentsim provision_number

# Call a tool
npx -y @smithery/cli@latest tool call agentsim/agentsim provision_number '{}'
```

## Direct MCP Connection

Endpoint: `https://agentsim--agentsim.run.tools`

**Required config:**
- `apiKey` (query) — Your AgentSIM API key — get one at https://console.agentsim.dev

## Tools (5)

- `provision_number` — Lease a real mobile phone number for receiving SMS OTP codes.
- `wait_for_otp` — Block until an SMS OTP arrives for this session, then return the code.
- `get_messages` — List all SMS messages received in this session without consuming the OTP.
- `release_number` — Release a provisioned number back to the pool.
- `list_numbers` — List active sessions, optionally filtered by agent_id.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get agentsim/agentsim <tool-name>
```

## Resources

- `agentsim://status` — Current AgentSIM account status including active sessions and usage.
- `agentsim://docs/quickstart` — AgentSIM quickstart guide — how to get started in 60 seconds.

## Prompts (2)

- `verify_phone_number` (service, agent_id) — Step-by-step guide to verify a phone number on a target service.
- `debug_verification_failure` (error_message) — Diagnose why phone verification failed and suggest fixes.