Behavioural Prediction MCP

The Behavioural Prediction MCP Server provides AI-powered tools to analyze wallet behaviour prediction,fraud detection and rug pull prediction.

GitHub

🧠 ChainAware Behavioural Prediction MCP Server

MCP Server Name: ChainAware Behavioural Prediction MCP

Category: Web3 / Security / DeFi Analytics

Status: Public tools – Private backend

Access: By request (API key)

Server URL: [https://prediction.mcp.chainaware.ai/sse]

Repository: [https://github.com/ChainAware/behavioral-prediction-mcp]

Website: [https://chainaware.ai/]

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

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

📖 Description

The Behavioural Prediction MCP Server provides AI-powered tools to analyze wallet behaviour prediction,fraud detection and rug pull prediction.

Developers and platforms can integrate these tools through the MCP protocol to safeguard DeFi users, monitor liquidity risks, and score wallet or contract trustworthiness.

All tools follow the Model Context Protocol (MCP) and can be consumed via MCP-compatible clients.

⚙️ Available Tools

1. Predictive Fraud Detection Tool

ID: predictive_fraud

Description: This AI‑powered algorithm forecasts the likelihood of fraudulent activity on a given wallet address before it happens (≈98% accuracy), and performs AML/Anti‑Money‑Laundering checks. Use this when your user wants a risk assessment or early‑warning on a blockchain address.

➡️ Example Use Cases:

• 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?

Inputs:

NameTypeRequiredDescription
apiKeystring✅API key for authentication
networkstring✅Blockchain network (ETH, BNB,POLYGON,TON,BASE, TRON, HAQQ)
walletAddressstring✅The wallet address to evaluate

Outputs (JSON):

{
    "message": "string",              // Human‑readable status message
    "walletAddress": "string",        // hex address 
    "status": "Fraud",                // Fraudelent status (Fraud,Not Fraud,New Address)
    "probabilityFraud": "0.00–1.00",  // Decimal probability
    "token": "string",                //
    "lastChecked": "ISO‑8601 timestamp",
    "forensic_details": {             // Deep forensic breakdown
    /* ...other metrics... */
    },
    "createdAt": "ISO‑8601 timestamp", 
    "updatedAt": "ISO‑8601 timestamp"
}

Error cases:

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

2. Predictive Behaviour Analysis Tool

ID: predictive_behaviour

Description: This AI‑driven engine projects what a wallet address intentions or what address is likely to do next, profiles its past on‑chain history, and recommends personalized actions.

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

➡️ Example Use Cases:

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

Inputs:

NameTypeRequiredDescription
apiKeystring✅API key for authentication
networkstring✅Blockchain network (ETH, BNB,BASE,HAQQ,SOLANA)
walletAddressstring✅The wallet address to evaluate

Outputs (JSON):

{
    "message":           "string",                    // e.g. “Success” or error text  
    "walletAddress":     "string",                    // echoed input  
    "status":            "string",                    // Fraudelent status (Fraud,Not Fraud,New Address)  
    "probabilityFraud":  "0.00–1.00",                 // decimal fraud score  
    "lastChecked":       "ISO‑8601 timestamp",        // e.g. “2025‑01‑03T16:19:13.000Z”  
    "forensic_details":  { /* dict of forensic metrics */ },  
    "categories":        [ { "Category":"string", "Count":int }, … ],  
    "riskProfile":       [ { "Category":"string", "Balance_age":float }, … ],  
    "segmentInfo":       "JSON‑string of segment counts",  
    "experience":        { "Type":"Experience", "Value":int },  
    "intention":         {                              
    "Type":"Intentions",  
    "Value": { "Prob_Trade":"High", "Prob_Stake":"Medium", … }  
    },  
    "protocols":         [ { "Protocol":"string","Count":int }, … ],  
    "recommendation":    { "Type":"Recommendation", "Value":[ "string", … ] },  
    "createdAt":         "ISO‑8601 timestamp",  
    "updatedAt":         "ISO‑8601 timestamp"  
}

Error cases:

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

3. Predictive Rug‑Pull Detection Tool

ID: predictive_rug_pull

Description: This AI‑powered engine forecasts which liquidity pools or contracts are likely to perform a “rug pull” in the future. Use this when you need to warn users before they deposit into risky pools or to monitor smart‑contract security on-chain.

➡️ Example Use Cases:

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

Inputs:

NameTypeRequiredDescription
apiKeystring✅API key for authentication
networkstring✅Blockchain network (ETH, BNB, BASE, HAQQ)
walletAddressstring✅Smart contract or liquidity pool address

Outputs (JSON):

{
  "message": "Success",
  "contractAddress": "0x1234...",
  "status": "Fraud",
  "probabilityFraud": 0.87,
  "lastChecked": "2025-10-25T12:45:00Z",
  "forensic_details": { /* dict of on‑chain metrics */ }, 
  "createdAt": "2025-10-25T12:45:00Z",
  "updatedAt": "2025-10-25T12:45:00Z"
}

Error cases:

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

4. Token Rank List Tool

ID: token_rank_list

Description: TokenRank analyzes the community of token holders and ranks every token by the strength of its holders. The stronger the token holders, the stronger the token! Use this when you need to know token rank of a token or tokens or compare between different categories and chains. You can use search,filter and sort and pagination which returns a list of tokens.

➡️ Example Use Cases: – “Which is the best token on AI Token category?”
– “Compare x token in ETH chain and BNB chain?”

Inputs:

NameTypeRequiredDescription
limitstring✅Number of items ot fetch during pagination
offsetstring✅Page number(offset) during pagination
networkstringBlockchain network to filter (ETH, BNB, BASE, SOLANA)
sort_bystringSort the returnet tokens based on (e.g.: 'communityRank')
sort_orderstring'ASC' or 'DESC' sorting the value of sort_by
categorystringFilter based on category of the token (e.g. 'AI Token','RWA Token','DeFi Token','DeFAI Token','DePIN Token')
contract_namestringSearch based on contract name

Outputs (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
        }
      ]
    }
  }

Error cases:

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

5. Token Rank Single Tool

ID: token_rank_single

Description: Similar to TokenRank List,Token Rank analyzes the community of token holders and ranks every token by the strength of its holders. Except the token rank and token details the token rank single tool fetches the best holders their details and its globalRank alongside others in same network. Use this when you need to know token rank of a single token based on contract address and exeact chain or network or when you need best holders of specific token in specifc network or chain

➡️ Example Use Cases: – “What is the token rank for token in ETH network?”
– "Which are the best holders of this contract token address?” – “What is the token rank and its best holders?”

Inputs:

NameTypeRequiredDescription
contract_addressstring✅The contract address of the token to evaluate
networkstring✅Blockchain network to filter (ETH, BNB, BASE, SOLANA)

Outputs (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
            }
          }
        ]
      }
    }

Error cases:

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

🧠 Example Client Usage

Node.js Example

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 Example

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)

Service Configuration:

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

🔌 Integration Notes

  • ✅ Compatible with MCP clients across Node.js, Python, and browser-based environments
  • 🔁 Uses Server-Sent Events (SSE) for streaming / real-time responses
  • 📐 JSON schemas conform to the MCP specification
  • 🚦 Rate limits may apply depending on usage tier
  • 🔑 API key required for production endpoints

Claude Code (CLI) Configuration

Use the Claude CLI to register the MCP server via SSE transport:

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

📚 Documentation: https://code.claude.com/docs/en/mcp

ChatGPT Connector Configuration

Available in ChatGPT environments that support Connectors / MCP (Developer Mode).

Steps

  1. Open ChatGPT Settings
  2. Navigate to Apps / Connectors
  3. Click Add Connector
  4. Enter the integration name and URL below
  5. Save the configuration

Integration Details

Name

ChainAware Behavioural Prediction MCP Server

Integration URL

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

Claude Web & Claude Desktop Configuration

Steps

  1. Open Claude Web or Claude Desktop
  2. Go to Settings → Integrations
  3. Click Add integration
  4. Enter the name and URL below
  5. Click Add to complete setup

Integration Details

Name

ChainAware Behavioural Prediction MCP Server

Integration URL

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

📚 Documentation: https://platform.claude.com/docs/en/agents-and-tools/remote-mcp-servers

Cursor Configuration

Add the MCP server to your Cursor configuration file (e.g. mcp.json):

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

📚 Documentation: https://cursor.com/docs/context/mcp

🤖 Claude Code Subagents

This repository includes 29 ready-to-use Claude Code subagents in .claude/agents/ — specialist agents that handle common Web3 intelligence tasks out of the box.

AgentPurpose
chainaware-wallet-auditorFull due diligence — fraud + behavior + rug pull
chainaware-fraud-detectorFast wallet fraud screening
chainaware-rug-pull-detectorSmart contract / LP safety checks
chainaware-trust-scorerTrust score (0.00–1.00)
chainaware-reputation-scorerReputation score (0–4000)
chainaware-aml-scorerAML compliance scoring (0–100)
chainaware-wallet-rankerWallet experience rank + leaderboard
chainaware-wallet-marketerPersonalized marketing messages
chainaware-token-rankerDiscover/rank tokens by holder community strength
chainaware-token-analyzerSingle token deep-dive + top holders
chainaware-onboarding-routerRoute wallets to beginner/intermediate/skip onboarding
chainaware-whale-detectorClassify wallets into whale tiers (Mega/Whale/Emerging)
chainaware-defi-advisorPersonalized DeFi product recommendations by experience + risk tier
chainaware-airdrop-screenerBatch screen wallets for airdrop eligibility, filter bots/fraud
chainaware-lending-risk-assessorBorrower risk grade (A–F), collateral ratio, interest rate tier
chainaware-token-launch-auditorPre-listing launch safety audit — APPROVED/CONDITIONAL/REJECTED
chainaware-agent-screenerAI agent trust score 0–10 via agent + feeder wallet checks
chainaware-cohort-analyzerSegment a batch of wallets into behavioral cohorts with per-cohort engagement strategies
chainaware-counterparty-screenerReal-time pre-transaction go/no-go verdict (Safe / Caution / Block) before a trade, transfer, or contract interaction
chainaware-governance-screenerDAO voter screening — Sybil detection, governance tier, and voting weight multiplier (supports token-weighted, reputation-weighted, and quadratic models)
chainaware-transaction-monitorReal-time transaction risk scoring for autonomous agents — composite score (0–100) and pipeline action (ALLOW / FLAG / HOLD / BLOCK)
chainaware-lead-scorerSales lead qualification — lead score (0–100), tier (Hot/Warm/Cold/Dead), conversion probability, and recommended outreach angle
chainaware-upsell-advisorUpsell path for existing users — upgrade readiness score, next product recommendation, trigger event, and ready-to-use upsell message
chainaware-platform-greeterContextual welcome message for a specific wallet on a specific platform — same wallet gets a different message on Aave vs 1inch vs OpenSea
chainaware-marketing-directorFull-cycle campaign orchestrator — segments audience, scores leads, detects whales, builds per-cohort message playbook, surfaces upsell opportunities, and routes new wallets
chainaware-compliance-screenerFirst-layer MiCA-aligned compliance screening — orchestrates fraud-detector, aml-scorer, transaction-monitor, and counterparty-screener into a Compliance Report with verdict (PASS / EDD / REJECT)
chainaware-gamefi-screenerWeb3 game and P2E wallet screening — detects bot farms, cheaters, and farm wallets; classifies legitimate players into experience tiers for matchmaking; outputs P2E reward eligibility
chainaware-portfolio-risk-advisorPortfolio-level rug pull and community health assessment — scans every token, produces weighted Portfolio Risk Score, grade (A–F), concentration flags, and prioritized rebalancing plan
chainaware-rwa-investor-screenerRWA investor suitability screening — assesses fraud risk, experience, and risk profile alignment against the RWA tier; returns QUALIFIED / CONDITIONAL / REFER_TO_KYC / DISQUALIFIED with investment cap

Setup

Step 1 — Connect the MCP server

The agents call ChainAware tools via MCP. Register the server first:

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

For Cursor / Windsurf, add to mcp.json:

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

Step 2 — Copy the agent files

Clone this repo and copy the agents into your project:

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

Or cherry-pick only the agents you need:

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

Step 3 — Set the API key

export CHAINAWARE_API_KEY="your-key-here"

Get a key at https://chainaware.ai/pricing

Important Notes

  • The tools: line in each agent's frontmatter references the MCP server by its registered name. If you register the server under a different name, update the tools: lines to match.
  • Agents specify a model: in their frontmatter (claude-haiku-4-5-20251001 or claude-sonnet-4-6). You need access to those models.
  • The references/ folder contains detailed tool documentation that gives agents richer context. Copying it alongside the agents is recommended but optional.

🔐 Security Notes

  • Do not hard-code API keys in public repositories
  • Prefer environment variables or secret managers when supported
  • Rotate keys regularly in production environments

🔒 Access Policy

The MCP server requires an API key for production usage. To request access:

📖 Further Reading

Product Overviews

Tool-Specific Guides

Analytics & Strategy

Developer Integration

🧾 License

MIT (for client examples). Server implementation and backend logic are proprietary and remain private.

Related Servers