Agentsim

dev.agentsim由 agentsim.dev 發布官方發布者v0.33.3更新於 Oct 24, 2026

Control plane for agent auth walls. Connector 0 handles SMS OTP with US test numbers.

已驗證Streamable HTTP可網頁執行開發者工具溝通與協作安全與監控

概覽

AI 產生的概覽

讓 AI 程式開發助理為自有服務開啟驗證挑戰，並等待簡訊驗證碼、電子郵件驗證碼、魔法連結或 WebAuthn 的判定結果。

可以做什麼
向相容 MCP 的程式開發助理提供 AgentSIM 挑戰工具。open_challenge 針對必填的自有 service_url 開啟驗證挑戰工作階段，可指定 sms_otp、email_otp、magic_link 或 webauthn_required 等管道，回傳工作階段 ID 與識別碼。wait_for_verdict 長輪詢等待判定結果，回傳包含 otp_code、magic_link 或 webauthn_required 的結構化結果。輔助工具包括 identify_agent、get_messages、release_number 與 list_numbers，另有相容舊版的 provision_number 與 wait_for_otp 別名。
適用情境
適合助理在開發或測試中需要完成針對自有服務的手機或電子郵件登入流程時使用，例如端到端跑通簡訊驗證碼挑戰。適用於支援 MCP 的程式開發助理，如 Codex CLI、Claude Code、Cursor 與 Windsurf。不適用於非自有服務，也不支援美國以外的簡訊號碼。
執行需求
可使用託管 streamable HTTP 端點 uvx agentsim-mcp 在本機以 stdio 執行。必須驗證：stdio 需在行程環境中設定 AGENTSIM_API_KEY，託管 HTTP 需每個請求帶 x-api-key 標頭。金鑰需從 AgentSIM 主控台取得。即時簡訊僅支援美國號碼，且需要自有公開 HTTPS 服務、通過精確來源驗證並符合允許政策。
安裝前請注意
需要 API 金鑰：stdio 方式使用 AGENTSIM_API_KEY，託管 HTTP 方式每個請求需帶 x-api-key 標頭，該金鑰依呼叫方限定並由伺服器轉送。即時簡訊工作階段按量計費：Hobby 每月（UTC）含 10 次美國即時簡訊工作階段，每帳號同時僅一個進行中的即時工作階段；Builder 為每月 99 美元、含 50 次工作階段，可能產生費用。使用 get_messages 讀取驗證碼會消耗驗證碼。即時簡訊需通過精確來源驗證與允許政策，政策拒絕會在開啟時失敗。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Agentsim，將其新增到工作區。
  2. 連接 所需的 憑證。它們會被私密儲存，絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/dev.agentsim%2Fmcp/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。 客戶端會在首次連接時完成 OAuth 登入。

{
  "mcpServers": {
    "agentsim": {
      "type": "http",
      "url": "https://mcp.agentsim.dev/mcp"
    }
  }
}

README

agentsim-mcp

Availability: Live SMS is self-serve for owned public HTTPS services after exact-origin verification and an allow policy. Hobby includes 10 live US SMS sessions per UTC month, with one active live session per account and no card required. Builder is $99/month and includes 50 live US SMS sessions. Checkout shows tax and renewal terms before payment, and existing agreements keep their terms. Check current access and channel support before using live examples.

MCP server that exposes AgentSIM challenge tools to AI coding assistants: Codex CLI, Claude Code, Cursor, Windsurf, and any other MCP-compatible host. Primary tools: open_challenge, wait_for_verdict. Aliases: provision_number, wait_for_otp.

Setup

For Codex CLI, follow Connect Codex. It covers key handling, the SMS wait timeout, and browser access. Then use the complete phone sign-in prompt.

Claude Code

bash
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:

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:

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

The hosted endpoint uses stateless HTTP and does not issue mcp-session-id headers. The session_id returned by AgentSIM tools identifies a challenge and remains valid across tool calls.

Tools

Control-Plane Nouns (Recommended)

ToolDescription
identify_agentAdd a stable agent ID to the console without opening a challenge, sending SMS, or using allowance
open_challengeOpen an authentication challenge session for a required owned service_url; accepts channel (sms_otp | email_otp | magic_link | webauthn_required), returns session ID + identifier
wait_for_verdictLong-poll for the challenge verdict — returns structured outcome including otp_code, magic_link, or webauthn_required; policy denial fails on open
get_messagesRead SMS metadata and parsed codes; reading codes consumes them
release_numberRelease a session early (allocation returned to pool)
list_numbersList all active sessions for this account

Legacy Aliases (Backward Compatibility)

ToolMaps toDescription
provision_numberopen_challenge(channel=sms_otp)Provision a temporary programmable US number for SMS OTP — kept for backward compatibility
wait_for_otpwait_for_verdictLegacy wait with automatic extension after timeout by default; number may be unchanged

Auth

For stdio, set AGENTSIM_API_KEY in the process environment. For hosted HTTP, every request must send its own x-api-key; the server validates and forwards that caller-scoped key. Get a key at console.agentsim.dev.

Supported Countries

US

來源：README.md，提交 aa484e9

工具

0
該伺服器需要 API 金鑰等憑證，因此 SourceWeft 無法在沒有憑證的情況下讀取其工具，也未收錄。

版本歷史

9
  1. v0.33.3最新Sep 29, 2026
  2. v0.33.2Sep 29, 2026
  3. v0.33.1Sep 29, 2026
  4. v0.33.0Sep 28, 2026
  5. v0.32.2Sep 27, 2026
  6. v0.32.0Sep 27, 2026
  7. v0.31.0Sep 25, 2026
  8. v0.30.0Sep 24, 2026
  9. v0.29.1Sep 16, 2026

評分

已滿足適用檢查項的 85%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分