Hive Agent Kyc

hive-mcp-agent-kyc

KYC/AML 筛查的经纪／观察层 · CLEAN-MONEY 门禁基础组件

https://hive-mcp-gateway.onrender.com/agent-kyc/mcp

---

范围免责声明

Hive Agent KYC 是一个经纪／观察层。它会将筛查请求路由到第三方服务提供商，并显示公开制裁名单中的匹配项。它不是受监管的货币服务业务，不会作出托管、借贷或交易许可决定，也不会代表受监管实体出具合规证明。最终合规判定由请求方 Agent 及其运营者负责。

每个工具的响应载荷、/.well-known/agent.json 和 JSON-LD description 中也会原文显示此免责声明。

---

这是什么

hive-mcp-agent-kyc 是一个模型上下文协议（MCP）服务，任何兼容 MCP 的客户端（Claude Desktop、Cursor、Manus、Agent 运行时）都可以调用它来：

1. 将区块链地址筛查请求路由到三家第三方 KYC/AML 服务提供商之一——Chainalysis、TRM Labs 或 Elliptic——并原样返回服务提供商的风险评分和标记（不进行数据增强，也不添加 Hive 评分层）。
2. 检查公开制裁名单中的匹配项，包括 OFAC SDN 名单和 FATF 高风险司法管辖区名单。
3. 读取此前查询的审计日志条目（仅包含 DID、时间戳、服务提供商和结果代码，不含个人身份信息）。

它不会：

• 托管任何 KYC 文件。
• 对交易作出最终的允许／拒绝判定。
• 出具证明，声称某个人／实体“已通过 Hive 的 KYC”。
• 作为货币服务业务运营。

其目的是提供 CLEAN-MONEY 门禁基础组件，供其他 Hive 界面（Vault、Trade、Swap、Treasury）在结算前调用。合规判定仍由调用方运营者负责。

• 协议：基于 Streamable-HTTP / JSON-RPC 2.0 的 MCP 2024-11-05
• 传输方式：POST /mcp
• 发现：GET /.well-known/mcp.json、GET /.well-known/agent.json
• 运行状况：GET /health
• 结算：真实 x402——向钱包 0x15184bf50b3d3f52b60434f8942b7d52f2eb436e 支付 Base L2 上的 USDC。非模拟，非虚构。
• 后端状态：服务提供商合作密钥尚待配置——在完成配置前，agent_kyc_screen_address 会返回 503 和 backend_pending: true。公开名单工具（OFAC、FATF）目前会返回真实数据。
• 品牌金色：Pantone 1245 C / #C08D23

---

工具

工具	费用	描述
agent_kyc_screen_address	$0.10 USDC (Base)	将筛查请求路由至 Chainalysis / TRM Labs / Elliptic。原样返回服务提供商的响应。配置密钥前返回 503 backend_pending。
agent_kyc_check_ofac_list	免费	根据 OFAC SDN 公开名单检查标识符。缓存 24 小时。
agent_kyc_check_fatf_list	免费	根据 FATF 的呼吁采取行动名单和加强监控名单检查 ISO-3166 国家代码。
agent_kyc_query_status	免费	按 query_id 读取先前的审计日志条目。返回 DID + 时间戳 + 服务提供商 + 结果代码 + 地址哈希。不含 PII。

agent_kyc_screen_address

{
  "name": "agent_kyc_screen_address",
  "arguments": {
    "address": "0x...",
    "chain": "base",
    "provider": "chainalysis",
    "requester_did": "did:hive:agent-vault"
  }
}

在配置合作伙伴密钥之前，返回：

{
  "ok": false,
  "status": 503,
  "backend_pending": true,
  "message": "Third-party screening backend not yet configured...",
  "x402": {
    "recipient": "0x15184bf50b3d3f52b60434f8942b7d52f2eb436e",
    "chain": "base",
    "asset": "USDC",
    "amount_usdc": 0.10
  }
}

agent_kyc_check_ofac_list

{
  "name": "agent_kyc_check_ofac_list",
  "arguments": { "identifier": "0x...", "identifier_type": "address" }
}

返回缓存时长、来源 URL (treasury.gov)，以及与缓存 SDN 名单进行确定性匹配的标志。

agent_kyc_check_fatf_list

{
  "name": "agent_kyc_check_fatf_list",
  "arguments": { "country_code": "IR" }
}

返回类别（call_for_action | increased_monitoring | not_listed）+ FATF 来源 URL。

agent_kyc_query_status

{
  "name": "agent_kyc_query_status",
  "arguments": { "query_id": "..." }
}

---

审计日志

审计日志仅在内存中存储每次查询的以下字段：

• query_id（UUID）
• did（发起请求的 Agent 的 DID）
• ts（ISO-8601 时间戳）
• provider（chainalysis | trm | elliptic | ofac_public | fatf_public）
• result_code（返回的 HTTP 状态码）
• address_hash（小写标识符的 SHA-256 哈希值的前 16 个十六进制字符）

绝不存储原始地址、姓名和 PII。希望持久化日志的运营方可通过 webhook 将其路由到自己的 SIEM（这不属于 Hive 的职责）。

---

连接

Claude Desktop

{
  "mcpServers": {
    "hive-agent-kyc": {
      "url": "https://hive-mcp-gateway.onrender.com/agent-kyc/mcp"
    }
  }
}

Cursor / Manus / 通用 MCP 客户端

将客户端指向：

https://hive-mcp-gateway.onrender.com/agent-kyc/mcp

Streamable-HTTP 传输，JSON-RPC 2.0，MCP 2024-11-05。

本地

git clone https://github.com/srotzin/hive-mcp-agent-kyc
cd hive-mcp-agent-kyc
npm install
node server.js
# server runs on :3000

若要在本地启用筛查服务提供商路由，请设置以下任意一项：

export CHAINALYSIS_API_KEY=...
export TRM_API_KEY=...
export ELLIPTIC_API_KEY=...

未设置密钥时，agent_kyc_screen_address 会返回 503 backend_pending。OFAC 和 FATF 工具无需密钥即可使用。

---

结算

真实的 x402 支付通道。筛查工具会报价：

recipient : 0x15184bf50b3d3f52b60434f8942b7d52f2eb436e
chain     : Base L2
asset     : USDC
amount    : $0.10 USDC per screen call

没有模拟，也没有仿真，更不会将测试网伪装成主网。筛查后端处于 backend_pending 状态期间，不会收取费用——x402 报价仅供参考，以便调用方 Agent 预先检查支付配置。

---

Hive 教义背景

此服务是 Hive Civilization 三道门教义（NEED + YIELD + CLEAN-MONEY）中的 CLEAN-MONEY 门禁基础组件。任何涉及结算的其他 Hive 界面都应在放行前调用 agent_kyc_screen_address 和公开名单工具。

它有意设计为轻量代理：补充信息、评分和最终决策分别由第三方服务提供商和运营方负责。Hive 不会因路由而成为受监管的 MSB。

---

许可证

MIT — 参见 LICENSE。

---

#C08D23 · Hive Civilization · 2026

Hive Civilization 目录

属于 Hive Civilization — 面向 Agent 的金融基础设施。

• 端点目录：https://thehiveryiq.com
• 实时排行榜：https://hive-a2amev.onrender.com/leaderboard
• 收益仪表板：https://hivemine-dashboard.onrender.com
• 其他 MCP 服务：https://github.com/srotzin?tab=repositories&q=hive-mcp

品牌：#C08D23