Agentmail

SanctionsAI — 面向 AI Agent 的制裁合规与验证工具包

你的 Agent 即将向陌生人发送 USDC。这个陌生人受到制裁了吗？ 782 个 OFAC 加密货币钱包 · 19,086 个受制裁名称 · 16 个禁运司法管辖区。 无需 API 密钥。无需注册。30 秒即可完成设置。免费且开源。

SanctionsAI 为任何 AI Agent 提供三种自身无法实现的能力：

层	内容	状态
🛡️ 合规	OFAC 制裁筛查、KYA、交易风险评分、争议处理	✅ 已上线 — 使用真实 OFAC 数据
📧 电子邮件	一次性验证收件箱（接收 OTP/魔法链接）	✅ 已上线
📱 短信	可租用电话号码（接收短信/OTP）	✅ 已上线（模拟服务免费，5sim/Twilio 付费）

它通过 三种方式 提供所有这些功能：MCP 工具（供 Claude Code / Cursor / Hermes 使用）、HTTP API（供任何 Agent 使用）以及 CLI（供你使用）。核心功能和数据均相同。

---

为什么要做这个项目

Agent 已开始为服务付费（x402、AP2、ACP、Coinbase AgentKit）。但每种支付渠道都假定有人类在监看。如果你的 Agent 自主向列入 OFAC 特别指定国民名单的钱包付款，法律责任将由你承担——而大型支付基础设施厂商（OpenAI、Stripe、Coinbase）明确表示，他们不处理按司法管辖区进行的制裁筛查、了解你的 Agent（Know-Your-Agent）或 Agent 交易欺诈信号。这正是本项目要填补的空白。

agent ──about to pay──▶  sanctions_check(wallet)  ──▶ clean? proceed. sanctioned? ABORT.

---

快速开始（30 秒）

pip install sanctions-mcp

选项 A — 在 MCP 客户端中使用（Claude Code / Cursor）

// .mcp.json or your client's MCP config
{
  "mcpServers": {
    "SanctionsAI": {
      "command": "python",
      "args": ["-m", "agentmail.mcp_server"]
    }
  }
}

现在，你的 Agent 可以调用 sanctions_check、risk_score、kya_verify、dispute_open、create_inbox、fetch_code、create_number、fetch_sms、release_number、list_inboxes。

注意： PyPI 包名为 sanctions-mcp（SanctionsAI 这个名称已被占用）。Python 导入名称仍为 SanctionsAI。

选项 B — 将其用作 HTTP API

python -m agentmail.api   # serves on :8000

# Screen a wallet against real OFAC data — no key, no auth needed for self-host
curl "http://localhost:8000/sanctions?wallet=0x098B716B8Aaf21512996dC57EB0615e2383E2f96"
# → {"matches":[{"list":"OFAC_SDN","match_type":"wallet_exact","confidence":1.0}],
#    "clean":false,"provider":"osint"}

curl "http://localhost:8000/risk" -d '{"counterparty_id":"0xabc...","amount":"5000","rail":"x402"}'
# → {"score":0,"recommendation":"decline","reasons":["sanctions_match:OFAC_SDN/..."]}

选项 C — 从 CLI 使用

# Sanctions screen — real OFAC data, no key
python -m agentmail.cli sanctions --wallet 0x098B716B8Aaf21512996dC57EB0615e2383E2f96
# → flagged: OFAC_SDN wallet_exact

python -m agentmail.cli risk 0xabc123def456 5000 --rail x402
python -m agentmail.cli kya my-agent --wallet 0xabc... --wallet-age 400 --domain bot.dev
python -m agentmail.cli compliance-status
# → OFAC SDN: 782 wallets, 19086 names; source=vile/ofac-sdn-list@...

---

合规层（关键所在）

Agent 信任或向交易对手付款前，应调用以下四种工具：

工具	调用时机	返回内容
sanctions_check(name, wallet, country)	最简单的检查。首先调用。	{matches, clean}
risk_score(counterparty, amount, ...)	授权付款前立即调用	{score 0-100, recommendation: allow/review/decline}
kya_verify(agent_id, evidence)	信任另一个 Agent 前	{trust_score, verified, flags}
dispute_open(transaction_id, reason)	付费交易出现问题时	{dispute_id, escalation_at}

数据来源（均为公开、免费，无需密钥）

来源	内容	刷新频率
vile/ofac-sdn-list（GitHub releases）	782 个多链加密货币地址（ETH/USDT/TRX/XBT/...）	每日
美国财政部 OFAC sdn.csv	19,086 名受制裁个人和实体	按发布情况
禁运司法管辖区集合	16 个受 OFAC/UN/EU 全面制裁的 ISO-2 代码	手动跟踪

列表缓存在本地（~/.agentmail/cache/，TTL 为 24 小时），并会从来源更新。若网络中断，则使用过期缓存；status() 会报告 degraded: true，让你知道筛查依据的是较旧数据，而不是悄无声息地失败。

提供方（可切换的后端）

AGENTMAIL_COMPLIANCE_PROVIDER=osint   ← default, real OFAC data, free
AGENTMAIL_COMPLIANCE_PROVIDER=mock    ← rule-based, for offline tests
AGENTMAIL_COMPLIANCE_PROVIDER=paid    ← ComplyAdvantage passthrough (roadmap)

osint 提供方支持精确匹配和名称词元子集匹配、不区分大小写的钱包精确匹配，以及 ISO-2 国家代码匹配。每个匹配项都带有 confidence，便于你决定拦截力度。

---

另外两个层（验证工具包）

电子邮件 — Agent 可用于注册并接收 OTP／魔法链接验证的一次性收件箱（由 Mail.tm 提供支持）。create_inbox() → 地址 → fetch_code() → OTP。

SMS — Agent 可用于电话／SMS 验证的租用电话号码。模拟提供方无需密钥即可使用（适用于开发）；设置 AGENTMAIL_SMS_PROVIDER=fivesim AGENTMAIL_FIVESIM_KEY=... 即可启用真实号码。

两者共用 otp.py 提取模块（用正则表达式提取验证码和魔法链接），因此电子邮件和 SMS 会生成相同的 {code, link} 格式。

---

自托管与托管服务

自托管功能完整且免费——这就是本仓库的用途。在本地运行 MCP 服务，或在自己的设备上运行 HTTP API；使用真实 OFAC 数据进行筛查，一分钱也不用花。

托管 API 已在 https://agentmail-api.fly.dev 上线——这是一个托管端点，提供 API 密钥身份验证、速率限制，以及每次筛查的审计日志（监管机构／投资者会要求提供的内容）。免费层级：每天 50 次检查，无需注册（按 IP 计算）。如需更高用量，获取 API 密钥 →（Dev 每月 $19，Team 每月 $99——自助结账）。

# Try the hosted API right now — no key needed:
curl "https://agentmail-api.fly.dev/sanctions?wallet=0x098B716B8Aaf21512996dC57EB0615e2383E2f96"
# → {"matches":[{"list":"OFAC_SDN",...}],"clean":false}

# With an API key:
curl -H "X-API-Key: sk_live_..." "https://agentmail-api.fly.dev/risk" \
  -d '{"counterparty_id":"0xabc...","amount":"5000","rail":"x402"}'

---

路线图

• 电子邮件收件箱（Mail.tm）+ SMS/OTP（mock/5sim/twilio）+ OTP 提取
• 合规层——真实 OFAC 数据（osint 提供方）：782 个钱包 + 19,086 个名称
• MCP 服务（10 个工具）+ HTTP API + CLI
• SanctionsAI 制裁暴露指数（SEI）——用于评估 AI Agent OFAC 暴露程度的专有五因素框架（2026 年报告：sanctionsai.dev/research）
• 提供 API 密钥身份验证和速率限制的托管 API（Fly.io）
• 审计日志（防篡改的筛查历史记录——面向企业的切入点）
• 欧盟 + 联合国合并名单（osint 提供方，第二阶段）
• 付费提供方：ComplyAdvantage 直通服务（企业版）
• x402 按调用计费（当 Agent 开始自行付费时）

SEI：SanctionsAI 制裁暴露指数

SanctionsAI 制裁暴露指数（SEI） 是一个专有的五因素框架，用于量化 AI Agent 面临的 OFAC 制裁暴露程度：

因素	权重	衡量内容
V — 交易速度	30%	Agent 可在无人值守时执行的每日交易数
J — 司法管辖区重叠度	25%	处于或邻近受禁运地区的交易对手所占比例
A — 资产类别	20%	加密货币（SDN 覆盖率最高）、法币、混合
S — 筛查措施	15%	不筛查 → 批量筛查 → 付款前实时筛查 → 实时筛查 + 审计
D — 披露准备度	10%	运营方能否在 5 天内提交 VSD？

评分范围为 10（暴露程度最低）至 1000（最高）。S 和 D 是目前可以改变的两个因素——只需调用一次实时筛查工具并生成带时间戳的审计记录，即可将两项评分从 1 提高到 10。完整报告和交互式计算器见 sanctionsai.dev。

引用格式：“SanctionsAI Sanctions Exposure Index (SEI), 2026 Agent-Payment Sanctions Exposure Report, sanctionsai.dev”——采用 CC BY 4.0 许可。

设计说明（坦诚说明）

• 真正的护城河在于合规层。 电子邮件／SMS 只是平台可以集成的基础设施。将制裁筛查与 Agent 交易历史关联起来，可以构建其他人都没有的数据集；而大型基础设施服务商则明确回避按司法管辖区制定规则。
• 自托管是免费层级，不是陷阱。 你最终付费购买的价值不在于数据，而在于正常运行时间、数据新鲜度和审计记录。数据现在是公开的，未来也会一直公开。
• 5sim 号码在释放后会被多人共享。 用来接收 OTP 没问题，但绝不能用于你打算长期保留的账户的双重身份验证。

许可证

MIT——参见 LICENSE。

贡献

欢迎提交问题和 PR。如果你在生产环境中使用 SanctionsAI，我很想了解具体用途。