• Is it safe to intercant with vitalik.eth ?
• What is the fraudulent status of this address ?
• Is my new wallet at risk of being used for fraud?  

{
  "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
    }
  ]
}

• `403 Unauthorized` → invalid `apiKey`  
• `400 Bad Request` → malformed `network` or `walletAddress`  
• `500 Internal Server Error` → temporary downstream failure  

Use this when you need:

  • Next‑best‑action predictions and intentions(“Will this address deposit, trade, or stake?”)  
  • A risk‑tolerance and experience profile  
  • Category segmentation (e.g. NFT, DeFi, Bridge usage)  
  • Custom recommendations based on historical patterns

• “What will this address do next?”  
• “Is the user high‑risk or experienced?”  
• “Recommend the best DeFi strategies for 0x1234... on ETH network.”

{
      "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"
        }
      ]
    }
    

• `403 Unauthorized` → invalid `apiKey`  
• `400 Bad Request` → malformed `network` or `walletAddress`  
• `500 Internal Server Error` → temporary downstream failure  

• “Will this new DeFi pool rug‑pull if I stake my assets?”  
• “Monitor my LP position for potential future exploits.”  

{
      "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
    }

• `403 Unauthorized` → invalid `apiKey`  
• `400 Bad Request` → malformed `network` or `walletAddress`  
• `500 Internal Server Error` → temporary downstream failure  

• "What is the credit score for this wallet?"
• "What's the calculated trust score for this borrower?"
• "Calculate credit score before approving this loan."

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

• `401 Unauthorized` → invalid `apiKey`
• `400 Bad Request` → malformed `network` or `walletAddress`
• `500 Internal Server Error` → temporary downstream failure

  {
    "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` → malformed `network` or `walletAddress`  
• `500 Internal Server Error` → temporary downstream failure  

 {
      "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` → malformed `network` or `walletAddress`  
• `500 Internal Server Error` → temporary downstream failure  

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);

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"
        }
      }
    }
  }
}

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

ChainAware Behavioural Prediction MCP Server

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

ChainAware Behavioural Prediction MCP Server

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

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