AgentSIM

Real SIM-backed mobile numbers for AI agents. Provision phone numbers, receive SMS, and capture OTP codes — bypasses VoIP blocks that reject Twilio/Vonage. 5 tools: provision_number, wait_for_otp, get_messages, release_number, list_numbers.

GitHub

agentsim-mcp

MCP server that exposes AgentSIM phone number tools to AI coding assistants — Claude Code, Cursor, Windsurf, and any other MCP-compatible host.

Setup

Claude Code

claude mcp add agentsim -e AGENTSIM_API_KEY=asm_live_xxx -- uvx agentsim-mcp

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "agentsim": {
      "command": "uvx",
      "args": ["agentsim-mcp"],
      "env": {
        "AGENTSIM_API_KEY": "asm_live_xxx"
      }
    }
  }
}

Cursor / Windsurf

Add agentsim-mcp as a stdio MCP server with AGENTSIM_API_KEY in the environment config.

Remote (no install)

Connect directly to the hosted MCP server without installing anything locally:

{
  "mcpServers": {
    "agentsim": {
      "type": "streamable-http",
      "url": "https://mcp.agentsim.dev/mcp",
      "headers": {
        "x-api-key": "asm_live_..."
      }
    }
  }
}

Tools

ToolDescription
provision_numberProvision a phone number for an agent — returns number, session ID, expiry
wait_for_otpLong-poll until an OTP arrives on the session (returns parsed code)
get_messagesList raw SMS messages received on a session
release_numberRelease a session early (number returned to pool)
list_numbersList all active sessions for this account

Auth

Set AGENTSIM_API_KEY in your environment. Get your key at console.agentsim.dev.

Supported Countries

US (more coming soon)

संबंधित सर्वर