Agentsim

agentsim-mcp

利用可能状況： 所有する公開 HTTPS サービスのオリジンを正確に検証し、許可ポリシーを設定すれば、ライブ SMS をセルフサービスで利用できます。Hobby には UTC 月あたり 10 件の米国ライブ SMS セッションが含まれ、アカウントごとに有効なライブセッションを 1 件利用できます。カードは不要です。Builder は月額 $99 で、米国ライブ SMS セッションが 50 件含まれます。決済前に、税額と更新条件がチェックアウト画面に表示されます。既存の契約条件はそのまま適用されます。ライブの使用例を利用する前に、現在のアクセス状況とチャネルのサポート状況を確認してください。

AI コーディングアシスタント（Codex CLI、Claude Code、Cursor、Windsurf、およびその他の MCP 対応ホスト）に AgentSIM のチャレンジツールを提供する MCP サーバーです。主なツール：open_challenge、wait_for_verdict。エイリアス：provision_number、wait_for_otp。

セットアップ

Codex CLI の場合は、Codex の接続に従ってください。キーの取り扱い、SMS の待機タイムアウト、ブラウザーアクセスについて説明しています。その後、電話番号でのサインインを完了するプロンプトを使用してください。

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_API_KEY を指定し、stdio MCP サーバーとして agentsim-mcp を追加します。

リモート（インストール不要）

ローカルに何もインストールせず、ホストされている 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	チャレンジを開始せず、SMS を送信せず、利用枠を消費することなく、コンソールに固定のエージェント 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	SMS のメタデータと解析済みコードを読み取ります。コードを読み取ると消費されます
release_number	セッションを早期に解放します（割り当てはプールに戻ります）
list_numbers	このアカウントのすべてのアクティブなセッションを一覧表示します

旧エイリアス（後方互換性）

ツール	対応先	説明
provision_number	open_challenge(channel=sms_otp)	SMS OTP 用の一時的なプログラム可能な米国の電話番号を割り当てます。後方互換性のために維持されています
wait_for_otp	wait_for_verdict	タイムアウト後の自動延長がデフォルトで有効な旧式の待機方法です。番号は変更されない場合があります

認証

stdio の場合、プロセス環境で AGENTSIM_API_KEY を設定します。ホストされている HTTP の場合、各リクエストで個別の x-api-key を送信する必要があります。サーバーは呼び出し元に紐づくそのキーを検証して転送します。console.agentsim.dev でキーを取得してください。

対応国

米国