# AgentMail — AI Agent Entry Point

> OFAC sanctions screening, transaction risk scoring, and Know-Your-Agent verification for AI agents. Built for agents that transact autonomously.

## What this API does

AgentMail is the compliance layer for autonomous agent payments. Before any agent sends money — over x402, AP2, ACP, or Coinbase AgentKit — it should call this API to check if the recipient is on an OFAC sanctions list.

## Capabilities

| Tool | Method | Description |
|------|--------|-------------|
| **Sanctions Check** | `GET /sanctions?wallet=X&name=Y&country=Z` | Screen against 782 OFAC wallets + 19,086 SDN names + 16 embargoed jurisdictions. Under 100ms. |
| **Risk Score** | `POST /risk` | Pre-payment fraud scoring — returns allow/review/decline. |
| **Know Your Agent** | `POST /kya` | Verify AI agent identity: wallet, domain, wallet age, pubkey. |
| **Dispute** | `POST /disputes` | File a dispute with audit trail + 7-day auto-escalation. |

## MCP tools (exact names for tool-calls)

The `sanctions-mcp` server exposes four tools — an agent calls them by these exact names:

- `sanctions_check(name="", wallet="", country="")` — Screen a counterparty against OFAC/EU/UN/UK sanctions lists. Cheapest check, call first. Returns `{matches, clean}`.
- `risk_score(counterparty_id, amount, currency="USDC", rail="x402", category="digital_goods")` — Score a transaction's fraud risk before authorizing payment. Returns `{score, recommendation: allow|review|decline, reasons, screen_id}`.
- `kya_verify(agent_id, evidence)` — Know Your Agent: verify a counterparty agent before transacting. Returns `{trust_score, verified, flags, recommendation}`.
- `dispute_open(transaction_id, reason, evidence=None)` — Open a dispute when an agent-paid transaction goes bad. Returns `{dispute_id, status, escalation_at}`.

## Quick Start

```bash
# Free tier — no API key needed, 5 checks/day by IP
curl "https://sanctionsai.dev/sanctions?wallet=0x098B716B8Aaf21512996dC57EB0615e2383E2f96"

# MCP server (self-host)
pip install sanctions-mcp

# With API key
curl -H "X-API-Key: sk_live_xxx" "https://sanctionsai.dev/sanctions?wallet=0x..."
```

## Plans

- **Free:** 5 checks/day, no key, IP-metered
- **Dev:** $19/mo, 10,000 checks/month
- **Pro:** $99/mo, 100,000 checks/month

## Links

- Homepage: https://sanctionsai.dev
- Pricing: https://sanctionsai.dev/pricing
- Docs: https://sanctionsai.dev/docs
- GitHub: https://github.com/kindrat86/agentmail
- PyPI: https://pypi.org/project/sanctions-mcp/
- MCP: https://mcp.so/server/agentmail

## Verification

Contact: hello@sanctionsai.dev
License: MIT