Agentmail

SanctionsAI — AI エージェント向けコンプライアンス・検証ツールキット

あなたのエージェントが見知らぬ相手に USDC を送ろうとしています。その相手は制裁対象者でしょうか？ OFAC の暗号資産ウォレット 782 件・制裁対象者名 19,086 件・禁輸対象地域 16 件。 API キー不要。登録不要。30 秒でセットアップ。無料でオープンソースです。

SanctionsAI は、AI エージェントに、それ自体では提供できない 3 つの機能をもたらします。

レイヤー	内容	ステータス
🛡️ コンプライアンス	OFAC 制裁対象者スクリーニング、KYA、取引リスクスコア、異議申し立て	✅ 稼働中 — 実際の OFAC データを使用
📧 メール	使い捨て認証用受信トレイ（OTP／マジックリンクを受信）	✅ 稼働中
📱 SMS	レンタル可能な電話番号（SMS／OTP を受信）	✅ 稼働中（モックは無料、5sim／Twilio は有料）

これらすべてを3 つのインターフェースで利用できます — MCP ツール（Claude Code／Cursor／Hermes 向け）、HTTP API（あらゆるエージェント向け）、CLI（あなた向け）です。基盤もデータも共通です。

---

開発の背景

エージェントは、さまざまなものに対して支払いを始めています（x402、AP2、ACP、Coinbase AgentKit）。しかし、どの決済手段も、人間が見守っていることを前提としています。エージェントが OFAC 特別指定国民リストに載っているウォレットへ自律的に支払った場合、法的責任はあなたにあります — しかも、大手決済インフラ企業（OpenAI、Stripe、Coinbase）は、管轄区域ごとの制裁対象者スクリーニング、Know-Your-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"]
    }
  }
}

これでエージェントは 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@...

---

コンプライアンスレイヤー（重要な部分）

エージェントが取引相手を信頼したり、支払いを行ったりする前に呼び出す 4 つのツールです。

ツール	呼び出すタイミング	返り値
sanctions_check(name, wallet, country)	最も手軽なチェックです。最初に呼び出します。	{matches, clean}
risk_score(counterparty, amount, ...)	支払いを承認する直前	{score 0-100, recommendation: allow/review/decline}
kya_verify(agent_id, evidence)	別のエージェントを信頼する前	{trust_score, verified, flags}
dispute_open(transaction_id, reason)	支払い済みの取引に問題が生じたとき	{dispute_id, escalation_at}

データの取得元（すべて公開・無料・キー不要）

ソース	内容	更新頻度
vile/ofac-sdn-list（GitHub リリース）	マルチチェーン対応の暗号資産アドレス 782 件（ETH／USDT／TRX／XBT／...）	毎日
米財務省 OFAC sdn.csv	制裁対象の個人・団体 19,086 件	公開に応じて
禁輸対象地域セット	包括的な OFAC／国連／EU 制裁対象となる ISO-2 コード 16 件	手動で追跡

リストはローカルにキャッシュされ（~/.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 が付与され、どの程度厳格にブロックするかを判断できます。

---

もう2つのレイヤー（検証ツールキット）

メール — エージェントが登録してOTP／マジックリンク認証を受け取るために使える使い捨て受信箱です（Mail.tm を利用）。create_inbox() → アドレス → fetch_code() → OTP。

SMS — エージェントが電話／SMS認証に使えるレンタル電話番号です。モックプロバイダーはキーなしで動作します（開発用）。AGENTMAIL_SMS_PROVIDER=fivesim AGENTMAIL_FIVESIM_KEY=... を設定すると、実際の番号を使って稼働します。

どちらも共通の otp.py 抽出ロジック（コードとマジックリンクの正規表現）を使うため、メールとSMSの出力は同じ {code, link} 形式になります。

---

セルフホストとホステッド

セルフホストは完全に機能し、無料です — このリポジトリがその実例です。MCP サーバーをローカルで、またはHTTP APIをご自身のマシンで実行し、実際のOFACデータを使って照合できます。費用は一切かかりません。

ホステッドAPIは https://agentmail-api.fly.dev で稼働中です — APIキー認証、レート制限、すべての照合の監査ログ（規制当局や投資家から求められるもの）を備えたマネージドエンドポイントです。無料枠：1日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 provider）：ウォレット782件＋名前19,086件
• MCP サーバー（ツール10個）＋HTTP API＋CLI
• SanctionsAI Sanctions Exposure Index（SEI） — AIエージェントのOFAC制裁リスクを評価する独自の5要素フレームワーク（2026年レポート：sanctionsai.dev/research）
• APIキー認証＋レート制限を備えたホステッドAPI（Fly.io）
• 監査ログ（改ざんを検知できる照合履歴 — エンタープライズ向けの強み）
• EU＋UN統合リスト（osint provider、フェーズ2）
• 有料プロバイダー：ComplyAdvantage passthrough（エンタープライズ）
• x402による呼び出し単位の課金（エージェント自身が支払うようになった場合）

SEI：SanctionsAI Sanctions Exposure Index

SanctionsAI Sanctions Exposure Index（SEI）は、AIエージェントのOFAC制裁リスクを定量化する、独自の5要素フレームワークです。

要素	重み	測定内容
V — Velocity（取引速度）	30%	エージェントが人手を介さずに実行できる1日あたりの取引数
J — Jurisdiction overlap（管轄区域の重複）	25%	禁輸地域内またはその近辺にいる取引相手の割合
A — Asset class（資産クラス）	20%	暗号資産（SDN対象範囲が最も広い）、法定通貨、混在
S — Screening posture（スクリーニング態勢）	15%	照合なし → 一括照合 → 支払い前のインライン照合 → インライン照合＋監査
D — Disclosure readiness（情報開示の準備状況）	10%	運営者は5日以内にVSDを提出できますか？

スコアは10（リスク最小）から1000（リスク最大）までです。SとDは、今すぐ変更できる2つの要素です — インライン照合を1回実行し、タイムスタンプ付き監査証跡を残すだけで、両方を1から10に引き上げられます。完全版レポートとインタラクティブな計算ツールは sanctionsai.dev をご覧ください。

引用表記： "SanctionsAI Sanctions Exposure Index (SEI), 2026 Agent-Payment Sanctions Exposure Report, sanctionsai.dev" — CC BY 4.0 ライセンス。

設計に関する率直なメモ

• 本当の競争優位性があるのはコンプライアンスレイヤーです。 メール／SMSは、プラットフォームに容易に取り込まれ得る基盤機能です。エージェントの取引履歴に結び付いた制裁スクリーニングによって、他社にはないデータセットが構築されます。また、管轄区域ごとのルールは、大手インフラ企業が明確に避けている領域です。
• セルフホストは無料枠であり、罠ではありません。 （将来的に）料金を支払う価値があるのはデータではなく、稼働時間、最新性、監査証跡です。データは公開されており、今後も公開され続けます。
• 5simの番号は、解放後に他の人と共有されます。 OTPの受信には問題ありませんが、使い続ける予定のアカウントで2FAに使うのは絶対に避けてください。

ライセンス

MIT — LICENSEをご覧ください。

コントリビューション

IssueやPRを歓迎します。本番環境でSanctionsAIをお使いの場合は、どのように活用されているか、ぜひお聞かせください。