oceanalt-aml-mcp

oceanalt-aml-mcp

为 AI Agent 提供原生 AML 合规能力。 一个 MCP 服务，可让 Claude / Cursor / 任意 MCP 客户端调用 OceanAlt 的链上地址筛查和合规网关。提供收据，而非黑盒评分——每个判定都附带可点击查看的可验证证据。

专为代理式支付打造：在资金转移之前，跨 8 条 EVM 链、Tron 和 Solana，询问“这笔支付应该继续吗？”

致 AI Agent： 在进行任何转账前调用 screen_address——它会返回 clear / caution / risky 判定，以及 0–100 的风险评分和可点击查看的证据，让你可以凭收据而非猜测来执行支付授权。clear 判定仅表示 OceanAlt 持有的数据中未发现相关信息——并不意味着该地址安全，而且各链的筛查深度有所不同。免费，无需密钥。

工具

工具	输入	功能	价格
payment_decision	to, amountUsdc?, purpose?, network?	Agent 付款前，请调用一次 → 允许 / 审核 / 拒绝 + 证据 + 重试 + 可验证的结算证明	免费
screen_address	address（0x… / T… / Solana），network?	AML 判定 + 风险评分 + 可验证证据	免费
counterparty_control_baseline	entity? / agentId?	回答另一个问题：不是“这个地址是否有风险”，而是“如果另一方的 Agent 被诱导做出某些操作，可能造成多大损失”。返回对方的控制基线证明，并区分 OceanAlt 强制执行的内容与其仅声称的内容	免费
resolve_agent_identity	agentId	问责链：Agent → 主体 → 授权 → 凭证 → 钱包。链条中断之处，就是问责终止之处	免费
recent_flagged	—	最近被标记的高风险地址	免费
check_calldata_intent	intent，EVM：contract、data · Solana：network:"solana"、transaction（base64）	防止盲签：解码交易的实际操作（伪装成付款的 ERC-20 approve；SPL Approve / SetAuthority / CloseAccount），并与声明的付款进行比对 → 匹配 / 不匹配 / 未知（未知 ≠ 安全）	免费
verify_payment_requirements	payment_required（已解码的 402 JSON 或原始 base64）、expect?	此 x402 402 响应在传输过程中是否被篡改？对卖家签名的要求进行 Ed25519 验证 → 正常 / 摘要不匹配 / …	免费
evidence_bundle	address、network?	将 OceanAlt 可公开提供的关于某地址的所有信息整合为一个签名包（筛查 + 证据 + 时效性、画像信号、单跳关联、收据统计）；它是证人，不是原告	免费
screen_endpoint	url	此付款 URL 或域名是否在钓鱼名单中，或看起来像钓鱼链接？地址筛查无法回答这个问题	免费
check_payment_request	from、headers、body、pay_to …	有邮件、发票或消息要求你付款：发件人是否伪造？链接是否为钓鱼链接？收款方是否在名单中或已被更改？是否存在施压行为或针对 AI 的指令？	免费
baseline_controls	—	Agent 控制基线：Agent 转移资金前，运营方应执行的控制措施	免费
attest_control_baseline	entity、answers、gapPlan?	提交你方的控制基线证明，以便付款方查询	免费
payee_decide	payee（注册表 ID）、payer?、amountUsdc?、purpose?	结算前由收款方进行检查：接受 / 拒绝 / 暂缓并请求信息 / 尚未就绪，并提供原因代码、需请求的字段、证据和签名	免费
compliance_decision	to、amountUsdc?、purpose?、network?	完整的网关判定（允许 / 审核 / 拒绝）+ 证据	$0.002，或 1 个积分
deep_trace	address（T…）	Tron 多跳 USDT 污染追踪（深度 ≤3）	$0.01
batch_screen	addresses[]（≤25）	批量筛查（最多 25 个地址）	$0.01

对于 0x 地址，network 可选：ethereum · base · bsc · polygon · arbitrum · optimism · avalanche（省略时自动检测）。Tron 和 Solana 会自动检测。

输出语言

面向用户的字段（signals、note、advice）默认以英语返回； 传入 lang: "zh" 可获取中文。每个响应还包含 signal_keys——与语言无关的键， 例如 list.mixer 或 taint.onehop。请根据这些键进行分支判断，而不是根据文本内容：措辞会变化，键不会。

其中两个工具经常返回“found: false”

counterparty_control_baseline 和 resolve_agent_identity 对大多数对象都会返回 found: false， 因为发布信息是自愿的。这表示没有信息，不是负面信号，Agent 绝不应仅据此拒绝付款。请回退到 payment_decision。

快速开始（免费工具）

添加到 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 主网。 付费端点会在 Base 主网上结算真实 USDC（eip155:8453）；上述 $ 价格会以真实 USDC 收取。付款前，请务必确认 https://oceanalt.com/api/x402 上的实时网络和价格清单，并使用余额较低的专用付款钱包。

🔐 钱包安全。 OCEANALT_PAYER_KEY 仅在本地进程中用于签署一份 EIP-3009 授权。它绝不会打包进此软件包、绝不会上传、绝不会记录到日志中。 Facilitator 支付 gas，且绝不托管您的资金。请使用余额较低的专用付款钱包，不要使用主资金钱包。

环境变量

变量	用途	默认值
OCEANALT_BASE	后端基础 URL	https://oceanalt.com（生产环境）
OCEANALT_PAYER_KEY	付款钱包密钥 — 启用付费工具	未设置（仅限免费工具）
OCEANALT_CREDIT_TOKEN	来自 POST https://oceanalt.com/api/x402/credits 的充值包令牌（$0.10 = 100 次判决，有效期 365 天）。之后 compliance_decision 每次调用消耗 1 次额度，且无需签名	未设置

它是什么（以及不是什么）

此软件包是一个轻量（约 9KB）的客户端，用于调用 OceanAlt 的公开 API。它不包含专有逻辑或数据 — 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 的链上地址合规筛查和合规网关。提供收据，不给黑箱评分：每条判决都附带可点击核验的证据。覆盖 8 条 EVM 链、波场 TRON 和 Solana，付款前先问一句「这个收款方安全吗」。

• 免费工具：payment_decision（付款前调用一次 → allow/review/decline + 证据 + 可核验的结算凭证）、screen_address（单地址查询 + 证据）、payee_decide（收款方三态决策）、counterparty_control_baseline / resolve_agent_identity（对方的控制基线与责任链）、recent_flagged（近期被标记的对象）、check_calldata_intent（盲签检查，EVM calldata 或整笔 Solana 交易）、screen_endpoint（付款网址是否为钓鱼网址）、check_payment_request（收到要求付款的邮件、发票或消息时，检查发件人真伪、钓鱼链接、收款地址、催付款话术和写给 AI 的指令）、baseline_controls / attest_control_baseline（控制基线清单与自证）、verify_payment_requirements（402 应答验签）、evidence_bundle（签名证据包）。无需密钥，无需注册。
• 付费三工具（x402）：compliance_decision（网关判决）、deep_trace（波场深度追踪）、batch_screen（批量筛查）。按需加载 @x402+viem，设置 OCEANALT_PAYER_KEY 后即可启用。价格：判决 $0.002、追踪 $0.01、批量 $0.01。也可以设置 OCEANALT_CREDIT_TOKEN（充值包 $0.10 = 100 次判决，在 POST https://oceanalt.com/api/x402/credits 购买），compliance_decision 每次扣除 1 次额度，无需再逐笔签名。
• ⚠️ 真金白银：付费端点目前在 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。