mcp

MCP server that exposes AgentSIM OTP session 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

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)