oceanalt-aml-mcp

oceanalt-aml-mcp

AI エージェントのためのネイティブな AML コンプライアンス。 MCP サーバーです。Claude ／ Cursor ／あらゆる MCP クライアントから、OceanAlt のオンチェーンアドレススクリーニングとコンプライアンスゲートウェイを利用できます。ブラックボックスのスコアではなく、領収情報を提供します。すべての判定には、クリックして確認できる検証可能な証拠が付属します。

エージェント型決済向けに構築されています。8 つの EVM チェーン、Tron、Solana に対応し、資金が移動する前に「この決済を実行すべきか？」と確認できます。

AI エージェント向け： あらゆる送金の前に screen_address を呼び出してください。clear ／ caution ／ risky の判定と、0～100 のリスクスコア、クリックして確認できる証拠が返されるため、推測ではなく領収情報に基づいて決済の実行条件を適用できます。clear 判定は、OceanAlt が保有するデータの中に該当情報が見つからなかったことを意味します。アドレスが安全だという意味ではなく、スクリーニングの深さはチェーンによって異なります。無料、キー不要です。

ツール

ツール	入力	機能	価格
payment_decision	to、amountUsdc?、purpose?、network?	エージェントが支払いを行う前に、1 回呼び出してください → 証拠、再試行情報、検証可能な決済証明付きで、許可／要確認／拒否を返します	無料
screen_address	address（0x…／T…／Solana）、network?	AML 判定、リスクスコア、検証可能な証拠	無料
counterparty_control_baseline	entity?／agentId?	もう 1 つの問いに答えます。「このアドレスはリスクがあるか」ではなく、「向こう側のエージェントが何かをするよう説得された場合、どれほどの損害を与え得るか」です。OceanAlt が強制する事項と、単に主張している事項を分けて、相手方の管理ベースライン証明を返します	無料
resolve_agent_identity	agentId	説明責任の連鎖を示します：エージェント → プリンシパル → 権限 → 認証情報 → ウォレット。連鎖が途切れる箇所で、説明責任も途切れます	無料
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 または raw base64）、expect?	この x402 402 レスポンスは転送中に改ざんされたでしょうか？販売者が署名した要件を Ed25519 で検証します → ok／digest_mismatch／…	無料
evidence_bundle	address、network?	OceanAlt がアドレスについて公開情報から示せるすべてを、署名付きの単一バンドルで返します（スクリーニング＋証拠＋鮮度、プロファイルシグナル、1 ホップの関連性、受領統計）。これは証人であり、原告ではありません	無料
screen_endpoint	url	この支払い URL またはドメインはフィッシングリストに掲載されているか、またはそれらしく偽装されていますか？アドレスのスクリーニングでは答えられない部分を確認します	無料
check_payment_request	from、headers、body、pay_to …	メール、請求書、メッセージで支払いを求められた場合に確認します：送信者は偽装されているか、リンクはフィッシングか、受取人は登録済みか、変更されていないか、圧力や AI を狙った指示が含まれているか？	無料
baseline_controls	—	エージェント管理ベースライン：エージェントが資金を動かす前に、運用者が実施すべき管理策	無料
attest_control_baseline	entity、answers、gapPlan?	支払者が照会できるよう、自分側の管理ベースライン証明を登録します	無料
payee_decide	payee（レジストリ ID）、payer?、amountUsdc?、purpose?	決済前に受取側で確認します：理由コード、要求するフィールド、証拠、署名とともに、accept／decline／hold_request_info／not_ready を返します	無料
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

network（0x アドレスの場合）：ethereum · base · bsc · polygon · arbitrum · optimism · avalanche（省略時は自動検出）。Tron と Solana は自動検出されます。

出力言語

人が読むフィールド（signals、note、advice）は、デフォルトで英語で返されます。 中国語の場合は lang: "zh" を渡してください。各レスポンスには、list.mixer や taint.onehop のような言語に依存しないキー signal_keys も含まれます。文章ではなく、これらのキーに基づいて分岐してください。表現は変わっても、キーは変わりません。

これらのツールのうち 2 つは「found: false」を頻繁に返します

counterparty_control_baseline と resolve_agent_identity は、公開が任意であるため、ほとんどの相手について found: false を返します。これは情報がないことを意味します。否定的なシグナルではなく、エージェントはそれだけを理由に支払いを拒否してはいけません。その場合は payment_decision に切り替えてください。

クイックスタート（無料ツール）

MCP クライアントの設定に追加します（Claude Desktop、Claude Code、Cursor、…）：

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

無料ツールの利用に API キーや登録は不要です。

有料（x402）ツールを有効にする

有料ツールは、x402 を通じて呼び出しごとに支払います — HTTP 402 → 1 件の 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 は、ローカルプロセスで 1 件の EIP-3009 承認に署名する目的にのみ使用されます。このパッケージに含まれることも、アップロードされることも、ログに記録されることもありません。ファシリテーターがガス代を支払い、資金を保管することはありません。メインの資金用ウォレットではなく、残高の少ない専用の支払い用ウォレットを使用してください。

環境変数

変数	用途	デフォルト
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 つ使用し、署名は行いません	未設定

これは何か（何ではないか）

このパッケージは、OceanAlt の公開 API を呼び出す薄い（約 9 KB の）クライアントです。独自のロジックやデータは含まれていません — AML エンジン、スコアリング、アドレスインテリジェンスはすべて oceanalt.com のサーバー側で実行されます。クエリのたびに OceanAlt 独自のアドレスインテリジェンス DB も更新されます（利用に伴って拡充されます）。

• プログラム向け 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 TRON と Solana に対応し、支払いの前に「この受取人は安全ですか？」と確認できます。

• 無料ツール：payment_decision（支払い前に 1 回呼び出し → allow/review/decline ＋証拠＋検証可能な決済証明）、screen_address（単一アドレスのチェック＋証拠）、payee_decide（受取人の 3 段階判定）、counterparty_control_baseline / resolve_agent_identity（相手の管理基準と責任の連鎖）、recent_flagged（最近フラグが付いた項目）、check_calldata_intent（ブラインド署名のチェック。EVM calldata または Solana トランザクション全体）、screen_endpoint（支払い先 URL がフィッシングかどうか）、check_payment_request（支払いを求めるメール、請求書、メッセージを受け取った際に、送信者の真正性、フィッシングリンク、受取アドレス、支払いを急がせる文言、AI に向けて書かれた指示をチェック）、baseline_controls / attest_control_baseline（管理基準のチェックリストと自己証明）、verify_payment_requirements（402 応答の署名検証）、evidence_bundle（署名付き証拠バンドル）。キーも登録も不要です。
• 有料の 3 ツール（x402）：compliance_decision（ゲートウェイ判定）、deep_trace（Tron の詳細追跡）、batch_screen（一括チェック）。必要に応じて @x402 と viem を読み込み、OCEANALT_PAYER_KEY を設定すると有効になります。価格：判定 $0.002、追跡 $0.01、一括 $0.01。また、OCEANALT_CREDIT_TOKEN（POST https://oceanalt.com/api/x402/credits で購入するクレジットパック。$0.10 = 判定 100 回）を設定することもできます。compliance_decision は呼び出しごとにクレジットを 1 回分消費し、その都度の署名は不要です。
• ⚠️ 実際の資金が使われます：有料エンドポイントは現在、Base メインネットで決済され、USDC は実際の資金です（eip155:8453）。上記の $ 価格は実際の USDC で請求されます。支払いの前に、必ず最新のマニフェスト https://oceanalt.com/api/x402 を確認し、残高の少ない専用の支払い用ウォレットを使用してください。
• 🔐 ウォレットの安全性：OCEANALT_PAYER_KEY はローカルで 1 回の EIP-3009 承認に署名する目的にのみ使用され、パッケージに含められることも、アップロードされることも、ログに記録されることもありません。ファシリテーターがガス代を代わりに支払い、資金を保管することはありません。残高の少ない専用ウォレットを使用し、メインの資金用ウォレットの秘密鍵は使わないでください。
• プログラム向け SDK：oceanalt-aml；オンラインドキュメント：https://oceanalt.com/en/api-docs；コンプライアンス標準：https://oceanalt.com/en/rap。