Behavioural Prediction Mcp

Name: Behavioural Prediction Mcp
Author: ChainAware

远程服务

github.com/ChainAware金融数据1011 周前更新

代码仓库

关于 Behavioural Prediction Mcp

Behavioural Prediction Mcp 提供 ChainAware 工具，用于评估钱包行为、欺诈风险和潜在跑路风险。它面向集成 Web3 风险分析的开发者与平台；访问需申请，并支持 API 密钥或 x402 付款。

主要功能

01钱包欺诈预测与 AML 检查
02批量欺诈分析任务
03钱包行为及后续行动预测
04批量行为分析任务
05合约和流动性池跑路风险评估

适用场景

01评估区块链钱包的欺诈风险
02批量分析一组钱包地址
03预测钱包可能采取的后续行动
04检查合约或流动性池的跑路风险

MCP 相关

该 MCP 服务向兼容客户端提供 ChainAware 钱包欺诈、行为预测、批量分析和跑路检测工具。访问需申请，并使用 API 密钥或受支持的 x402 付款。

#ai #fraud-detection #aml #audit #behavioural #prediction

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://prediction.mcp.chainaware.ai/sse

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport sse behavioral-prediction https://prediction.mcp.chainaware.ai/sse

Cursor.cursor/mcp.json{"mcpServers":{"behavioral-prediction":{"type":"sse","url":"https://prediction.mcp.chainaware.ai/sse"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"behavioral-prediction":{"type":"sse","url":"https://prediction.mcp.chainaware.ai/sse"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"behavioral-prediction":{"type":"sse","url":"https://prediction.mcp.chainaware.ai/sse"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"behavioral-prediction":{"serverUrl":"https://prediction.mcp.chainaware.ai/sse"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

全部服务地址

SSEhttps://prediction.mcp.chainaware.ai/sse需要授权

工具

参数	类型	必填
apiKey	string	是
network	string	是
walletAddress	string	是

详细介绍

🧠 ChainAware 行为预测 MCP 服务

MCP 服务名称： ChainAware 行为预测 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 AI 时代欺诈防范市场图谱 — ChainAware 获认可，成为 Web3 领域领先的 AI 时代欺诈防范解决方案（2026 年）。

收录于： BNB Chain AI Landscape — ChainAware 被 BNB Chain 列为生态系统中的关键 AI 项目（2025 年）。

收录于： BNB Chain Kickstart — 营销工具 — ChainAware 的 Growth Agents 和 Wallet Marketer 入选 BNB Chain Kickstart 计划的营销工具板块（2025 年）。

获奖： Google Cloud 25 万美元资助 — ChainAware 获选，得到 Google Cloud 提供的 250,000 美元资助（2025 年）。

入选： AWS 金融科技加速器 — ChainAware 获准加入 AWS 金融科技加速器计划（2024 年）。

收录于： Safary Club Web3 增长版图 — 增长工具 — ChainAware 入选 Web3 项目增长工具类别（2024 年）。

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

📖 描述

行为预测 MCP 服务提供 AI 驱动的工具，用于分析钱包行为预测、欺诈检测和 Rug Pull 预测。

开发者和平台可以通过 MCP 协议集成这些工具，以保护 DeFi 用户、监控流动性风险，并评估钱包或合约的可信度。

所有工具均遵循 Model Context Protocol (MCP)，并可通过兼容 MCP 的客户端使用。

回测验证结果： 欺诈预测检测准确率为 98% · Rug Pull 检测准确率为 90.1%

🏆 ChainAware 入选 CB Insights AI 时代欺诈防范市场图谱，获认可成为 Web3 领域领先的 AI 驱动欺诈防范解决方案（2026 年）。 🌐 ChainAware 收录于 BNB Chain AI Landscape，获认可成为 BNB Chain 生态系统中的关键 AI 项目（2025 年）。 🚀 ChainAware 收录于 BNB Chain Kickstart — 营销工具，其 Growth Agents 和 Wallet Marketer 入选 BNB Chain 官方生态增长计划（2025 年）。 💰 ChainAware 获得 Google Cloud 25 万美元资助，由 Google Cloud 选中，用于基础设施和 AI 开发（2025 年）。 ☁️ ChainAware 获准加入 AWS 金融科技加速器，入选 AWS 金融科技加速器计划（2024 年）。 🌱 ChainAware 入选 Safary Club Web3 增长版图 — 增长工具，列入 Web3 项目增长工具类别（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 文件或地址列表供分析时，请使用此工具。此工具会立即返回 job_id 和签名 — 请将 job_id 报告给用户，并在上下文中保存 job_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 和签名——将 job_id 告知用户，并在上下文中保存 job_id 和签名；后续所有调用都需要这两项信息。安排任务后，请勿轮询或等待结果。

在以下情况下使用：

  • 预测下一步最佳操作和意图（“这些地址会存款、交易还是质押？”）  
  • 为给定地址列表建立风险承受能力和经验画像
  • 类别细分（例如 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. Token Rank 列表工具

ID: token_rank_list

描述： TokenRank 会分析代币持有者社群，并根据持有者的实力为每种代币排名。代币持有者越强，代币就越强！
当你需要查询一个或多个代币的排名，或比较不同类别和链上的代币时，可使用此工具。你可以使用搜索、筛选、排序和分页功能，获取代币列表。

➡️ 使用示例： – “AI Token 类别中最好的代币是什么？”
– “比较 x 代币在 ETH 链和 BNB 链上的表现？”

输入：

名称	类型	必填	描述
`limit`	string	✅	分页时要获取的条目数
`offset`	string	✅	分页时的页码（offset）
`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. Token Rank 单个代币工具

ID: token_rank_single

描述： 与 TokenRank 列表类似，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`	string	✅	要评估的代币合约地址
`network`	string	✅	代币所在的网络/链（例如：'arbitrum'、'avalanche'、'base'、'bsc'、'eth'、'optimism'、'polygon'）

输出（JSON）：

📤 响应 — 有两种可能的格式，请确认收到的是哪一种： 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

描述： 获取先前针对给定合约地址和链触发的代币审计任务的当前状态或最终结果。这是审计工作流的第二步，用于在调用“运行代币审计”后轮询并获取完整风险报告。调用“运行代币审计”后，请立即调用此工具检查进度，并重复轮询，直到响应中的 audit_status 字段等于 "complete"。当 audit_status 为其他任何值（例如 "queued"、"running"、"pending"）时，应将结果视为尚未就绪：不要向用户概述不完整或为空的模块数据，只需说明审计仍在进行（如有可用信息，可选择显示已耗时长），并稍后再次轮询。一旦 audit_status = "complete"，此工具就会返回完整的多模块风险报告，涵盖所有权控制、流动性健康状况、供应量/铸造风险、转账完整性、授权/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，或值为 "high"/"critical" 的 tone/severity 字段，表示风险较高；请醒目地突出这些信息，而不要将其埋在通过检查的模块之下。

错误情况：

• `400 Bad Request` → `network` 或 `walletAddress` 格式错误  
• `500 Internal Server Error` → 下游暂时性故障

11. Agent 信任评分列表工具

ID： agents_trust_score_list

描述： ChainAware Agent 信任评分是一个 0-1000 的分数，用于衡量与任何已在 ERC-8004 注册的 AI Agent 交互是否安全。与基于投票的声誉系统不同——在这类系统中，Agent 可以互相点赞来人为制造信任——Agent 信任评分完全基于链上的行为历史得出。它无法在几小时内获得，也无法通过一群新钱包伪造。它反映的是控制该 Agent 的个人或实体在现实世界中的真实记录。随着 Agent 商业规模不断扩大，AI Agent 开始代表消费者在 ChatGPT、Google Gemini 和 Shopify 上自主完成购买，哪些 Agent 值得信任并可进行交易已不再是理论问题。ChainAware 以链上证据而非同行背书来回答这个问题。它会返回 Agent 列表及其结果。

➡️ 示例用例： – 给我一份包含 Agent 及其信任评分的列表？ – “2025-01-01 之后注册的最佳 Agent 是哪个？”

输入：

名称	类型	必填	描述
`page`	string	✅	分页时的页码（page）
`limit`	string	✅	分页时要获取的条目数
`sort_by`	string	X	根据指定字段对返回的 Agent 排序，例如：'registered_at'
`sort_order`	string	X	但若按 `sort_by` 排序则必填，可选 'asc' 或 'desc'（默认 desc）
`registered_after`	string	X	根据 Agent 注册时的日期时间进行筛选

输出（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. Agents Trust Score Single Tool

ID: agents_trust_score_single

描述： 与 Agent Trust List 类似，Agent Trust Score Single 是一个 0-1000 的分数，用于衡量与任何已注册到 ERC-8004 的 AI Agent 交互是否安全。与基于投票的信誉系统不同——在这类系统中，Agent 可以互相投赞成票来人为制造信任——Agent Trust Score 完全根据链上行为历史得出。它无法在几小时内获得，也无法通过一批新建钱包伪造。它反映了控制该 Agent 的个人或实体在现实世界中的实际记录。随着 Agent 经济规模不断扩大，AI Agent 开始通过 ChatGPT、Google Gemini 和 Shopify 代表消费者自主完成购买，哪些 Agent 值得信赖、可以进行交易，已不再是一个纯理论问题。ChainAware 通过链上证据而非同行背书来解答这个问题。它会深入返回所请求 Agent 的详细信息。

➡️ 示例用例： – “这个 agent id 12314 在 chain_id 56 上的信任分数是多少？”

输入：

名称	类型	必填	描述
`agent_id`	integer	✅	从 agents_trust_score_list 工具返回的 Agent id
`chain_id`	integer	✅	Agent 部署／注册所在的链 id，之前从 agents_trust_score_list 工具获取

输出（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。如果上下文中没有这两个值，请勿调用此工具。

➡️ 示例用例：

• 使用此签名 260866090d88bf61bdfb54f0533fe876bfd8ded7339691c50ada9de59a48124a 查询作业 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”时才调用。返回已完成的钱包地址列表及其共用的链／网络—— 使用这些信息向主后端查询实际的钱包分析数据。此工具不会直接返回钱包数据，只会返回获取数据所需的地址列表。调用此工具必须同时提供 job_id 和 signature，二者均由 schedule_calculation 返回。如果上下文中没有这两个值，绝不要调用此工具。

➡️ 使用示例：

• 使用此签名 260866090d88bf61bdfb54f0533fe876bfd8ded7339691c50ada9de59a48124a，作业 ID 为 0fc5897a-ad64-4f21-88b5-1274d1cfec46 的结果是什么？

输入：

名称	类型	必填	描述
`job_id`	string	✅	计划计算返回的作业 ID（predictive_fraud_batch 或 predictive_behaviour_batch）
`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 specification
🚦 可能会根据使用层级限制速率
🔑 生产环境端点需要 API key
💳 支持 x402 付款——可通过 x402 protocol 按次付费，无需订阅 API key；兼容 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 Connector 配置

适用于支持 Connectors / MCP 的 ChatGPT 环境（Developer Mode）。

步骤

打开 ChatGPT 设置
前往 Apps / Connectors
点击 Add Connector
输入下方的集成名称和 URL
保存配置

集成详情

名称

ChainAware Behavioural Prediction MCP Server

集成 URL

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

Claude Web 和 Claude Desktop 配置

步骤

打开 Claude Web 或 Claude Desktop
前往 设置 → 集成
点击 添加集成
输入下方的名称和 URL
点击添加完成设置

集成详情

名称

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 子 Agent

此仓库在 .claude/agents/ 中包含 34 个开箱即用的 Claude Code 子 Agent，可直接处理常见的 Web3 情报任务。

Agent	用途
`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`	将钱包划分为不同鲸鱼等级（巨鲸 / 鲸鱼 / 新兴）
`chainaware-defi-advisor`	根据经验和风险等级提供个性化 DeFi 产品推荐
`chainaware-airdrop-screener`	批量筛查钱包的空投资格，过滤机器人 / 欺诈行为
`chainaware-lending-risk-assessor`	借款人风险等级（A–F）、抵押率、利率等级
`chainaware-token-launch-auditor`	上市前发行安全审计——批准 / 有条件批准 / 拒绝
`chainaware-agent-screener`	通过 Agent + 关联钱包检查，对 AI Agent 进行 0–10 信任评分
`chainaware-cohort-analyzer`	将一批钱包划分为不同的行为群组，并为每个群组制定互动策略
`chainaware-counterparty-screener`	在交易、转账或合约交互前，实时给出是否允许的判定（安全 / 谨慎 / 拦截）
`chainaware-governance-screener`	DAO 投票者筛查——Sybil 检测、治理等级和投票权重乘数（支持代币权重、声誉权重和二次方模型）
`chainaware-sybil-detector`	DAO 投票的批量 Sybil 攻击检测——将投票者分类为符合资格 / 需审核 / 排除，检测协同欺诈模式（钱包农场、新钱包激增），并生成声誉加权的投票乘数
`chainaware-transaction-monitor`	面向自主 Agent 的实时交易风险评分——综合评分（0–100）和流水线操作（允许 / 标记 / 暂缓 / 拦截）
`chainaware-lead-scorer`	销售线索资格评估——线索评分（0–100）、等级（热门 / 温热 / 冷淡 / 无效）、转化概率和建议的外联角度
`chainaware-upsell-advisor`	为现有用户规划增购路径——升级准备度评分、下一款产品推荐、触发事件和可直接使用的增购消息
`chainaware-platform-greeter`	针对特定平台上特定钱包的情境化欢迎消息——同一钱包在 Aave、1inch 和 OpenSea 上会收到不同消息
`chainaware-marketing-director`	全周期营销活动编排器——细分受众、评估线索、检测鲸鱼、制定各群组的消息策略、发现增购机会并引导新钱包
`chainaware-compliance-screener`	第一层 MiCA 合规筛查——编排 fraud-detector、aml-scorer、transaction-monitor 和 counterparty-screener，生成包含判定结果（通过 / 加强尽职调查 / 拒绝）的合规报告
`chainaware-gamefi-screener`	Web3 游戏和 P2E 钱包筛查——检测机器人农场、作弊者和刷取钱包；将合规玩家划分为不同经验等级以用于匹配；输出 P2E 奖励资格
`chainaware-portfolio-risk-advisor`	投资组合层面的 Rug Pull 和社区健康评估——扫描每种代币，生成加权投资组合风险评分、等级（A–F）、集中度标记和优先级再平衡计划
`chainaware-rwa-investor-screener`	RWA 投资者适格性筛查——根据 RWA 等级评估欺诈风险、经验和风险画像匹配度；返回合格 / 有条件通过 / 转交 KYC / 不合格及投资上限
`chainaware-agent-trust-screener`	ERC-8004 AI Agent 信任筛查——列出并按 0–1000 信任评分对已注册 Agent 排名，返回信任等级和标记，并对未经验证的钱包发出强警告
`chainaware-token-audit-analyst`	深度多模块代币合约审计——所有权、流动性、供应量 / 铸造、蜜罐检测、重入；异步流水线，提供 0–100 风险评分和各模块明细

设置

步骤 1 — 连接 MCP 服务

Agent 通过 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 — 复制 Agent 文件

克隆此仓库并将 Agent 复制到你的项目中：

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

或者只挑选你需要的 Agent：

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 获取密钥。

重要说明

每个 Agent 的 frontmatter 中的 tools: 行都引用了已注册名称的 MCP 服务。如果你使用其他名称注册服务，请相应更新 tools: 行。
Agent 会在 frontmatter 中指定 model:（claude-haiku-4-5-20251001 或 claude-sonnet-4-6）。你需要有权使用这些模型。
references/ 文件夹包含详细的工具文档，可为 Agent 提供更丰富的上下文。建议将其与 Agent 一同复制，但并非必须。

🔐 安全说明

不要在公开仓库中硬编码 API 密钥
如果支持，请优先使用环境变量或密钥管理器
在生产环境中定期轮换密钥

🔒 访问策略

MCP 服务支持两种访问方式：

API 密钥 — 订阅 https://chainaware.ai/pricing 上的套餐，并通过 X-API-Key 标头传递密钥
x402 支付 — 使用任何兼容 x402 的 MCP 客户端，即可按次付费访问，无需订阅；服务端会返回带有支付详情的 HTTP 402 响应，客户端会自动完成结算

📖 延伸阅读

媒体报道与认可

CB Insights AI 时代欺诈防范市场图谱 — ChainAware 被列为 Web3 领域 AI 时代领先的欺诈防范解决方案（2026）
BNB Chain AI 生态图谱 — BNB Chain 将 ChainAware 列为生态中的重要 AI 项目（2025）
BNB Chain Kickstart — 营销工具 — Growth Agents 和 Wallet Marketer 入选 BNB Chain 的 Kickstart 计划（2025）
Google Cloud 25 万美元资助 — ChainAware 获选接受 Google Cloud 的 250,000 美元资助（2025）
AWS 金融科技加速器 — ChainAware 入选 AWS 金融科技加速器计划（2024）
Safary Club Web3 增长图谱 — 增长工具 — ChainAware 入选 Web3 项目增长工具（2024）

产品概览

ChainAware 完整产品指南 — 所有工具、网络和覆盖范围概览
Web3 商业潜力 — Web3 情报的商业价值与市场机遇
将 ChainAware 用于商业用途 — 如何基于 ChainAware 构建商业产品和服务

工具专项指南

欺诈检测器指南 — 如何使用 predictive_fraud：输入、输出、阈值和使用场景
Rug Pull 检测器指南 — 如何使用 predictive_rug_pull：合约评分、部署者风险和 LP 分析
代币排名指南 — 如何使用 token_rank_list 和 token_rank_single：社区实力评分
钱包排名指南 — 钱包排名系统：经验等级、全球排名和积分
钱包审计器指南 — 结合多种工具的完整钱包审计工作流
交易监控指南 — 实时交易风险监控模式
Web3 行为用户分析指南 — 使用 predictive_behaviour 进行用户分析和细分
信用评分指南 — Web3 信用评分方法及其在 DeFi 借贷中的应用
信用评分 Agent 指南 — 如何构建和使用 ChainAware 信用评分 Agent
Agent 商务信任评分 — 对 274k 多个已注册 Agent 进行 ERC-8004 筛查：信任等级、全体 Agent 欺诈检测，以及使用 agents_trust_score_list / agents_trust_score_single 实现 DeFi 访问控制
代币审计：10,000 个 CoinGecko 代币结果 — 真实世界研究：55% 的热门代币被判定为高风险；通过 run_token_audit 执行 127 项自动化安全检查

分析与策略

面向 DApp 增长的 Web3 用户细分与行为分析 — DApp 留存与增长的细分策略
AI 驱动的区块链分析：用于加密安全的机器学习 — 面向链上安全和欺诈检测的 ML 方法
取证加密分析与 AI 加密分析 — 对比传统取证工具与 ChainAware 的预测式 AI 方法
MiCA 合规 DeFi 筛选器 — ChainAware 如何覆盖约 70–75% 的 DeFi MiCA 义务；合规筛选器与 Chainalysis / Elliptic 的定位对比
2026 年 Web3 增长平台对比 — 三阶段漏斗框架；ChainAware 专注于第 3 阶段（连接后、DApp 内个性化）
2026 年 DApp Web3 分析工具对比 — 按四类工作任务梳理 10 个分析平台；ChainAware 是唯一的预测智能平台
为什么个性化是 AI Agent 的下一个重要趋势 — Web3 钱包级个性化的价值

开发者集成

任何 AI Agent 都能使用的 12 项区块链功能——MCP 集成指南 — 介绍所有功能，并提供 Claude、ChatGPT、Cursor 和多 Agent 系统的设置说明
面向 AI Agent 的 Prediction MCP：根据钱包行为个性化决策 — 深入的集成指南，附带代码示例
Prediction MCP 将大幅提升 DeFi 平台性能的 5 种方式 — 借贷、DEX、启动平台、治理和个性化用例
2026 年 DeFi 用户引导：为何 90% 的已连接钱包从未进行交易，以及 AI Agent 如何解决这一问题 — 用户引导转化问题及 AI 驱动的解决方案
Web3 Agent 经济：AI Agent 如何在 DeFi 中取代人工团队 — 自主 AI Agent 如何接管 DeFi 运营与决策

🧾 许可证

MIT（适用于客户端示例）。服务端实现和后端逻辑为专有内容，且保持私有。

资源和第三方

🏆 荣誉

ChainAware 入选了 CB Insights AI 时代欺诈防范市场图谱，被列为 AI 时代领先的 AI 驱动欺诈防范解决方案（2026）。

ChainAware 入选了 BNB Chain AI 生态图谱，获 BNB Chain 认可为生态系统中的关键 AI 项目（2025）。

ChainAware 入选了 BNB Chain Kickstart — 营销工具，Growth Agents 和 Wallet Marketer 获选加入 BNB Chain 官方 Kickstart 计划（2025）。

ChainAware 获得了 25 万美元 Google Cloud 资助，由 Google Cloud 选中，用于基础设施和 AI 开发（2025）。

ChainAware 获准加入 AWS 金融科技加速器，由 AWS 选中加入其金融科技加速器计划（2024）。

ChainAware 入选了 Safary Club Web3 增长生态图谱 — 增长工具，列入 Web3 项目增长工具类别（2024）。

支持 Markdown

登录后评论

基本信息

作者: ChainAware
版本: 1.0.0
传输方式: sse
收录时间: 2025年10月31日
最近更新: 11 周前
官方 Registry: io.github.ChainAware/chainaware-behavioral-prediction-mcp

报告问题

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。

Behavioural Prediction Mcp

关于 Behavioural Prediction Mcp

主要功能

适用场景

MCP 相关

配置

工具

详细介绍

🧠 ChainAware 行为预测 MCP 服务

📖 描述

⚙️ 可用工具

1. 欺诈预测检测工具

2. 批量欺诈预测检测工具

3. 预测行为分析工具

4. 批量预测行为分析工具

5. 预测性跑路检测工具

6. 信用评分工具

7. Token Rank 列表工具

8. Token Rank 单个代币工具

9. 运行代币审计工具

10. 获取代币审计结果工具

11. Agent 信任评分列表工具

12. Agents Trust Score Single Tool

13. 检查批处理作业状态

14. 获取批处理作业结果

🧠 客户端使用示例

Node.js 示例

Python 示例

🔌 集成说明

Claude Code（CLI）配置

ChatGPT Connector 配置

步骤

集成详情

Claude Web 和 Claude Desktop 配置

步骤

集成详情

Cursor 配置

🤖 Claude Code 子 Agent

设置

重要说明

🔐 安全说明

🔒 访问策略

📖 延伸阅读

媒体报道与认可

产品概览

工具专项指南

分析与策略

开发者集成

🧾 许可证

资源和第三方

🏆 荣誉

评论

第一次接触 MCP？

MCP（Model Context Protocol）是什么？

MCP 服务和客户端有什么区别？

本地服务与远程服务怎么选？

如何在 Claude、Cursor 等客户端中安装服务？

收录的项目经过审核吗？“认证”标识代表什么？

我维护的项目已被收录，怎样认领？