iEscrow

iEscrow MCP サーバー

iEscrow は暗号資産のエスクロープラットフォームです。すべての取引で、双方が引き渡しを完了するまで暗号資産は iEscrow が預かるため、どちらかが先に引き渡す必要はありません。このリポジトリでは、ユーザーの許可を得てそのユーザーに代わり iEscrow アカウントを操作する AI エージェント（Claude、ChatGPT、または任意の MCP ホスト）向けの iEscrow MCP サーバーについて説明します。

• エンドポイント： https://api.iescrow.io/mcp
• トランスポート： Streamable HTTP、ステートレス
• 認証： OAuth 2.1（認可サーバーは https://api.iescrow.io）、PKCE、動的クライアント登録
• ツール： 16 個。TOOLS.md に一覧があります
• ウェブサイト： https://iescrow.io · AI エージェント向け： https://iescrow.io/ai

基本方針：エージェントが準備し、人間が確定する

エージェントは見積もりの取得、取引の開始、残高や状態の確認、マーケットプレイス広告の準備を行えます。資金を動かす操作は、エージェントによって実行されることはありません。ツールは承認を作成し、リンクを返します。アカウント所有者がそのリンクを開くと、実行される内容を正確に確認して、2 要素認証コードで承認します。

設計上、エージェントには次の操作を決して行えません。

• アカウントから資金を引き出す
• 支払いアカウントを追加または変更する
• 支払いの領収書をアップロードする（専用リンクを使って人間だけが行えます）
• 人間の承認なしに暗号資産をエスクローにロックする、または支払いが到着したことを確認する
• 外部ウォレットに暗号資産を送る（すべてユーザーの iEscrow 残高に入金されます）

API はエージェントトークン用の許可リストでこれを強制しており、MCP サーバーは許可されたルートのみをラップします。

要件

次の条件を満たす iEscrow アカウントが必要です。

1. メールアドレスの認証が完了している
2. 本人確認（KYC）の承認を受けている
3. 2 要素認証（TOTP）が有効になっている

接続画面（/connect）では、トークンを発行する前にこの 3 つの条件を確認します。エージェントが取引を実行できるのは、iEscrow がエージェント向けに有効化されている国に限られます。利用可能な国は get_readiness で確認できます。

接続

Claude（claude.ai、デスクトップ、モバイル）

「設定」→「コネクター」→ 「カスタムコネクターを追加」 → 名前に iEscrow、URL に https://api.iescrow.io/mcp を指定します。Claude が認可サーバーを検出し、iEscrow の同意画面を開きます。承認すると接続が完了します。

Claude Code

claude mcp add --transport http iescrow https://api.iescrow.io/mcp

その後、Claude Code 内で /mcp を実行してログインを完了します。

ChatGPT

「設定」→「コネクター」→ 「作成」（開発者モード）→ 名前に iEscrow、MCP サーバー URL に https://api.iescrow.io/mcp、認証に 「OAuth」 を指定します。ChatGPT は自分自身をクライアントとして登録し、iEscrow の同意画面に移動します。

その他の MCP ホスト

上記の URL を Streamable HTTP トランスポートでホストに指定します。サーバーは /.well-known/oauth-protected-resource を公開し、認可サーバーは /.well-known/oauth-authorization-server を公開します。MCP 認可仕様に対応するホストであれば、それ以外の設定は不要です。設定例については examples/ を参照してください。

スコープ

スコープ	許可される操作
profile:read	ユーザーの情報、およびアカウントが取引可能な状態かどうかの確認
quotes:read	マーケットプレイスで実行可能なオファーと価格の確認
wallet:read	残高と一部をマスクした支払いアカウント情報の確認
trades:read	ユーザーの取引と広告の状態の確認
trades:write	取引の開始、暗号資産のロックまたは支払い確認の承認リクエスト、ユーザー自身のリクエストのキャンセル
ads:write	マーケットプレイス広告の準備（常に人間の承認が必要）。リソースメタデータでは提示されず、対応するホストから明示的に要求された場合に限り使用されます

スコープは同意画面で選択でき、ユーザーの iEscrow 設定にある 「接続済みアプリ」 からいつでも取り消せます。

レート制限

接続ごとに、1 分あたり 60 回、1 時間あたり 10 件の取引開始、1 時間あたり 20 件の資金移動を伴う承認リクエストが可能です。ユーザーごとに、同時実行できるロングポーリング（wait_for_trade_update）は 1 件です。制限を超えた呼び出しは error_key と retry_after_s を返します。

一般的なフロー（銀行振込で暗号資産を購入する場合）

1. get_readiness — アカウントで取引できることを確認します。
2. side=buy、暗号資産、法定通貨、金額を指定して get_quote を実行し、オファーを選びます。compatible_account_ids を控えておきます。
3. オファー ID、金額、互換性のある payment_account_id を指定して open_trade を実行します。
4. get_trade を実行し、crypto_funded が true になるまで待ちます。それまでは人間が支払いをしてはいけません。
5. get_proof_upload_link を実行し、ユーザーにリンクを渡します。リンクには正確な金額（セント単位の金額が支払いの照合キーです）と支払先の口座が表示されます。ユーザーは支払いを行い、領収書を添付して、そこで支払いを申告します。
6. wait_for_trade_update を実行します。売り手が確認すると、取引は released に移行します。暗号資産はユーザーの iEscrow 残高に入ります。

売却の場合は逆の流れです。side=sell を指定して open_trade を実行し、次に fund_escrow を実行します（人間がリンクからロックを承認します）。その後、法定通貨が着金したら confirm_received を実行します（これもリンクから承認します）。

エラー

すべてのエラーは、error: true、HTTP に似た status、固定の error_key、人間が読み取れる message を含む構造化コンテンツとして返されます。人間の操作が必要な場合、レスポンスには approval_required: true と approval.approve_url が含まれます。結果を確認するには、approval.public_id を指定して check_approval をポーリングします。

セキュリティ

MCP サーバーはデータベースを開かず、独自のシークレットも保持しません。ユーザーのアクセストークン（RS256、発行者と対象者を固定）を検証し、同じベアラートークンを API に転送します。エージェントチャネルに関する報告先：[email protected]。

このリポジトリについて

このリポジトリには、サーバーの公開ドキュメントと、MCP レジストリへの掲載に使うマニフェストが含まれています。サーバーのソースコードはここでは公開されていません。