Agentsim

agentsim-mcp

**可用性：**完成精确来源验证并设置允许策略后，用户可自行启用自有公共 HTTPS 服务的实时短信功能。Hobby 套餐每个 UTC 月包含 10 次美国实时短信会话，每个账户同时只能有一个实时会话，且无需信用卡。Builder 套餐为 $99/月，包含 50 次美国实时短信会话。结账时会在付款前显示税费和续订条款；现有协议仍按原条款执行。使用实时示例前，请查看当前访问权限和渠道支持。

此 MCP 服务向 AI 编码助手开放 AgentSIM 挑战工具：Codex CLI、Claude Code、Cursor、Windsurf，以及其他任何兼容 MCP 的宿主。主要工具：open_challenge、wait_for_verdict。别名：provision_number、wait_for_otp。

设置

对于 Codex CLI，请按照连接 Codex 操作。该指南涵盖密钥处理、短信等待超时和浏览器访问。然后使用完整的手机号登录提示词。

Claude Code

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

Claude Desktop

将以下内容添加到 ~/Library/Application Support/Claude/claude_desktop_config.json：

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

Cursor / Windsurf

将 agentsim-mcp 添加为 stdio MCP 服务，并在环境配置中设置 AGENTSIM_API_KEY。

远程（无需安装）

直接连接托管的 MCP 服务，无需在本地安装任何内容：

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

托管端点使用无状态 HTTP，不会发出 mcp-session-id 标头。AgentSIM 工具返回的 session_id 用于标识挑战，并且在多次工具调用之间保持有效。

工具

控制平面名词（推荐）

工具	描述
identify_agent	在控制台中添加稳定的 Agent ID，无需开启挑战、发送短信或消耗额度
open_challenge	为必需的自有 service_url 开启身份验证挑战会话；接受渠道（sms_otp | email_otp | magic_link | webauthn_required），返回会话 ID 和标识符
wait_for_verdict	长轮询等待挑战结果——返回结构化结果，包括 otp_code、magic_link 或 webauthn_required；策略拒绝会在开启挑战时失败
get_messages	读取短信元数据和解析出的验证码；读取验证码会消耗它们
release_number	提前释放会话（将分配资源归还池中）
list_numbers	列出此账户的所有活动会话

旧版别名（向后兼容）

工具	映射到	描述
provision_number	open_challenge(channel=sms_otp)	配置用于短信 OTP 的临时可编程美国号码——保留以实现向后兼容
wait_for_otp	wait_for_verdict	旧版等待方式；默认在超时后自动延长，号码可能不变

身份验证

对于 stdio，请在进程环境中设置 AGENTSIM_API_KEY。对于托管 HTTP，每个请求都必须携带自己的 x-api-key；服务会验证并转发该调用方专属的密钥。请前往 console.agentsim.dev 获取密钥。

支持的国家/地区

美国