publicaml

PublicAML MCP サーバー

Claude Desktop、Cursor、その他の MCP クライアント内でブロックチェーンの AML スクリーニングを実行できます。 平易な言葉でアドレスについて尋ねると、アシスタントが PublicAML と照合します。制裁対象か、発行体による凍結があるか、トランザクショングラフを通じて伝播したリスクがあるか、ウォレットに資金を送った相手や取引相手を確認します。

対応チェーン：bitcoin、ethereum、bsc、tron。

アカウントなしで利用できます。API キーを設定すると、レート制限が緩和され、送金の追跡が利用可能になります。

インストール

Claude Desktop の claude_desktop_config.json：

{
  "mcpServers": {
    "publicaml": {
      "command": "npx",
      "args": ["-y", "@publicaml/mcp-server"]
    }
  }
}

API キーを使う場合：

{
  "mcpServers": {
    "publicaml": {
      "command": "npx",
      "args": ["-y", "@publicaml/mcp-server"],
      "env": { "PUBLICAML_API_KEY": "your-key" }
    }
  }
}

Cursor では .cursor/mcp.json に同じブロックを使用します。Claude Code：

claude mcp add publicaml -- npx -y @publicaml/mcp-server

ツール

screen_address

リスクレベルとスコア、制裁対象かどうか、Tether／Circle による凍結、そのアドレスの種類（取引所、ミキサー、ギャンブル、ブリッジ、個人ウォレット）、リスクの発生源を確認できます。

chain は省略可能です。省略すると、アドレス形式で許可されるすべてのチェーンがスクリーニングされ、各結果にチェーン名が表示されます。同じ 0x… 形式の文字列でも、ethereum、bsc、tron では別のウォレットを指すため、チェーンが推測されることはありません。

trace_funds

direction: "incoming" は資金の流れをさかのぼり、「このウォレットに支払ったのは誰か」を調べます。ラベル付けされたエンティティに到達すると、それ以上は取引所の他の顧客へとたどりません。direction: "outgoing" は、最大の送金フローを追跡し、資金がチェーン上の匿名領域から出た場所を調べます。送金の追跡には API キーが必要です。

追跡は実時間で制限されるため、タイムアウトする代わりに不完全な回答が返され、その旨も回答に記載されます。

list_counterparties

1つのツールで3種類の質問に答えます。classify は取引相手を列挙し、それぞれの種類（個人、サービス、ハブ、入金アドレス、コントラクト、ミント／バーン）を示します。category は「このウォレットは取引所／ミキサー／カジノに接触したか」に答えます。check は、疑わしいアドレスのリストをウォレットと照合します。

回答の読み方

• sanctioned: true は、スコアにかかわらず、それだけで取引を止めるべき事実です。
• スコアは0～100のリスク評価であり、資金の割合ではありません。各要素は MAX で統合されるため、内訳を合計しても総合スコアにはなりません。
• データにないアドレスは NOT FOUND として返されます。これは不明という意味であり、安全という意味ではありません。
• リストは順位付けされ、件数に上限があります。PARTIAL の回答は最低限の結果であり、全件一覧ではありません。
• USD の金額は価格が付いているトークンのみを対象とし、流動性の低いトークンによって過大になる場合があります。概算として扱ってください。

これは人間が判断するための証拠であり、判断そのものではありません。

設定

変数	デフォルト	意味
PUBLICAML_API_KEY	none	匿名利用時のレート制限を緩和し、送金の追跡を利用可能にします。
PUBLICAML_API_BASE	https://intelapi.publicaml.org	API のベース URL。
PUBLICAML_TIMEOUT_MS	60000	リクエストごとのタイムアウト。
PUBLICAML_TRACE_CONTINUES	2	不完全な遡及追跡を自動で再開する回数。

ワンクリックでデスクトップにインストール

同じサーバーは MCPB バンドルとしても配布されています。Claude Desktop では、JSON を編集せずにダブルクリックでインストールできます。次のコマンドでビルドします。

npm run build:mcpb

バンドルは dist/ に出力されます。バージョン、説明、ライセンス、ツール一覧は package.json とサーバー独自のツール定義から読み込まれるため、バンドルと npm リリースの内容が食い違うことはありません。

開発

npm install
npm test          # unit tests, no network
node scripts/live.mjs  # end-to-end against the live API

MIT ライセンス。API ドキュメント：https://publicaml.org/api