Behavioural Prediction Mcp

🧠 ChainAware 行動予測 MCP サーバー

MCP サーバー名： ChainAware Behavioural Prediction MCP

カテゴリー： Web3／セキュリティ／DeFi 分析

ステータス： 公開ツール — プライベートバックエンド

アクセス： リクエスト制（API キー · x402 決済に対応）

サーバー URL： [https://prediction.mcp.chainaware.ai/sse]

リポジトリ： [https://github.com/ChainAware/behavioral-prediction-mcp]

ウェブサイト： [https://chainaware.ai/]

Twitter： [https://x.com/ChainAware/]

LinkedIn： [https://www.linkedin.com/company/chainaware]

ブログ： [https://chainaware.ai/blog]

学習リソース： [https://chainaware.ai/learn]

サンプル： [https://github.com/ChainAware/examples]

掲載実績： CB Insights Fraud Prevention Market Map for the AI Era — ChainAware は、Web3 向けの AI 時代を代表する不正防止ソリューションとして認定されました（2026 年）。

掲載実績： BNB Chain AI Landscape — ChainAware は、エコシステムの主要な AI プロジェクトとして BNB Chain に掲載されました（2025 年）。

掲載実績： BNB Chain Kickstart — Marketing Tools — ChainAware の Growth Agents と Wallet Marketer が、BNB Chain Kickstart プログラムの Marketing Tools セクションに掲載されました（2025 年）。

受賞： Google Cloud $250k Grant — ChainAware は、25 万ドルの Google Cloud 助成金の対象に選ばれました（2025 年）。

選出： AWS Fintech Accelerator — ChainAware は、AWS Fintech Accelerator プログラムに採択されました（2024 年）。

掲載実績： Safary Club Web3 Growth Landscape — Growth Tools — ChainAware は、Web3 プロジェクト向け Growth Tools カテゴリーに掲載されました（2024 年）。

mcp-name: io.github.ChainAware/chainaware-behavioral-prediction-mcp

---

📖 説明

Behavioural Prediction MCP Server は、ウォレットの行動予測、不正検出、ラグプル予測を分析する AI 搭載ツールを提供します。

開発者やプラットフォームは、MCP プロトコルを通じてこれらのツールを統合し、DeFi ユーザーを保護し、流動性リスクを監視し、ウォレットやコントラクトの信頼性をスコアリングできます。

すべてのツールは Model Context Protocol (MCP) に準拠しており、MCP 対応クライアントから利用できます。

バックテストで検証済み： 不正予測検出の精度 98% · ラグプル検出の精度 90.1%

🏆 ChainAware は、CB Insights Fraud Prevention Market Map for the AI Era に掲載されています — Web3 向けの AI 搭載不正防止ソリューションをリードする企業として認定されました（2026 年）。 🌐 ChainAware は、BNB Chain AI Landscape に掲載されています — BNB Chain エコシステムの主要な AI プロジェクトとして認定されました（2025 年）。 🚀 ChainAware は、BNB Chain Kickstart — Marketing Tools に掲載されています — Growth Agents と Wallet Marketer が、エコシステムの成長を支援する BNB Chain の公式プログラムで紹介されました（2025 年）。 💰 ChainAware は、250k Google Cloud Grant を受け取りました — インフラストラクチャと AI 開発を目的として Google Cloud に選出されました（2025 年）。 ☁️ ChainAware は、AWS Fintech Accelerator に採択されました — AWS の Fintech Accelerator プログラムに選出されました（2024 年）。 🌱 ChainAware は、Safary Club Web3 Growth Landscape — Growth Tools に掲載されています — Web3 プロジェクト向け Growth Tools カテゴリーに掲載されました（2024 年）。

---

⚙️ 利用可能なツール

1. 予測型不正検出ツール

ID: predictive_fraud

説明： この AI 搭載アルゴリズムは、指定されたウォレットアドレスで不正行為が発生する前に、その可能性を予測し（バックテスト精度約98％）、AML／アンチマネーロンダリングチェックも実行します。 ユーザーがブロックチェーンアドレスのリスク評価や早期警告を求めている場合に使用してください。

➡️ 使用例：

• vitalik.eth とやり取りしても安全ですか？
• このアドレスの不正ステータスはどうなっていますか？
• 新しいウォレットが不正利用されるリスクはありますか？

入力：

名前	型	必須	説明
apiKey	string	✅*	ChainAware API キー。x402 決済を使用する場合は省略できます
network	string	✅	ブロックチェーンネットワーク（ETH、BNB、POLYGON、TON、BASE、TRON、HAQQ）
walletAddress	string	✅	評価するウォレットアドレス

出力（JSON）：

{
  "message": "string",                         // e.g. “Success” or error description
  "walletAddress": "string",                   // blockchain wallet address that was analyzed
  "chain": "string",                           // blockchain network identifier (e.g. ETH, BNB,POLYGON,TON,BASE, TRON, HAQQ)
  "status": "string",                          // classification result (e.g. “Fraud” | “Not Fraud” | “New Address”)
  "probabilityFraud": "0.00–1.00",             // decimal fraud probability score (string to preserve precision)
  
  "token": "string | null",                    // optional token associated with the check (may be null)
  "lastChecked": "ISO-8601 timestamp",         // last time the wallet risk analysis was executed
  
  "forensic_details": {
    "cybercrime": "string",                    // indicator score for cybercrime activity
    "money_laundering": "string",              // indicator score for money laundering activity
    "number_of_malicious_contracts_created": "string",  // number of malicious contracts deployed by this wallet
    "gas_abuse": "string",                     // gas abuse indicator
    "financial_crime": "string",               // financial crime indicator
    "darkweb_transactions": "string",          // interaction with darkweb-linked wallets
    "reinit": "string",                        // reinitialization exploit indicator
    "phishing_activities": "string",           // phishing activity indicator
    "fake_kyc": "string",                      // fake KYC related activity
    "blacklist_doubt": "string",               // suspected blacklist association
    "fake_standard_interface": "string",       // fake ERC interface indicator
    "data_source": "string",                   // source of forensic intelligence (may be empty)
    "stealing_attack": "string",               // stealing attack indicator
    "blackmail_activities": "string",          // blackmail activity indicator
    "sanctioned": "string",                    // sanction exposure indicator
    "malicious_mining_activities": "string",   // malicious mining indicator
    "mixer": "string",                         // interaction with mixing services
    "fake_token": "string",                    // fake token creation or usage indicator
    "honeypot_related_address": "string"       // interaction with honeypot-related addresses
  },
  "checked_times": 0,                          // integer — number of times this wallet has been analyzed
  
  "createdAt": "ISO-8601 timestamp",           // record creation timestamp
  "updatedAt": "ISO-8601 timestamp",           // record last update timestamp

  "sanctionData": [
    {
      "category": "string | null",              // sanction category (may be null)
      "name": "string | null",                  // sanction list name
      "description": "string | null",           // sanction description
      "url": "string | null",                   // source URL for sanction information
      "isSanctioned": false,                    // boolean — whether the wallet is officially sanctioned
      "createdAt": "ISO-8601 timestamp",        // sanction record creation timestamp
      "updatedAt": "ISO-8601 timestamp"         // sanction record last update timestamp
    }
  ]
}

エラーケース：

    • `402 Payment Required` → x402 決済が必要です。対応クライアントは自動的に決済します
• `400 Bad Request` → `network` または `walletAddress` の形式が不正です
• `500 Internal Server Error` → 下流で一時的な障害が発生しました

---

2. バッチ予測型不正検出ツール

ID: predictive_fraud_batch

説明： この AI 搭載アルゴリズムは、指定されたウォレットアドレスで不正行為が発生する前に、その可能性を予測し（精度約98％）、バッチで AML／アンチマネーロンダリングチェックも実行します。 ウォレットアドレスのリストを対象に、バッチ不正計算ジョブをスケジュールします。 ユーザーが分析対象のアドレスを CSV またはリストで提供した場合に使用してください。 ジョブ ID と署名をすぐに返します。ジョブ ID をユーザーに伝え、後続の呼び出しに必要なため、ジョブ ID と署名の両方をコンテキストに保存してください。 スケジュール後にポーリングしたり、結果を待ったりしないでください。

➡️ 使用例：

• ETH ネットワーク上のこのアドレスリストに対して不正のバッチ処理を実行しますか？
• BNB 上のこれらのアドレスの不正ステータスはどうなっていますか？

入力：

名前	型	必須	説明
apiKey	string	✅*	ChainAware API キー。x402 決済を使用する場合は省略できます
network	string	✅	ブロックチェーンネットワーク（ETH、BNB、POLYGON、TON、BASE、TRON、HAQQ）
addresses	array[objects]	✅	評価するウォレットアドレスのリスト

出力（JSON）：

{
  "message": "Job scheduled successfully.",
  "job_id": "0fc5897a-ad64-4f21-88b5-1274d1cfec46",
  "signature": "260866090d88bf61bdfb54f0533fe876bfd8ded7339691c50ada9de59a48124a",
  "total_items": 5,
  "chunks_enqueued": 1,
  "status": "pending"
}

エラーケース：

    • `402 Payment Required` → x402 決済が必要です。対応クライアントは自動的に決済します
• `400 Bad Request` → `network` または `walletAddress` の形式が不正です
• `500 Internal Server Error` → 下流で一時的な障害が発生しました

---

3. 予測行動分析ツール

ID: predictive_behaviour

説明： この AI 駆動型エンジンは、ウォレットアドレスの意図や、次に行う可能性が高い行動を予測し、 過去のオンチェーン履歴を分析して、パーソナライズされたアクションを推奨します。

次のような場合に使用します。

  • 次善のアクションや意図の予測（「このアドレスは入金、取引、ステーキングのどれを行うでしょうか？」）  
  • リスク許容度と経験レベルのプロファイル  
  • カテゴリー別のセグメント化（例：NFT、DeFi、ブリッジの利用状況）  
  • 過去のパターンに基づくカスタムの推奨事項

➡️ 使用例：

• 「このアドレスは次に何をするでしょうか？」  
• 「このユーザーはハイリスク志向ですか、それとも経験豊富ですか？」  
• 「ETH ネットワーク上の 0x1234... に最適な DeFi 戦略を推奨してください。」

入力：

名前	型	必須	説明
apiKey	string	✅*	ChainAware API キー — x402 決済を使用する場合は省略可能
network	string	✅	ブロックチェーンネットワーク（ETH、BNB,BASE,HAQQ,SOLANA）
walletAddress	string	✅	評価するウォレットアドレス

出力（JSON）：

{
      "message": "string",                           // e.g. “Success” or error description
      "walletAddress": "string",                     // blockchain wallet address analyzed
      "status": "string",                            // fraud classification result (e.g. “Fraud” | “Not Fraud” | “New Address”)

      "probabilityFraud": "0.00–1.00",               // decimal probability score indicating fraud risk
      "token": "string | null",                      // optional token context for the analysis
      "chain": "string",                             // blockchain network identifier (e.g. ETH, BNB,BASE,HAQQ,SOLANA)

      "lastChecked": "ISO-8601 timestamp",           // last time the wallet was analyzed

      "forensic_details": {
        "cybercrime": "string",                      // indicator of cybercrime association
        "money_laundering": "string",                // money laundering activity indicator
        "number_of_malicious_contracts_created": "string", // malicious contracts deployed by wallet
        "gas_abuse": "string",                       // abnormal gas usage indicator
        "financial_crime": "string",                 // financial crime activity indicator
        "darkweb_transactions": "string",            // interaction with darkweb-linked wallets
        "reinit": "string",                          // contract reinitialization exploit indicator
        "phishing_activities": "string",             // phishing activity indicator
        "fake_kyc": "string",                        // fake KYC interaction indicator
        "blacklist_doubt": "string",                 // suspected blacklist association
        "fake_standard_interface": "string",         // fake token interface indicator
        "data_source": "string",                     // source of forensic intelligence
        "stealing_attack": "string",                 // stealing attack indicator
        "blackmail_activities": "string",            // blackmail activity indicator
        "sanctioned": "string",                      // sanction exposure indicator
        "malicious_mining_activities": "string",     // malicious mining activity indicator
        "mixer": "string",                           // interaction with mixing services
        "fake_token": "string",                      // fake token creation/use indicator
        "honeypot_related_address": "string"         // honeypot contract interaction indicator
      },

      "categories": [
        {
          "Category": "string",                      // wallet interaction category (e.g. DeFi, NFT, Bridge)
          "Count": 0                                 // number of transactions/interactions in this category
        }
      ],

      "riskProfile": [
        {
          "Category": "Risk_Profile",                 // willingnes to take risk object
          "Balance_age": 0.0                         // 1-10 willingnes to take risk value
        }
      ],

      "segmentInfo": "string (JSON encoded)",        // serialized JSON containing protocol engagement flags (e.g "{\"Maker\":0,\"Aave_borrow\":0,\"Aave_lend\":1,\"Lido\":0,\"Uniswap\":1,\"Compound_lend\":0,\"Compound_borrow\":0}")

      "experience": {
        "Type": "string",                            // descriptor label (e.g. “Experience”)
        "Value": 0                                   // numeric experience score level
      },

      "intention": {
        "Type": "string",                            // descriptor label (e.g. “Intentions”)
        "Value": {
          "Prob_Lend": "Low | Medium | High",
          "Prob_Trade": "Low | Medium | High",
          "Prob_Game": "Low | Medium | High",
          "Prob_NFT": "Low | Medium | High",
          "Prob_Stake_ETH": "Low | Medium | High",
          "Prob_Borrow": "Low | Medium | High",
          "Prob_Gamble": "Low | Medium | High",
          "Prob_Stake": "Low | Medium | High",
          "Prob_Yield_Farm": "Low | Medium | High",
          "Prob_Leveraged_Stake": "Low | Medium | High",
          "Prob_Leveraged_Stake_ETH": "Low | Medium | High",
          "Prob_Leveraged_Lend": "Low | Medium | High",
          "Prob_Leverage_Long_ETH": "Low | Medium | High",
          "Prob_Leverage_Long": "Low | Medium | High"
        }
      },

      "protocols": [
        {
          "Protocol": "string",                      // protocol name (e.g. Uniswap, Curve, MakerDAO)
          "Count": 0                                 // number of interactions with this protocol
        }
      ],

      "userDetails": {
        "wallet_age_days": 0,                        // age of wallet in days
        "total_balance_usd": 0.0,                    // current wallet balance in USD
        "transaction_count": 0,                      // total number of transactions executed
        "wallet_rank": 0                             // ranking of wallet in the scoring system
      },

      "riskCapability": 0,                           // numeric risk capability score

      "recommendation": {
        "Type": "string",                            // descriptor label (e.g. “Recommendation”)
        "Value": [
          "string"                                   // recommended strategies or actions
        ]
      },

      "checked_times": 0,                            // number of times the wallet analysis was executed
      "createdAt": "ISO-8601 timestamp",             // record creation timestamp
      "updatedAt": "ISO-8601 timestamp",             // record last update timestamp

      "sanctionData": [
        {
          "category": "string | null",               // sanction category
          "name": "string | null",                   // sanction list name
          "description": "string | null",            // sanction description
          "url": "string | null",                    // reference source URL
          "isSanctioned": false,                     // whether the wallet is officially sanctioned
          "createdAt": "ISO-8601 timestamp",
          "updatedAt": "ISO-8601 timestamp"
        }
      ]
    }
    

エラーケース：

    • `402 Payment Required` → x402 決済が必要です — 対応クライアントは自動的に決済します  
• `400 Bad Request` → `network` または `walletAddress` の形式が不正です  
• `500 Internal Server Error` → 一時的な下流障害  

---

4. 一括予測行動分析ツール

ID: predictive_behaviour_batch

説明： この AI 駆動型エンジンは、ウォレットアドレスの意図や、次に行う可能性が高い行動を予測し、 過去のオンチェーン履歴を分析して、パーソナライズされたアクションを推奨します。 ウォレットアドレスのリストを対象に、行動予測の一括計算ジョブをスケジュールします。 ユーザーが CSV またはアドレスのリストを提供した場合に使用します。 job_id と signature を直ちに返します。job_id をユーザーに伝え、 以降のすべての呼び出しに必要なため、job_id と signature の両方をコンテキストに保存してください。 スケジュール後に結果をポーリングしたり、待機したりしないでください。

次のような場合に使用します。

  • 次善のアクションや意図の予測（「これらのアドレスは入金、取引、ステーキングのどれを行うでしょうか？」）  
  • 指定されたアドレスのリストに対するリスク許容度と経験レベルのプロファイル
  • カテゴリー別のセグメント化（例：NFT、DeFi、ブリッジの利用状況）  
  • 過去のパターンに基づくカスタムの推奨事項

➡️ 使用例：

• 「これらのアドレスは次に何をするでしょうか？」  
• 「これらのユーザーはハイリスク志向ですか、それとも経験豊富ですか？」  
• 「ETH ネットワーク上の [{ox1..,0x2,0x3}] に最適な DeFi 戦略を推奨してください。」

入力：

名前	型	必須	説明
apiKey	string	✅*	ChainAware API キー — x402 決済を使用する場合は省略可能
network	string	✅	ブロックチェーンネットワーク（ETH、BNB,BASE,HAQQ,SOLANA）
addresses	array[objects]	✅	評価するウォレットアドレス

出力（JSON）：

{
  "message": "Job scheduled successfully.",
  "job_id": "0fc5897a-ad64-4f21-88b5-1274d1cfec46",
  "signature": "260866090d88bf61bdfb54f0533fe876bfd8ded7339691c50ada9de59a48124a",
  "total_items": 5,
  "chunks_enqueued": 1,
  "status": "pending"
}

エラーケース：

    • `402 Payment Required` → x402 決済が必要です — 対応クライアントは自動的に決済します  
• `400 Bad Request` → `network` または `walletAddress` の形式が不正です  
• `500 Internal Server Error` → 一時的な下流障害  

---

5. 予測型ラグプル検出ツール

ID: predictive_rug_pull

説明： この AI 搭載エンジンは、将来「ラグプル」を実行する可能性の高い流動性プールやコントラクトを予測します（バックテスト精度 90.1%）。リスクの高いプールにユーザーが預け入れる前に警告したい場合や、オンチェーンでスマートコントラクトのセキュリティを監視したい場合に使用します。

➡️ 使用例：

• 「この新しい DeFi プールに資産をステーキングすると、ラグプルされますか？」  
• 「私の LP ポジションを監視して、将来発生する可能性のあるエクスプロイトを検出してください。」  

入力：

名前	型	必須	説明
apiKey	string	✅*	ChainAware API キー — x402 決済を使用する場合は省略可能
network	string	✅	ブロックチェーンネットワーク（ETH、BNB、BASE、HAQQ）
walletAddress	string	✅	スマートコントラクトまたは流動性プールのアドレス

出力（JSON）：

{
      "message": "string",                         // e.g. “Success” or error description

      "contractAddress": "string",                 // smart contract address analyzed
      "pairAddress": "string",                     // liquidity pair address on DEX
      "contractCreatorAddress": "string | null",   // creator address of the contract if known

      "risk_score": 0,                             // numeric internal risk score
      "risk_status": "string",                     // qualitative risk level (e.g. “Low Risk”, “Medium Risk”, “High Risk”)

      "risk_indicators": {
        "is_honeypot": 0,                          // honeypot detection flag
        "honeypot_with_same_creator": 0,           // creator deployed previous honeypots
        "can_take_back_ownership": 0,              // contract allows reclaiming ownership
        "is_mintable": 0,                          // token supply can be minted
        "hidden_owner": 0,                         // hidden ownership mechanism detected

        "buy_tax": 0,                              // buy transaction tax percentage
        "sell_tax": 0,                             // sell transaction tax percentage

        "cannot_buy": 0,                           // trading restriction preventing buys
        "cannot_sell_all": 0,                      // restriction preventing full sell

        "is_blacklisted": 0,                       // blacklist functionality detected
        "is_whitelisted": 0,                       // whitelist-only functionality detected

        "creator_percent": 0,                      // percentage of supply owned by creator
        "lp_holders_locked": false,                // liquidity lock status

        "liquidity": 0.0,                          // liquidity amount in base token
        "market_cap": 0,                           // estimated market capitalization

        "is_in_dex": 0,                            // token listed on DEX

        "slippage_modifiable": 0,                  // contract can modify slippage parameters
        "transfer_pausable": 0,                    // transfers can be paused
        "is_anti_whale": 0,                        // anti-whale protection mechanism
        "anti_whale_modifiable": 0,                // anti-whale parameters modifiable

        "trading_cooldown": 0,                     // cooldown period between trades
        "personal_slippage_modifiable": 0,         // per-wallet slippage modification

        "is_open_source": 0,                       // contract source verified
        "is_proxy": 0,                             // proxy contract indicator

        "owner_address": "string",                 // owner address of contract
        "owner_change_balance": 0,                 // owner ability to modify balances

        "selfdestruct": 0,                         // self-destruct capability
        "external_call": 0,                        // external calls present
        "gas_abuse": 0                             // abnormal gas manipulation behavior
      },

      "liquidityEvent": [
        {
          "eventType": "string",                   // liquidity event type (e.g. add/remove)
          "amount": 0.0,                           // liquidity amount affected
          "token": "string",                       // token symbol involved in liquidity

          "tx_hash": "string",                     // transaction hash

          "from_address": "string",                // address initiating liquidity action
          "from_fraud_probability": "0.00–1.00",   // fraud probability score for sender
          "from_fraud_status": "string",           // fraud classification of sender

          "createdAt": "ISO-8601 timestamp"        // timestamp of liquidity event
        }
      ],

      "status": "string",                          // overall fraud classification of contract
      "probabilityFraud": "0.00–1.00",             // probability of contract being fraudulent

      "chain": "string",                           // blockchain network identifier (e.g. BNB, ETH, BASE, HAQQ)
      "lastChecked": "ISO-8601 timestamp",         // last time contract analysis was performed

      "contractCreationTime": "ISO-8601 timestamp | null", // contract deployment timestamp

      "forensic_details": {
        "owner": "object",                         // owner metadata
        "privilege_withdraw": 0,                   // privileged withdraw capability
        "withdraw_missing": 0,                     // missing withdraw function
        "is_open_source": 0,                       // contract source verification status
        "blacklist": 0,                            // blacklist functionality
        "contract_name": "string",                 // contract/token name
        "selfdestruct": 0,                         // self-destruct capability
        "is_proxy": 0,                             // proxy contract indicator
        "approval_abuse": 0                        // abnormal token approval behavior
      },

      "checked_times": 0,                          // number of times contract has been analyzed

      "createdAt": "ISO-8601 timestamp",           // record creation time
      "updatedAt": "ISO-8601 timestamp"            // last update time
    }

エラーケース：

    • `402 Payment Required` → x402 決済が必要です — 対応クライアントは自動的に決済します  
• `400 Bad Request` → `network` または `walletAddress` の形式が不正です  
• `500 Internal Server Error` → 下流で一時的な障害が発生しました  

---

6. クレジットスコアツール

ID: credit_score

説明： ブロックチェーンウォレット向けの AI による暗号資産の信用・信頼スコアリングです。不正行為の確率、オンチェーンの流入・流出分析、ソーシャルグラフ分析を組み合わせ、1（リスクが最高）から 9（信頼度が最高）までの riskRating を算出します。ウォレットごとに信用力を示す単一の数値をすばやく取得する必要がある DeFi レンディングプロトコル向けに設計されています。

➡️ 使用例：

• 「このウォレットのクレジットスコアは？」
• 「この借り手の信頼スコアはいくつですか？」
• 「このローンを承認する前にクレジットスコアを算出してください。」

入力：

名前	型	必須	説明
apiKey	string	✅*	ChainAware API キー — x402 決済を使用する場合は省略可能
network	string	✅	ブロックチェーンネットワーク（ETH）
walletAddress	string	✅	スコアを算出するウォレットのアドレス

出力（JSON）：

{
  "message": "Success",
  "creditData": {
    "riskRating": 7,
    "walletAddress": "0x..."
  }
}

riskRating	リスクレベル	レンディングにおける解釈
9	非常に低いリスク	優良な借り手
7–8	低リスク	信頼できる借り手
5–6	中程度のリスク	より慎重な対応が必要
3–4	高リスク	条件を制限
1–2	非常に高いリスク	融資を拒否

エラーケース：

• `401 Unauthorized` → `apiKey` が無効です（x402 決済を使用する場合は該当しません）
• `400 Bad Request` → `network` または `walletAddress` の形式が不正です
• `500 Internal Server Error` → 下流で一時的な障害が発生しました

---

7. トークンランキングリストツール

ID: token_rank_list

説明： TokenRank はトークン保有者のコミュニティを分析し、保有者の強さに基づいてすべてのトークンをランク付けします。トークン保有者が強いほど、トークンも強くなります！ トークンのランキングを確認したい場合や、異なるカテゴリーやチェーン間で比較したい場合に使用します。 検索、フィルター、並べ替え、ページネーションを利用して、トークンのリストを取得できます。

➡️ 使用例： – 「AI トークンカテゴリーで最も優れたトークンはどれですか？」 – 「ETH チェーンと BNB チェーンの x トークンを比較してください」

入力：

名前	型	必須	説明
limit	string	✅	ページネーションで取得する項目数
offset	string	✅	ページネーションでのページ番号
network	string		フィルター対象のブロックチェーンネットワーク（ETH、BNB、BASE、SOLANA）
sort_by	string		返されるトークンの並べ替え基準（例：'communityRank'）
sort_order	string		sort_by の値を並べ替える順序（'ASC' または 'DESC'）
category	string		トークンのカテゴリーに基づくフィルター（例：'AI Token'、'RWA Token'、'DeFi Token'、'DeFAI Token'、'DePIN Token'）
contract_name	string		コントラクト名に基づく検索

出力（JSON）：

  {
    "message": "string",                    // e.g. “Successfully fetched records” or error description
    "data": {
      "total": 0,                           // integer — total number of matching contracts
      "contracts": [
        {
          "contractAddress": "string",       // unique contract or mint address (chain-specific format)
          "contractName": "string",          // human-readable token name
          "ticker": "string",                // token symbol (usually uppercase, but not guaranteed)
          "chain": "string",                 // blockchain network (e.g. SOLANA | ETH | BNB | BASE)
          "category": "string",              // primary category label (e.g. 'AI Token','RWA Token','DeFi Token','DeFAI Token','DePIN Token') 
          "type": "string",                  // asset classification (e.g. “token” | “nft”)
          "communityRank": 0,                // integer — raw ranking based on community metrics
          "normalizedRank": 0,               // integer — normalized or scaled ranking score
          "totalHolders": 0,                 // integer — total unique wallet holders
          "lastProcessedAt": "ISO-8601",     // timestamp when analytics were last computed
          "createdAt": "ISO-8601",           // record creation timestamp
          "updatedAt": "ISO-8601"            // record last update timestamp
        }
      ]
    }
  }

エラーケース：

• `400 Bad Request` → 不正な `network` または `walletAddress`
• `500 Internal Server Error` → 一時的な下流障害

---

8. 単一トークンランキングツール

ID: token_rank_single

説明： TokenRank List と同様に、Token Rank はトークン保有者のコミュニティを分析し、保有者の強さに基づいてすべてのトークンをランク付けします。 トークンランキングとトークンの詳細に加えて、単一トークンランキングツールは、最良の保有者とその詳細、および同じネットワーク内でのグローバルランキングを取得します。 コントラクトアドレスと正確なチェーンまたはネットワークに基づいて単一トークンのランキングを確認したい場合や、特定のネットワークまたはチェーンにおけるトークンの最良の保有者を確認したい場合に使用します。

➡️ 使用例： – 「ETH ネットワークにおけるトークンのランキングは何ですか？」 – 「このコントラクトのトークンアドレスの最良の保有者は誰ですか？」 – 「トークンのランキングと最良の保有者は何ですか？」

入力：

名前	型	必須	説明
contract_address	string	✅	評価対象のトークンのコントラクトアドレス
network	string	✅	フィルター対象のブロックチェーンネットワーク（ETH、BNB、BASE、SOLANA）

出力（JSON）：

 {
      "message": "string",                      // e.g. “Successfully fetched records” or error description
      "data": {
        "contract": {
            "contractAddress": "string",       // unique contract or mint address (chain-specific format)
            "contractName": "string",          // human-readable token name
            "ticker": "string",                // token symbol (usually uppercase, but not guaranteed)
            "chain": "string",                 // blockchain network (e.g. SOLANA | ETH | BNB | BASE)
            "category": "string",              // primary category label (e.g. 'AI Token','RWA Token','DeFi Token','DeFAI Token','DePIN Token') 
            "type": "string",                  // asset classification (e.g. “token” | “nft”)
            "communityRank": 0,                // integer — raw ranking based on community metrics
            "normalizedRank": 0,               // integer — normalized or scaled ranking score
            "totalHolders": 0,                 // integer — total unique wallet holders
            "lastProcessedAt": "ISO-8601",     // timestamp when analytics were last computed
            "createdAt": "ISO-8601",           // record creation timestamp
            "updatedAt": "ISO-8601"            // record last update timestamp
        },
        "topHolders": [
          {
            "contractAddress": "string",        // associated contract address
            "Holder": {
              "walletAddress": "string",        // holder wallet address
              "chain": "string",                // blockchain network of the wallet
              "balance": "string",              // token balance (string to preserve precision)
              "walletAgeInDays": 0,             // integer — age of wallet in days
              "transactionsNumber": 0,          // integer — total transaction count
              "totalPoints": 0.0,               // float — computed wallet scoring metric
              "globalRank": 0                   // integer — wallet rank across entire system
            }
          }
        ]
      }
    }

エラーケース：

• `400 Bad Request` → 不正な `network` または `walletAddress`
• `500 Internal Server Error` → 一時的な下流障害

---

9. トークン監査ツールを実行

ID: run_token_audit

説明： 指定されたトークンコントラクトのトークン監査を依頼するか、指定されたトークンについてすでに計算済みの監査データを返します。このツールは「取得または作成」を行います。 まず、このコントラクトの監査がすでに完了しているか確認し、完了している場合は リスクレポート全体をすぐに返します。まだ監査がない場合は、新しい監査をキューに追加し、 代わりに job_id と「queued」ステータスを返します。

ユーザーがトークン／コントラクトのリスク、詐欺の兆候、ハニーポットの挙動、所有権リスク、流動性リスクについて、監査、スキャン、確認、評価を求めた場合は、必ずこのツールを使用してください。新しいリクエストでは、最初に呼び出す唯一のツールでなければなりません。「とりあえず確認する」ために、先に get_token_audit_result を呼び出さないでください。

➡️ 使用例： – 「このトークンコントラクトを監査してください：0x...」 – 「この BSC トークンは安全ですか？ 0x...」 – 「購入前にこのコントラクトのリスクをスキャンしてください」 – 「このアドレスがハニーポットか確認してください」

入力：

名前	型	必須	説明
contract_address	文字列	✅	評価するトークンのコントラクトアドレス
network	文字列	✅	トークンが存在するネットワーク／チェーン（例：'arbitrum'、'avalanche'、'base'、'bsc'、'eth'、'optimism'、'polygon'）

出力（JSON）：

📤 レスポンス — 2 つの形式が考えられます。受け取った形式を確認してください： 1.キャッシュ済み／監査済み → audit_status = "complete" リスクレポート全体がすぐに返されます（get_token_audit_result と同じスキーマです）。 このデータに基づいて、ユーザーの質問に直接回答してください。追加のツール呼び出しは不要です。

2.まだ監査されていない → honeypot_analysis フィールドがなく、代わりに次の内容が返されます：

 {
    "contract_address": "string",
    "chain": "string",
    "job_id": "string",
    "status": "queued",
    "message": "string"  
  }

⚠️ 注意： • すでに進行中の「queued」／「running」ジョブを返すコントラクトについて、新しい監査を再度開始しないでください。 • 新しい計算をスケジュールするのではなく、監査済みトークンの結果を直接取得できるよう、レスポンスに基づいてトークンが以前に監査されているか必ず最初に確認してください。

エラーケース：

• `400 Bad Request` → 不正な `network` または `walletAddress`
• `500 Internal Server Error` → 一時的な下流障害

---

10. トークン監査結果取得ツール

ID: get_token_audit_result

説明： 指定されたコントラクトアドレスとチェーンについて、以前に開始したトークン監査ジョブの現在のステータスまたは最終結果を取得します。 これは監査ワークフローの第 2 ステップです。「Run Token Audit」の呼び出し後に、完全なリスクレポートをポーリングして取得するために使用します。 「Run Token Audit」の直後にこのツールを呼び出して進捗を確認し、レスポンスの audit_status フィールドが "complete" になるまで繰り返しポーリングしてください。 audit_status がそれ以外（例："queued"、"running"、"pending"）の場合は、結果はまだ準備できていないものとして扱ってください。部分的または空のモジュールデータをユーザーに要約せず、監査が進行中であることだけを伝えて（可能であれば経過時間も表示）、少し待ってから再度ポーリングしてください。 audit_status = "complete" になると、このツールは、所有権の管理、流動性の健全性、供給量／ミントのリスク、トランスファーの完全性、approve／permit の安全性、リエントランシー、ハニーポットの挙動、および判定を含む 0～100 の総合リスクスコアを網羅した、複数モジュールからなる完全なリスクレポートを返します。このデータを使って、トークンの安全性、リスク要因、または危険信号に関するユーザーの質問に直接回答してください。このコントラクトの監査結果がすでに完了している場合、新たな監査を取得または再実行しないでください。

➡️ 使用例： – 「このトークンの監査結果はもう出ていますか？」 – 「このコントラクトのリスクスコアと判定を教えてください」 – 「このトークンの所有者は誰ですか？ミントやブラックリスト登録を行えますか？」 – 「これはハニーポットですか？どのようなフラグがありますか？」 – 「このコントラクトの流動性と所有権のリスクを詳しく教えてください」

入力：

名前	型	必須	説明
contract_address	string	✅	評価するトークンのコントラクトアドレス
network	string	✅	トークンが存在するネットワーク／チェーン（例：'arbitrum'、'avalanche'、'base'、'bsc'、'eth'、'optimism'、'polygon'）

出力（JSON）：

  {
      "contract_address": "string",
      "chain": "string",
      "audit_status": "string",
      "token_name": "string",
      "token_symbol": "string",
      "token_decimals": "integer",
      "token_creator": "string",
      "token_feeder": "string",
      "source_verified": "boolean",
      "is_proxy": "boolean",
      "behavioral_is_honeypot": "boolean",
      "honeypot_analysis": {
          "verdict": "string",
          "score": "integer",
          "findings": [
              {
                  "rule": "string",
                  "severity": "string",
                  "function": "string or null" ,
                  "detail": "string"
              }
          ],
          "flags": [
              "string"
          ]
      },
      "aggregate": {
          "verdict": "string",
          "risk_score": "integer",
          "primary_signal": "string",
          "simulate": "boolean",
          "version": "string",
          "duration_ms": "integer",
          "last_run": "ISO-8601"
      },
      "quick_stats": [
          {
              "label": "string",
              "value": "string",
              "tone": "string"
          },
          {
              "label": "string",
              "value": "string",
              "tone": "string"
          },
          {
              "label": "string",
              "value": "string",
              "tone": "string"
          }
      ],
      "modules": {
          "ownership": {
              "status": "string",
              "risk_score": "integer",
              "owner_address": "string",
              "owner_is_eoa": "boolean",
              "owner_is_renounced": "boolean",
              "blast_radius": "critical",
              "can_mint": "boolean",
              "can_pause": "boolean",
              "can_blacklist": "boolean",
              "can_upgrade": "boolean",
              "can_drain": "boolean",
              "has_timelock": "boolean",
              "has_shadow": "boolean"
          },
          "liquidity": {
              "status": "string",
              "summary": "string",
              "risk_score": "integer",
              "pool_count": "integer",
              "unknown_pool": "boolean",
              "invariants": [
                  {
                      "code": "string",
                      "label": "string",
                      "status": "string",
                      "severity": "string",
                      "detail": "string"
                  }
              ]
          },
          "supply": {
              "status": "pass",
              "risk_score": "integer",
              "has_mint": "boolean",
              "deployer_pct": "decimal",
              "hidden_mint": "boolean"
          },
          "transfer": {
              "status": "pass",
              "risk_score": "integer",
              "method": "string",
              "monitoring": "boolean",
              "inv_t1_pass": "boolean",
              "inv_t2_pass": "boolean",
              "inv_t3_pass": "boolean",
              "inv_t4_pass": "boolean",
              "inv_t5_pass": "boolean",
              "inv_t6_pass": "boolean",
              "inv_t7_pass": "boolean"
          },
          "pausability": {
              "status": "string",
              "applicable": "boolean"
          },
          "approve": {
              "status": "string",
              "risk_score": "integer",
              "method": "string",
              "coverage": "string",
              "inv1_pass": "boolean",
              "inv2_pass": "boolean",
              "inv3_pass": "boolean",
              "inv5_pass": "boolean",
              "inv6_pass": "boolean"
          },
          "permit": {
              "status": "string",
              "applicable": "boolean"
          },
          "reentrancy": {
              "status": "string",
              "risk_score": "integer"
          }
        }
    }

⚠️ 注意： • audit_status が "complete" でない場合、ほとんどのモジュール／集計フィールドは null、空、または古い情報である可能性があります。最終結果として提示しないでください。 • risk_score が高い場合、または tone／severity フィールドが "high"／"critical" の場合は、危険性が高まっていることを示します。合格したモジュールの情報に埋もれさせず、目立つように提示してください。

エラーケース：

• `400 Bad Request` → 不正な `network` または `walletAddress`
• `500 Internal Server Error` → 一時的な下流障害

---

11. エージェントの信頼スコア一覧ツール

ID: agents_trust_score_list

説明： ChainAware エージェント信頼スコアは、ERC-8004 に登録されたあらゆる AI エージェントとのやり取りがどれほど安全かを測定する、0～1000 のスコアです。 エージェント同士の投票で信頼を作り上げられる投票ベースの評判システムとは異なり、エージェント信頼スコアはオンチェーン上の行動履歴のみから算出されます。数時間で獲得することはできず、新しいウォレットを集めて偽造することもできません。エージェントを管理する個人または組織の実社会での実績を反映しています。 ChatGPT、Google Gemini、Shopify を通じて、AI エージェントが消費者に代わって自律的に購入を完了するようになり、エージェントによるコマースが拡大するなか、取引を任せられるエージェントはどれかという問いは、もはや理論上のものではありません。ChainAware は、同業者からの推薦ではなく、オンチェーンの証拠をもとに答えを提供します。 エージェントの一覧とその結果を返します。

➡️ 使用例： – エージェントとその信頼スコアの一覧を表示して。 – 2025-01-01 以降に登録された、最も優れたエージェントはどれですか？

入力：

名前	型	必須	説明
page	string	✅	ページネーション中のページ番号（page）
limit	string	✅	ページネーション中に取得する項目数
sort_by	string	X	例：registered_at などを基準に、返されるエージェントを並べ替えます
sort_order	string	X	sort_by による並べ替えで asc または desc を指定します（デフォルトは desc）。sort_by が必須です
registered_after	string	X	エージェントの登録日時に基づいて絞り込みます

出力（JSON）：

{
    "total": "integer",
    "page": 1,
    "limit": 2,
    "results": [
      {
          "chain_id": "integer",
          "agent_id": "integer",
          "owner_address": "string",
          "agent_wallet": "string",
          "agent_uri": "string",
          "meta_name": "string",
          "registered_at": "ISO-8601",
          "reputation_score": "integer",
          "trust_score": "integer",
          "trust_tier": "string"
      },
      {
          "chain_id": "integer",
          "agent_id": "integer",
          "owner_address": "string",
          "agent_wallet": "string",
          "agent_uri": "string",
          "meta_name": "string",
          "registered_at": "ISO-8601",
          "reputation_score": "integer",
          "trust_score": "integer",
          "trust_tier": "string"
      }
      ]
    }

エラーケース：

• `400 Bad Request` → `network` または `walletAddress` の形式が不正な場合  
• `500 Internal Server Error` → 下流サービスで一時的な障害が発生した場合  

---

12. エージェント信頼スコア（単一ツール）

ID: agents_trust_score_single

説明： Agent Trust Listと同様に、Agent Trust Score Singleは、ERC-8004に登録された任意のAIエージェントとのやり取りがどれほど安全かを測定する、0～1000のスコアです。 エージェント同士が相互に高評価を付けて信頼を捏造できる投票ベースの評判システムとは異なり、Agent Trust Scoreはオンチェーンの行動履歴のみから算出されます。数時間で獲得することはできません。新しいウォレットを集めても偽装できません。エージェントを管理する個人または組織の、現実世界における実績を反映します。 ChatGPT、Google Gemini、Shopifyを通じてAIエージェントが消費者に代わって自律的に購入を完了するようになり、エージェント型コマースが拡大するなか、どのエージェントが取引相手として信頼できるかという問いは、もはや仮定の話ではありません。ChainAwareは、同業者からの推薦ではなく、オンチェーンの証拠をもとにこの問いに答えます。 指定したエージェントの詳細情報を1件、掘り下げて返します。

➡️ 使用例： – 「chain_id 56のagent id 12314の信頼スコアを教えてください」

入力：

名前	型	必須	説明
agent_id	integer	✅	agents_trust_score_list Toolが返すエージェントID
chain_id	integer	✅	エージェントがデプロイ／登録されたチェーンID。事前にagents_trust_score_list Toolから取得します

出力（JSON）：

{
    "agent_id": "integer",
    "chain": "string",
    "chain_id": "integer",
    "owner_address": "string",
    "agent_wallet": "string",
    "wallet_verified": "boolean",
    "agent_uri": "string",
    "registered_at": "ISO-8601",
    "fetched_at": "ISO-8601",
    "error": "string",
    "meta_name": "string",
    "meta_description": "string",
    "meta_image": "string",
    "metadata_json": {
        "type": "string",
        "name": "string",
        "description": "string",
        "image": "string",
        "active": "boolean",
        "supportedTrust": "array[string]"
    },
    "registration": {
        "agent_name": "string",
        "agent_desc": "string",
        "fetch_status": "string",
        "fetched_at": "ISO-8601",
        "raw_json": {
            "type": "string",
            "name": "string",
            "description": "string",
            "image": "string",
            "active": "boolean",
            "supportedTrust": "array[string]"
        }
    },
    "wallets": [
        {
            "wallet_chain_id": "integer",
            "wallet_address": "string",
            "source": "registry",
            "fetched_at": "ISO-8601"
        }
    ],
    "reputation_score": "string",
    "trust_score": "integer",
    "trust_tier": "string",
    "trust_flags": "array[string]"
}

エラーケース：

• `400 Bad Request` → `network`または`walletAddress`の形式が不正  
• `500 Internal Server Error` → 一時的な下流サービスの障害  

---

13. バッチジョブのステータスを確認する

ID: check_job_status

説明： スケジュール済みバッチ計算ジョブの進捗状況を確認します。 返されるのは件数のみ（完了、失敗、保留中）で、ウォレットデータは含まれません。 ジョブが完了したか、または進捗状況をユーザーが尋ねた場合に呼び出してください。 ステータスが「processing」または「pending」の場合はユーザーに伝え、get_job_resultsは呼び出さないでください。 結果の取得は、ステータスが「completed」または「partial」の場合にのみ提案してください。 このツールの呼び出しには、schedule_calculationから取得したjob_idとsignatureの両方が必要です。 コンテキストに両方の値がそろっていない場合は、絶対に呼び出さないでください。

➡️ 使用例：

• signature 260866090d88bf61bdfb54f0533fe876bfd8ded7339691c50ada9de59a48124aを使ったjob id 0fc5897a-ad64-4f21-88b5-1274d1cfec46のステータスを教えてください。

入力：

名前	型	必須	説明
job_id	string	✅	スケジュール済み計算（predictive_fraud_batchまたはpredictive_behaviour_batch）が返すジョブID
signature	string	✅	スケジュール済み計算（predictive_fraud_batchまたはpredictive_behaviour_batch）が返す署名。アクセスに必要です

出力（JSON）：

{
    "job_id": "0fc5897a-ad64-4f21-88b5-1274d1cfec46",
    "status": "partial",
    "chain": "ETH",
    "total_items": 5,
    "completed_items": 1,
    "failed_items": 4,
    "pending_items": 0,
    "expires_at": "2026-07-01T13:51:20.000Z"
}

エラーケース：

• `403 Unauthorized` → `apiKey`が無効（x402支払いの使用時には該当しません）
• `403 Unauthorized` → `signature`が無効
• `400 Bad Request` → `network`または`walletAddress`の形式が不正  
• `500 Internal Server Error` → 一時的な下流サービスの障害  

---

14. バッチジョブの結果を取得する

ID: get_job_results

説明： 完了済み、または一部完了したバッチジョブの結果を取得します。 check_job_status のステータスが 'completed' または 'partial' の場合にのみ呼び出してください。 完了したウォレットアドレスの一覧と共有チェーン／ネットワークを返します。これらを使ってメインバックエンドに問い合わせ、実際のウォレット分析データを取得してください。 このツールはウォレットデータを直接返すのではなく、データを取得するために必要なアドレス一覧のみを返します。 このツールを呼び出すには、schedule_calculation の job_id と signature の両方が必要です。 コンテキストに両方の値がない場合は、決して呼び出さないでください。

➡️ 使用例：

• ジョブ ID 0fc5897a-ad64-4f21-88b5-1274d1cfec46 と署名 260866090d88bf61bdfb54f0533fe876bfd8ded7339691c50ada9de59a48124a を使ったジョブの結果は何ですか？

入力：

名前	型	必須	説明
job_id	string	✅	スケジュールされた計算（predictive_fraud_batch または predictive_behaviour_batch）から返されたジョブ ID
signature	string	✅	スケジュールされた計算（predictive_fraud_batch または predictive_behaviour_batch）から返された署名。アクセスに必要です

出力（JSON）：

{    
  "message": "string",                               // e.g. “Success” or error description
  "data":[{
      "walletAddress": "string",                     // blockchain wallet address analyzed
      "status": "string",                            // fraud classification result (e.g. “Fraud” | “Not Fraud” | “New Address”)

      "probabilityFraud": "0.00–1.00",               // decimal probability score indicating fraud risk
      "token": "string | null",                      // optional token context for the analysis
      "chain": "string",                             // blockchain network identifier (e.g. ETH, BNB,BASE,HAQQ,SOLANA)

      "lastChecked": "ISO-8601 timestamp",           // last time the wallet was analyzed

      "forensic_details": {
          "cybercrime": "string",                      // indicator of cybercrime association
          "money_laundering": "string",                // money laundering activity indicator
          "number_of_malicious_contracts_created": "string", // malicious contracts deployed by wallet
          "gas_abuse": "string",                       // abnormal gas usage indicator
          "financial_crime": "string",                 // financial crime activity indicator
          "darkweb_transactions": "string",            // interaction with darkweb-linked wallets
          "reinit": "string",                          // contract reinitialization exploit indicator
          "phishing_activities": "string",             // phishing activity indicator
          "fake_kyc": "string",                        // fake KYC interaction indicator
          "blacklist_doubt": "string",                 // suspected blacklist association
          "fake_standard_interface": "string",         // fake token interface indicator
          "data_source": "string",                     // source of forensic intelligence
          "stealing_attack": "string",                 // stealing attack indicator
          "blackmail_activities": "string",            // blackmail activity indicator
          "sanctioned": "string",                      // sanction exposure indicator
          "malicious_mining_activities": "string",     // malicious mining activity indicator
          "mixer": "string",                           // interaction with mixing services
          "fake_token": "string",                      // fake token creation/use indicator
          "honeypot_related_address": "string"         // honeypot contract interaction indicator
      },

      "categories": [
          {
          "Category": "string",                      // wallet interaction category (e.g. DeFi, NFT, Bridge)
          "Count": 0                                 // number of transactions/interactions in this category
          }
      ],

      "riskProfile": [
          {
          "Category": "Risk_Profile",                 // willingnes to take risk object
          "Balance_age": 0.0                         // 1-10 willingnes to take risk value
          }
      ],

      "segmentInfo": "string (JSON encoded)",        // serialized JSON containing protocol engagement flags (e.g "{\"Maker\":0,\"Aave_borrow\":0,\"Aave_lend\":1,\"Lido\":0,\"Uniswap\":1,\"Compound_lend\":0,\"Compound_borrow\":0}")

      "experience": {
          "Type": "string",                            // descriptor label (e.g. “Experience”)
          "Value": 0                                   // numeric experience score level
      },

      "intention": {
          "Type": "string",                            // descriptor label (e.g. “Intentions”)
          "Value": {
          "Prob_Lend": "Low | Medium | High",
          "Prob_Trade": "Low | Medium | High",
          "Prob_Game": "Low | Medium | High",
          "Prob_NFT": "Low | Medium | High",
          "Prob_Stake_ETH": "Low | Medium | High",
          "Prob_Borrow": "Low | Medium | High",
          "Prob_Gamble": "Low | Medium | High",
          "Prob_Stake": "Low | Medium | High",
          "Prob_Yield_Farm": "Low | Medium | High",
          "Prob_Leveraged_Stake": "Low | Medium | High",
          "Prob_Leveraged_Stake_ETH": "Low | Medium | High",
          "Prob_Leveraged_Lend": "Low | Medium | High",
          "Prob_Leverage_Long_ETH": "Low | Medium | High",
          "Prob_Leverage_Long": "Low | Medium | High"
          }
      },

      "protocols": [
          {
          "Protocol": "string",                      // protocol name (e.g. Uniswap, Curve, MakerDAO)
          "Count": 0                                 // number of interactions with this protocol
          }
      ],

      "userDetails": {
          "wallet_age_days": 0,                        // age of wallet in days
          "total_balance_usd": 0.0,                    // current wallet balance in USD
          "transaction_count": 0,                      // total number of transactions executed
          "wallet_rank": 0                             // ranking of wallet in the scoring system
      },

      "riskCapability": 0,                           // numeric risk capability score

      "recommendation": {
          "Type": "string",                            // descriptor label (e.g. “Recommendation”)
          "Value": [
          "string"                                   // recommended strategies or actions
          ]
      },

      "checked_times": 0,                            // number of times the wallet analysis was executed
      "createdAt": "ISO-8601 timestamp",             // record creation timestamp
      "updatedAt": "ISO-8601 timestamp",             // record last update timestamp

      "sanctionData": [
          {
          "category": "string | null",               // sanction category
          "name": "string | null",                   // sanction list name
          "description": "string | null",            // sanction description
          "url": "string | null",                    // reference source URL
          "isSanctioned": false,                     // whether the wallet is officially sanctioned
          "createdAt": "ISO-8601 timestamp",
          "updatedAt": "ISO-8601 timestamp"
          }
      ]
  }]
}

エラーケース：

• `403 Unauthorized` → 無効な `apiKey`（x402 決済の使用時には該当しません）
• `403 Unauthorized` → 無効な `signature`
• `400 Bad Request` → 不正な形式の `network` または `walletAddress`  
• `500 Internal Server Error` → 一時的な下流障害  

---

🧠 クライアントの使用例

Node.js の例

import { MCPClient } from "mcp-client";

const client = new MCPClient("https://prediction.mcp.chainaware.ai/");

const result = await client.call("predictive_rug_pull", {
  apiKey: "your_api_key",
  network: "BNB",
  walletAddress: "0x1234..."
});

console.log(result);

Python の例

from mcp_client import MCPClient

client = MCPClient("https://prediction.mcp.chainaware.ai/")

res = client.call("chat", {"query": "What is the rug pull risk of 0x1234?"})
print(res)

---

サービスの設定：

  "type": "sse",
  "config": {
    "mcpServers": {
      "chainaware-behavioural_prediction_mcp": {
        "type": "sse",
        "url": "https://prediction.mcp.chainaware.ai/sse",
        "description": "The Behavioural Prediction MCP Server provides AI-powered tools to analyze wallet behaviour prediction,fraud detection and rug pull prediction.",
        "headers":{
          "x-api-key":""
        },
        "params":{
          "walletAddress":"",
          "network":""
        },
        "auth": {
          "type": "api_key",
          "header": "X-API-Key"
        }
      }
    }
  }
}

---

🔌 統合に関する注意事項

• ✅ Node.js、Python、ブラウザベースの環境の MCP クライアントと互換性があります
• 🔁 ストリーミング／リアルタイム応答には Server-Sent Events（SSE） を使用します
• 📐 JSON スキーマは MCP 仕様に準拠しています
• 🚦 使用プランに応じてレート制限が適用される場合があります
• 🔑 本番エンドポイントには API キーが必要です
• 💳 x402 決済に対応 — サブスクリプション API キーなしで、x402 プロトコルを介した呼び出しごとの支払いが可能です。x402 対応クライアントは HTTP 402 応答時の支払いを自動的に処理します

---

Claude Code（CLI）の設定

Claude CLI を使って、SSE トランスポート経由で MCP サーバーを登録します。

claude mcp add --transport sse chainaware-behavioural-prediction-mcp-server https://prediction.mcp.chainaware.ai/sse \
  --header "X-API-Key: your-key-here"

📚 ドキュメント： https://code.claude.com/docs/en/mcp

---

ChatGPT コネクターの設定

コネクター／MCP（開発者モード）に対応する ChatGPT 環境で利用できます。

手順

1. ChatGPT の設定を開きます
2. アプリ／コネクターに移動します
3. コネクターを追加をクリックします
4. 以下の統合名と URL を入力します
5. 設定を保存します

統合の詳細

名前

ChainAware Behavioural Prediction MCP Server

統合 URL

https://prediction.mcp.chainaware.ai/sse?apiKey=your-key-here

---

Claude Web と Claude Desktop の設定

手順

1. Claude Web または Claude Desktop を開きます
2. 設定 → 統合に移動します
3. 統合を追加をクリックします
4. 以下の名前と URL を入力します
5. 追加をクリックして設定を完了します

統合の詳細

名前

ChainAware Behavioural Prediction MCP Server

統合 URL

https://prediction.mcp.chainaware.ai/sse?apiKey=your-key-here

📚 ドキュメント： https://platform.claude.com/docs/en/agents-and-tools/remote-mcp-servers

---

Cursor の設定

MCP サーバーを Cursor の設定ファイル（例：mcp.json）に追加します。

{
  "mcpServers": {
    "chainaware-behavioural-prediction-mcp-server": {
      "url": "https://prediction.mcpbeta.chainaware.ai/sse",
      "transport": "sse",
      "headers": {
        "X-API-Key": "your-key-here"
      }
    }
  }
}

📚 ドキュメント： https://cursor.com/docs/context/mcp

---

🤖 Claude Code サブエージェント

このリポジトリには、.claude/agents/ にすぐに使える 34 個の Claude Code サブエージェントが含まれています。これらの専門エージェントは、一般的な Web3 インテリジェンスのタスクにすぐ対応できます。

エージェント	目的
chainaware-wallet-auditor	包括的なデューデリジェンス — 不正の兆候を含む、詳細な行動プロファイリング
chainaware-fraud-detector	ウォレットの迅速な不正スクリーニング
chainaware-rug-pull-detector	スマートコントラクト／LP の安全性チェック
chainaware-trust-scorer	信頼スコア（0.00–1.00）
chainaware-credit-scorer	融資や信用力の判断に用いる暗号資産の信用スコア（1–9）
chainaware-ltv-estimator	行動シグナルに基づく、12 か月間の収益ポテンシャル（LTV）の米ドル範囲
chainaware-reputation-scorer	評判スコア（0–1000）
chainaware-aml-scorer	AML コンプライアンススコア（0–100）
chainaware-wallet-ranker	ウォレットの利用経験ランクとリーダーボード
chainaware-wallet-marketer	パーソナライズされたマーケティングメッセージ
chainaware-token-ranker	保有者コミュニティの強さに基づくトークンの検索／ランキング
chainaware-token-analyzer	単一トークンの詳細分析と上位保有者
chainaware-onboarding-router	ウォレットを初心者／中級者／オンボーディング対象外に振り分け
chainaware-whale-detector	ウォレットをクジラの階層（Mega／Whale／Emerging）に分類
chainaware-defi-advisor	利用経験とリスク階層に応じたパーソナライズ済み DeFi 製品の推奨
chainaware-airdrop-screener	エアドロップの対象資格についてウォレットを一括スクリーニングし、ボット／不正を除外
chainaware-lending-risk-assessor	借り手のリスク評価（A–F）、担保比率、金利階層
chainaware-token-launch-auditor	上場前のローンチ安全性監査 — APPROVED／CONDITIONAL／REJECTED
chainaware-agent-screener	エージェントとフィーダーウォレットのチェックによる AI エージェントの信頼スコア（0–10）
chainaware-cohort-analyzer	ウォレットの一括データを行動コホートに分類し、コホートごとのエンゲージメント戦略を提示
chainaware-counterparty-screener	取引、送金、コントラクト操作の前に、安全／注意／ブロックの判定をリアルタイムで提示
chainaware-governance-screener	DAO 投票者のスクリーニング — シビル検出、ガバナンス階層、投票ウェイト倍率（トークンウェイト型、評判ウェイト型、二次投票モデルに対応）
chainaware-sybil-detector	DAO 投票に対するシビル攻撃を一括検出 — 投票者を ELIGIBLE／REVIEW／EXCLUDE に分類し、協調的な不正パターン（ウォレットファーム、新規ウォレットの急増）を検出して、評判に基づく投票倍率を算出
chainaware-transaction-monitor	自律型エージェント向けのリアルタイム取引リスクスコアリング — 複合スコア（0–100）とパイプラインのアクション（ALLOW／FLAG／HOLD／BLOCK）
chainaware-lead-scorer	営業リードの評価 — リードスコア（0–100）、階層（Hot／Warm／Cold／Dead）、コンバージョン確率、推奨するアプローチ
chainaware-upsell-advisor	既存ユーザー向けのアップセル経路 — アップグレード準備度スコア、次の製品の推奨、トリガーイベント、そのまま使えるアップセルメッセージ
chainaware-platform-greeter	特定のプラットフォーム上の特定ウォレットに向けた、コンテキストに応じたウェルカムメッセージ — 同じウォレットでも、Aave、1inch、OpenSea では異なるメッセージを提示
chainaware-marketing-director	キャンペーン全体を統括 — オーディエンスをセグメント化し、リードをスコアリングし、クジラを検出し、コホートごとのメッセージ戦略を作成し、アップセル機会を提示して、新規ウォレットを振り分け
chainaware-compliance-screener	MiCA に準拠した一次コンプライアンススクリーニング — fraud-detector、aml-scorer、transaction-monitor、counterparty-screener を連携し、判定（PASS／EDD／REJECT）を含むコンプライアンスレポートを作成
chainaware-gamefi-screener	Web3 ゲームおよび P2E ウォレットのスクリーニング — ボットファーム、不正行為者、ファームウォレットを検出し、正規プレイヤーをマッチメイキング用の経験階層に分類し、P2E 報酬の対象資格を出力
chainaware-portfolio-risk-advisor	ポートフォリオレベルでのラグプルとコミュニティの健全性評価 — すべてのトークンをスキャンし、加重ポートフォリオリスクスコア、評価（A–F）、集中度フラグ、優先順位付きのリバランス計画を作成
chainaware-rwa-investor-screener	RWA 投資家の適格性スクリーニング — 不正リスク、経験、RWA 階層とのリスクプロファイルの適合性を評価し、投資上限とともに QUALIFIED／CONDITIONAL／REFER_TO_KYC／DISQUALIFIED を返す
chainaware-agent-trust-screener	ERC-8004 AI エージェントの信頼性スクリーニング — 登録済みエージェントを信頼スコア（0–1000）で一覧表示し、ランキング付けして、信頼階層とフラグを返す。未検証のウォレットには強い警告を表示
chainaware-token-audit-analyst	トークンコントラクトの詳細な複数モジュール監査 — 所有権、流動性、供給量／ミント、ハニーポット検出、リエントランシーを確認。非同期パイプラインでリスクスコア（0–100）とモジュールごとの内訳を出力

セットアップ

ステップ 1 — MCP サーバーに接続する

エージェントは MCP 経由で ChainAware のツールを呼び出します。まずサーバーを登録してください。

claude mcp add --transport sse chainaware-behavioral-prediction \
  https://prediction.mcp.chainaware.ai/sse \
  --header "X-API-Key: YOUR_KEY"

Cursor / Windsurf の場合は、mcp.json に追加してください。

{
  "mcpServers": {
    "chainaware-behavioral-prediction": {
      "url": "https://prediction.mcp.chainaware.ai/sse",
      "transport": "sse",
      "headers": { "X-API-Key": "YOUR_KEY" }
    }
  }
}

ステップ 2 — エージェントファイルをコピーする

このリポジトリをクローンし、エージェントをプロジェクトにコピーしてください。

git clone https://github.com/ChainAware/behavioral-prediction-mcp.git
cp -r behavioral-prediction-mcp/.claude/agents/ your-project/.claude/agents/

または、必要なエージェントだけをチェリーピックしてください。

mkdir -p your-project/.claude/agents
cp behavioral-prediction-mcp/.claude/agents/chainaware-fraud-detector.md \
   your-project/.claude/agents/

ステップ 3 — API キーを設定する

export CHAINAWARE_API_KEY="your-key-here"

https://chainaware.ai/pricing でキーを取得してください。

重要な注意事項

• 各エージェントのフロントマターにある tools: 行では、登録名を使って MCP サーバーを参照しています。別の名前でサーバーを登録する場合は、一致するように tools: 行を更新してください。
• エージェントはフロントマターで model:（claude-haiku-4-5-20251001 または claude-sonnet-4-6）を指定します。これらのモデルを利用できる必要があります。
• references/ フォルダーには、エージェントにより豊富なコンテキストを提供する詳細なツールドキュメントが含まれています。必須ではありませんが、エージェントと一緒にコピーすることをおすすめします。

---

🔐 セキュリティに関する注意事項

• 公開リポジトリに API キーをハードコードしないでください
• 対応している場合は、環境変数またはシークレットマネージャーを使用してください
• 本番環境ではキーを定期的にローテーションしてください

---

🔒 アクセスポリシー

MCP サーバーは、次の 2 つのアクセス方法に対応しています。

• API キー — https://chainaware.ai/pricing でプランに登録し、X-API-Key ヘッダーでキーを渡します
• x402 決済 — 任意の x402 対応 MCP クライアントを利用すると、サブスクリプションなしで呼び出しごとに支払う方式でアクセスできます。サーバーは決済情報とともに HTTP 402 を返し、クライアントが自動的に決済を完了します

---

📖 関連情報

報道・受賞歴

• CB Insights Fraud Prevention Market Map for the AI Era — ChainAware は、Web3 向けの AI 時代をリードする不正防止ソリューションとして紹介されています（2026 年）
• BNB Chain AI Landscape — ChainAware は、エコシステムの主要な AI プロジェクトとして BNB Chain に掲載されています（2025 年）
• BNB Chain Kickstart — Marketing Tools — Growth Agents と Wallet Marketer が BNB Chain の Kickstart プログラムで紹介されています（2025 年）
• Google Cloud $250k Grant — ChainAware は 25 万ドルの Google Cloud 助成金の対象に選ばれました（2025 年）
• AWS Fintech Accelerator — ChainAware は AWS Fintech Accelerator プログラムに採択されました（2024 年）
• Safary Club Web3 Growth Landscape — Growth Tools — ChainAware は Web3 プロジェクト向けの Growth Tools として紹介されています（2024 年）

製品概要

• ChainAware Complete Product Guide — すべてのツール、ネットワーク、対応範囲の概要
• Web3 Business Potential — Web3 インテリジェンスのビジネス上の意義と市場機会
• Use ChainAware as a Business — ChainAware を基盤に商用製品やサービスを構築する方法

ツール別ガイド

• 不正検知ガイド — predictive_fraud の使い方：入力、出力、しきい値、ユースケース
• ラグプル検知ガイド — predictive_rug_pull の使い方：コントラクトのスコアリング、デプロイヤーのリスク、LP 分析
• トークンランキングガイド — token_rank_list と token_rank_single の使い方：コミュニティの強さのスコアリング
• ウォレットランキングガイド — ウォレットのランキングシステム：経験レベル、グローバルランク、ポイント
• ウォレット監査ガイド — 複数のツールを組み合わせたウォレット監査の全ワークフロー
• トランザクション監視ガイド — リアルタイムのトランザクションリスク監視パターン
• Web3 行動分析ガイド — ユーザー分析とセグメンテーションにおける predictive_behaviour の使用方法
• クレジットスコアガイド — Web3 のクレジットスコアリング手法と DeFi レンディングでの活用
• クレジットスコアリングエージェントガイド — ChainAware のクレジットスコアリングエージェントの構築方法と使い方
• エージェント型コマース向けエージェント信頼スコア — 274k 以上の登録済みエージェントを対象とした ERC-8004 エージェント審査：信頼レベル、フリート全体の不正検知、agents_trust_score_list / agents_trust_score_single を使った DeFi アクセス制御
• トークン監査：CoinGecko トークン 10,000 件の結果 — 実環境での調査：上位トークンの 55% が HIGH RISK 判定を受け、run_token_audit による 127 項目の自動セキュリティチェックを実施

分析と戦略

• DApp の成長に向けた Web3 ユーザーのセグメンテーションと行動分析 — DApp のユーザー維持と成長に向けたセグメンテーション戦略
• AI を活用したブロックチェーン分析：暗号資産セキュリティのための機械学習 — オンチェーンセキュリティと不正検知における ML のアプローチ
• フォレンジック暗号資産分析と AI ベースの暗号資産分析 — 従来のフォレンジックツールと ChainAware の予測型 AI アプローチの比較
• MiCA 準拠 DeFi スクリーナー — ChainAware が DeFi に関する MiCA 義務の約 70～75% をどのようにカバーするか、コンプライアンススクリーナーと Chainalysis／Elliptic の位置付け
• 2026 年版 Web3 成長プラットフォーム比較 — 3 段階のファネルフレームワーク。ChainAware はステージ 3（接続後の DApp 内パーソナライズ）で機能
• 2026 年版 DApp 向け Web3 分析ツール比較 — 10 の分析プラットフォームを 4 つの業務カテゴリに分類。予測インテリジェンスプラットフォームは ChainAware のみ
• パーソナライズが AI エージェントの次なる大きな潮流である理由 — Web3 におけるウォレット単位のパーソナライズの重要性

開発者向けインテグレーション

• AI エージェントが利用できる 12 のブロックチェーン機能 — MCP インテグレーションガイド — すべての機能を解説し、Claude、ChatGPT、Cursor、マルチエージェントシステム向けのセットアップ手順を紹介します
• AI エージェント向け Prediction MCP：ウォレットの行動から意思決定をパーソナライズ — コード例を含む詳細なインテグレーションガイド
• Prediction MCP が DeFi プラットフォームを大幅に強化する 5 つの方法 — レンディング、DEX、ローンチパッド、ガバナンス、パーソナライズのユースケース
• 2026 年の DeFi オンボーディング：接続されたウォレットの 90％が取引しない理由と、AI エージェントによる解決策 — オンボーディングのコンバージョン問題と AI を活用した解決策
• Web3 エージェント経済：AI エージェントが DeFi で人間のチームに取って代わる方法 — 自律型 AI エージェントが DeFi の運用と意思決定を担う仕組み

---

🧾 ライセンス

MIT（クライアントのサンプル用）。 サーバーの実装とバックエンドのロジックは独自のものであり、非公開です。

リソースとサードパーティ

---

🏆 評価

ChainAware は、AI 時代をリードする AI 搭載型不正防止ソリューションとして、CB Insights の「AI 時代の不正防止市場マップ」 で紹介されています（2026 年）。

ChainAware は BNB Chain AI Landscape に掲載されており、エコシステムの主要な AI プロジェクトとして BNB Chain に認定されています（2025 年）。

ChainAware は BNB Chain Kickstart — Marketing Tools に掲載されており、Growth Agents と Wallet Marketer が BNB Chain の公式 Kickstart プログラムで紹介されています（2025 年）。

ChainAware は Google Cloud Grant 25 万ドル を獲得し、インフラストラクチャと AI 開発のために Google Cloud に選定されました（2025 年）。

ChainAware は AWS Fintech Accelerator に採択され、AWS の Fintech Accelerator プログラムに選定されました（2024 年）。

ChainAware は Safary Club Web3 Growth Landscape — Growth Tools で紹介され、Web3 プロジェクト向け Growth Tools カテゴリーに掲載されています（2024 年）。