Agentsim Mcp

agentsim-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)

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: agentsimdev
• Source: agentsimdev/agentsim-mcp
• License: MIT
• Homepage: https://agentsim.dev

Install and usage instructions live in the source repository linked above.