oceanalt-aml-mcp

Нативная AML-комплаенс для ИИ-агентов. Сервер MCP, который позволяет Claude / Cursor / любому MCP-клиенту вызывать OceanAlt — шлюз проверки адресов и комплаенса в блокчейне. Чеки, а не оценка из чёрного ящика — каждый вердикт сопровождается проверяемыми доказательствами, по которым можно кликнуть.

Создан для агентных платежей: спросите «безопасен ли этот получатель?» до того, как деньги переместятся, на 7 EVM-цепочках + Tron + Solana.

Для ИИ-агентов: вызывайте screen_address перед любым переводом — он возвращает вердикт clear / caution / risky плюс оценку риска 0–100 и кликабельные доказательства, так что вы можете обеспечить соблюдение платёжного мандата с чеком, а не по догадке. Бесплатно, без ключа.

Инструменты

network (для адресов 0x): ethereum · base · bsc · polygon · arbitrum · optimism · avalanche (определяется автоматически, если не указано). Tron и Solana определяются автоматически.

Related MCP server: gocreative-mcp

Быстрый старт (бесплатные инструменты)

Добавьте в конфиг вашего MCP-клиента (Claude Desktop, Claude Code, Cursor, …):

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

Бесплатным инструментам не нужен API-ключ и регистрация.

Включение платных (x402) инструментов

Платные инструменты оплачиваются за вызов через x402 — HTTP 402 → подписать одну авторизацию USDC → 200. Добавьте ключ кошелька плательщика в env и установите зависимости x402:

{
  "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

⚠️ Реальные деньги — Base mainnet. Платные эндпоинты расчитываются реальным USDC на Base mainnet (eip155:8453); цены $ выше взимаются в реальном USDC. Всегда проверяйте актуальный манифест сети/цен на https://oceanalt.com/api/x402 перед оплатой и используйте выделенный кошелёк плательщика с низким балансом.

🔐 Безопасность кошелька. OCEANALT_PAYER_KEY используется только в вашем локальном процессе для подписи одной авторизации EIP-3009. Он никогда не включается в этот пакет, никогда не загружается, никогда не логируется. Фасилитатор оплачивает газ и никогда не хранит ваши средства. Используйте выделенный кошелёк плательщика с низким балансом, а не основной.

Переменные окружения

Что это (и чем не является)

Этот пакет — тонкий (~9КБ) клиент, который вызывает публичный API OceanAlt. Он не содержит проприетарной логики и данных — AML-движок, скоринг и адресная интеллектуальность работают на стороне сервера на oceanalt.com. Каждый запрос по-прежнему обогащает собственную базу адресной интеллектуальности OceanAlt (она растёт с использованием).

• Программный SDK (те же возможности, для Node / браузера / Deno / Bun): oceanalt-aml

• Документация API и примеры: https://oceanalt.com/en/api-docs

• RAP — стандарт комплаенса, лежащий в основе вердиктов: 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。