iEscrow

iEscrow MCP 服务

iEscrow 是一个加密货币托管平台：每笔交易中的加密货币都由 iEscrow 保管，直到双方都完成交付，因此任何一方都不必先行交付。本仓库介绍 iEscrow MCP 服务，它让 AI Agent（Claude、ChatGPT 或任何 MCP 主机）能够代表授权该服务的用户操作 iEscrow 账户。

• 端点： https://api.iescrow.io/mcp
• 传输方式： Streamable HTTP，无状态
• 身份验证： OAuth 2.1（授权服务器位于 https://api.iescrow.io）、PKCE、动态客户端注册
• 工具： 16 个，详见 TOOLS.md
• 网站： https://iescrow.io · 面向 AI Agent： https://iescrow.io/ai

原则：Agent 准备，人类确认

Agent 可以获取报价、发起交易、查看余额和状态，以及准备市场广告。任何会转移资金的操作都不会由 Agent 执行：工具会创建审批请求并返回链接。账户所有者打开该链接，查看即将发生的操作详情，并使用双重身份验证代码批准。

根据设计，Agent 永远不能：

• 从账户中提取资金，
• 添加或更改支付账户，
• 上传支付凭证（只有人类可以通过专用链接上传），
• 未经人类批准，将加密货币锁定到托管中，或确认已收到款项，
• 将加密货币转入外部钱包（所有款项都会进入用户的 iEscrow 余额）。

API 通过为 Agent 令牌设置路由允许列表来实施这些限制；MCP 服务只封装这些路由。

要求

iEscrow 账户需满足以下条件：

1. 邮箱已验证，
2. 身份验证（KYC）已通过审核，
3. 已启用双重身份验证（TOTP）。

连接页面（/connect）会在发放令牌前检查这三项。只有在 iEscrow 已为 Agent 开放服务的国家/地区，Agent 才能执行交易；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 设置中的 已连接的应用 页面撤销。

速率限制

每个连接每分钟最多调用 60 次，每小时最多发起 10 笔交易，每小时最多请求 20 次资金转移审批。每位用户只能同时进行一个长轮询（wait_for_trade_update）。受限调用会返回 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，固定颁发者和受众），并将相同的 bearer 转发给 API。有关 Agent 渠道的报告，请联系：[email protected]。

关于此代码库

此代码库包含该服务的公开文档，以及用于在 MCP 注册表中列出该服务的清单。此处不发布服务的源代码。