2026-06-20 · agentmail

How to Screen a Crypto Wallet Before Your AI Agent Pays

Step-by-step guide: screen any EVM, Bitcoin, Solana, or Tron wallet against the OFAC sanctions list before your agent signs a transaction.

When your AI agent is about to send USDC, ETH, or any crypto to a counterparty wallet, the single most important check is whether that wallet is on the OFAC sanctions list. Here is how to do it.

Step 1: Choose your integration mode

agentmail supports three integration modes: HTTP API (curl/HTTPS), MCP tool (for agent frameworks that support MCP), and CLI (pip install sanctions-mcp). All three check the same data. The HTTP API is simplest for a single call.

Step 2: Call the sanctions endpoint before your send function

Wire the check into your agents payment pipeline. The pattern is always: screen first, pay only if clean.

# Before your agent signs:
import requests
result = requests.get(
    "https://sanctionsai.dev/sanctions",
    params={"wallet": "0x..."}
).json()
if not result.get("clean", True):
    raise Exception("Wallet is OFAC-sanctioned")
# Safe to proceed

Step 3: Handle the response

The API returns a clean boolean and a matches array if flagged. If clean is true, proceed. If clean is false, halt the transaction and log the match details. The matches array contains the SDN name, list, and match type for your audit trail.

Step 4: Log everything

OFAC expects to see documented screening. Save the timestamp, wallet address, API response, and which agent initiated the check. agentmail handles this automatically on the paid tier with the dashboard audit log.

Step 5: Add the check to your agent loop

Do not screen once and cache. The SDN list changes daily. A wallet clean today may be sanctioned tomorrow. Screen before every payment.

Free tier: 5 checks/day, no API key. Try the interactive wallet checker to see how it works.