
AgentSIM
โ 1from agentsimdev
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.
agentsim-mcp
MCP server that exposes AgentSIM OTP session tools to AI coding assistants: Claude Code, Cursor, Windsurf, and any other MCP-compatible host.
Tools
| Tool | Description |
|---|---|
provision_number | Provision a temporary programmable US number for an OTP session โ returns number, session ID, expiry |
wait_for_otp | Long-poll until an OTP arrives on the session (returns parsed code) |
get_messages | List raw SMS messages received on a session |
release_number | Release a session early (number returned to pool) |
list_numbers | List 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)
claude mcp add agentsim -e AGENTSIM_API_KEY=asm_live_xxx -- uvx agentsim-mcpBefore it works, you'll need: AGENTSIM_API_KEY
Setup
Claude Code
claude mcp add agentsim -e AGENTSIM_API_KEY=asm_live_xxx -- uvx agentsim-mcpClaude 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_..."
}
}
}
}No common issues documented yet. If you hit a problem, the repository's GitHub Issues page is the best place to look.
Licensed under MITโ you can use, modify, and redistribute it under that license's terms.
View the full license file on GitHub โ