agentmail 是一个面向 AI 智能体的合规与验证工具包，旨在填补智能体自主支付场景下的制裁筛查、KYA（Know-Your-Agent）和交易欺诈信号空白。随着智能体开始通过 x402、AP2、ACP、Coinbase AgentKit 等协议自主付款，现有支付基础设施通常默认有人类监督，且大型支付平台明确不处理逐司法管辖区的制裁筛查。agentmail 为智能体提供三项其自身无法完成的能力，并通过三种界面暴露：MCP 工具（适用于 Claude Code / Cursor / Hermes）、HTTP API（适用于任何智能体）和 CLI（适用于开发者），三者共享同一核心与数据。
主要能力：
- 合规层：提供四个智能体在信任或付款前调用的工具——制裁筛查、风险评分、KYA 验证、争议开启。数据涵盖 782 个 OFAC 加密钱包、19,086 个受制裁姓名、16 个受禁运司法管辖区。数据来源公开免费、无需密钥，列表本地缓存于 ~/.agentmail/cache/，TTL 24 小时，从源刷新；若网络中断则使用过期缓存，并通过 status() 报告 degraded: true，避免静默失败。osint 提供商执行精确及令牌子集名称匹配、精确大小写不敏感钱包匹配和 ISO-2 国家匹配，每个匹配项带有置信度，供使用者决定阻止力度。
- 验证工具箱：邮箱方面，提供一次性收件箱，智能体可用于注册并接收 OTP/魔法链接验证（由 Mail.tm 支持），流程为 create_inbox() → 地址 → fetch_code() → OTP；短信方面，提供可租用手机号用于电话/短信验证，Mock 提供商无需密钥即可用于开发，设置 AGENTMAIL_SMS_PROVIDER=fivesim 和 AGENTMAIL_FIVESIM_KEY=... 可接入真实号码。两者共享 otp.py 提取逻辑（正则匹配验证码和魔法链接），输出统一的 {code, link} 结构。
使用方式： 用户可通过三种途径使用。MCP 客户端方式（以 Claude Code / Cursor 为例）：配置后智能体可调用 sanctions_check、risk_score、kya_verify、dispute_open、create_inbox、fetch_code、create_number、fetch_sms、release_number、list_inboxes 共 10 个工具。注意 PyPI 包名为 sanctions-mcp（agentmail 名称已被占用），但 Python 导入名仍为 agentmail。HTTP API 方式：任何智能体均可调用。CLI 方式：供开发者直接使用。自托管完全免费且功能完整，可在本地运行 MCP 服务器或在自己的机器上运行 HTTP API，对真实 OFAC 数据进行筛查。托管 API 位于 https://agentmail-api.fly.dev，提供 API 密钥认证、速率限制和每次筛查的审计日志；免费层为每天 50 次检查，无需注册（按 IP），更高用量可获取 API 密钥（Dev 每月 19 美元，Team 每月 99 美元，自助结账）。
适用场景： 适用于智能体在自主支付、交易或与陌生对手方交互前需要进行制裁筛查、风险评估和身份验证的场景，也适用于需要一次性邮箱或临时手机号完成注册和验证的开发与测试流程。项目还提出了 agentmail 制裁暴露指数（SEI），一个包含 5 个因子的专有框架，用于量化 AI 智能体的 OFAC 制裁暴露（评分从 10 到 1000），完整报告与交互式计算器位于 sanctionsai.dev，采用 CC BY 4.0 许可。
限制与注意事项： 自托管是免费层级而非陷阱，付费购买的是正常运行时间、数据新鲜度和审计日志，数据本身保持公开。5sim 号码在释放后可能被共享，适合接收一次性 OTP，但绝不适合用于打算长期保留账户的双重认证。项目采用 MIT 许可证。其他未提及的功能、收费细节或平台支持情况，资料中暂未提供。
