# aml

An MCP server that checks addresses and payments before they execute. Agents get a verdict (clear, caution, risky), a risk score, and proof — no black-box scoring.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: OceanAlt666
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/OceanAlt666/oceanalt-aml-mcp
- Updated: 2026-10-20
- HTML: https://affpapa.org/en/nevibecode/mcp/aml

## What it does

aml connects to OceanAlt and gives your agent tools to verify payments before money moves. Call `screen_address` before any transfer — it returns `clear`, `caution`, or `risky` with a 0–100 risk score and clickable evidence. The server includes deep address screening, transaction-intent decoding (so your agent doesn't sign an approval disguised as a payment), payment-request verification, and USDT taint tracing on Tron up to three hops deep.

Most tools are free and need no API key. Paid functions (`compliance_decision` at $0.002 per call and `batch_screen` at $0.01) use x402 — sign one USDC authorization and pay on top of it. They require `@x402/core`, `@x402/evm`, and `viem` in your MCP environment, and you pass a low-balance wallet's private key as `OCEANALT_PAYER_KEY`. The service signs locally, never sees your key, and never holds your funds.

The server runs on eight EVM chains (Ethereum, Base, BSC, Polygon, Arbitrum, Optimism, Avalanche), Tron, and Solana. Responses default to English but support Chinese via `lang: "zh"`. Branch on language-independent signal keys (`list.mixer`, `taint.onehop`), not prose — keys stay constant across language changes.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://oceanalt.com/api/mcp`

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http aml https://oceanalt.com/api/mcp
```

2. **Platform CLI**
```bash
claude mcp add aml -- npx -y oceanalt-aml-mcp
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add aml --url https://oceanalt.com/api/mcp
```

2. **Platform CLI**
```bash
codex mcp add aml -- npx -y oceanalt-aml-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "aml": {
            "url": "https://oceanalt.com/api/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "aml": {
            "command": "npx",
            "args": [
                "-y",
                "oceanalt-aml-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "aml": {
            "type": "http",
            "url": "https://oceanalt.com/api/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "aml": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "oceanalt-aml-mcp"
            ]
        }
    }
}
```

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http aml https://oceanalt.com/api/mcp
```

2. **Platform CLI**
```bash
gemini mcp add aml npx -y oceanalt-aml-mcp
```

## When to use it
- Screen a recipient address against sanctions and prior incidents before payment
- Confirm the agent is signing a real payment, not a hidden token approval
- Detect a spoofed or phishing payment request before the agent sends money
- Gather all screening evidence into one signed receipt
- Verify multiple addresses in a single batch call

## Example prompts
- Before payment, screen this address: check 0xABC123… and give me the verdict with proof
- Decode this transaction on Solana — make sure it's a real payment, not a SetAuthority call
- Verify this payment request — I got a 402 response from the seller's page and need to confirm it's not tampered with

## Similar
- [sumsub-create-aml-resolution-rules](https://affpapa.org/en/nevibecode/skills/sumsub-create-aml-resolution-rules.md) — skill · 467 installs
- [kyc-rules](https://affpapa.org/en/nevibecode/skills/kyc-rules.md) — skill · 1200 installs
- [sumsub-create-transaction](https://affpapa.org/en/nevibecode/skills/sumsub-create-transaction.md) — skill · 1200 installs
- [anti-money-laundering](https://affpapa.org/en/nevibecode/skills/anti-money-laundering.md) — skill · 685 installs
- [know-your-customer](https://affpapa.org/en/nevibecode/skills/know-your-customer.md) — skill · 679 installs
- [create-payment-credential](https://affpapa.org/en/nevibecode/skills/create-payment-credential.md) — skill · 20900 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md