oceanalt-aml-mcp

Native AML-Compliance für KI-Agenten. Ein MCP-Server, mit dem Claude / Cursor / jeder MCP-Client das On-Chain-Adress-Screening und Compliance-Gateway von OceanAlt aufrufen kann. Belege statt Black-Box-Score — jede Einstufung wird mit überprüfbaren Belegen geliefert, die du durchklicken kannst.

Entwickelt für agentische Zahlungen: frage „Ist dieser Zahlungsempfänger sicher?" bevor Geld bewegt wird, über 7 EVM-Chains + Tron + Solana.

Für KI-Agenten: Rufe screen_address vor jeder Überweisung auf — es gibt eine clear- / caution- / risky-Einstufung sowie einen Risiko-Score von 0–100 und klickbare Belege zurück, sodass du ein Zahlungsmandat mit einem Beleg statt einer Vermutung durchsetzen kannst. Kostenlos, ohne Schlüssel.

Tools

network (für 0x-Adressen): ethereum · base · bsc · polygon · arbitrum · optimism · avalanche (bei Auslassung automatisch erkannt). Tron & Solana werden automatisch erkannt.

Related MCP server: gocreative-mcp

Schnellstart (kostenlose Tools)

Füge das zu deiner MCP-Client-Konfiguration hinzu (Claude Desktop, Claude Code, Cursor, …):

{
  "mcpServers": {
    "oceanalt-aml": { "command": "npx", "args": ["-y", "oceanalt-aml-mcp"] }
  }
}

Die kostenlosen Tools benötigen keinen API-Schlüssel und keine Registrierung.

Aktivieren der kostenpflichtigen (x402) Tools

Die kostenpflichtigen Tools zahlen pro Aufruf über x402 — HTTP 402 → eine USDC-Autorisierung signieren → 200. Füge einen Payer-Wallet-Schlüssel zu env hinzu und installiere die x402-Peer-Abhängigkeiten:

{
  "mcpServers": {
    "oceanalt-aml": {
      "command": "npx", "args": ["-y", "oceanalt-aml-mcp"],
      "env": { "OCEANALT_PAYER_KEY": "0x<your payer wallet private key>" }
    }
  }
}

npm i @x402/core @x402/evm viem   # in the MCP's environment

⚠️ Echtes Geld — Base-Mainnet. Die kostenpflichtigen Endpunkte werden in echtem USDC im Base-Mainnet abgerechnet (eip155:8453); die $-Preise oben werden in echtem USDC berechnet. Prüfe vor der Zahlung immer das aktuelle Netzwerk-/Preismanifest unter https://oceanalt.com/api/x402 und verwende eine dedizierte Payer-Wallet mit geringem Guthaben.

🔐 Wallet-Sicherheit. OCEANALT_PAYER_KEY wird nur in deinem lokalen Prozess verwendet, um eine einzige EIP-3009-Autorisierung zu signieren. Er wird niemals in dieses Paket gebündelt, niemals hochgeladen, niemals protokolliert. Der Facilitator übernimmt die Gas-Gebühren und verwahrt deine Gelder niemals. Verwende eine dedizierte Payer-Wallet mit geringem Guthaben, nicht dein Hauptguthaben.

Umgebungsvariablen

Was es ist (und was nicht)

Dieses Paket ist ein schlanker (~9KB) Client, der OceanAlts öffentliche API aufruft. Es enthält keine proprietäre Logik und keine Daten — die AML-Engine, das Scoring und die Address-Intelligence laufen vollständig serverseitig auf oceanalt.com. Jede Abfrage reichert weiterhin OceanAlts eigene Address-Intelligence-Datenbank an (sie wächst mit der Nutzung).

• Programmatisches SDK (gleiche Funktionen, für Node / Browser / Deno / Bun): oceanalt-aml

• API-Dokumentation & Beispiele: https://oceanalt.com/en/api-docs

• RAP — der Compliance-Standard hinter den Einstufungen: https://oceanalt.com/en/rap

MIT © OceanAlt

中文

让 Claude / Cursor / 任意 MCP 客户端原生调用 OceanAlt 的链上地址合规筛查 + 合规网关。给收据,不给黑箱分:每条判决都带可点开核验的证据。覆盖 7 条 EVM 链 + 波场 TRON + Solana,付款前先问一句「这个收款方安不安全」。

• 免费两工具:screen_address(单查 + 证据)、recent_flagged(近期被标记)。无需 key、无需注册。

• 付费三工具(x402):compliance_decision(网关判决)、deep_trace(波场深度追踪)、batch_screen(批量)。按需加载 @x402+viem,设置 OCEANALT_PAYER_KEY 才启用。

• ⚠️ 真钱:付费端点当前在 Base 主网结算,USDC 为真实资金(eip155:8453),上表 $ 价按真实 USDC 收取。付款前务必以实时清单 https://oceanalt.com/api/x402 为准,并使用 小额专用付款钱包。

• 🔐 钱包安全:OCEANALT_PAYER_KEY 只在本地签一次 EIP-3009 授权,绝不随包发布/上传/打日志;facilitator 代付 gas、不托管资金。建议用小额专用钱包,别用主资金钱包私钥。

• 编程 SDK:oceanalt-aml;在线文档:https://oceanalt.com/en/api-docs;合规标准:https://oceanalt.com/en/rap。