ChainAware Behavioral Prediction MCP
name: chainaware-behavioral-prediction
by chainaware · published 2026-03-22
$ claw add gh:chainaware/chainaware-chainaware-behavioral-prediction---
name: chainaware-behavioral-prediction
license: MIT
description: "Use this skill whenever a user asks about wallet safety, fraud risk, rug pull detection, wallet behavior analysis, DeFi personalization, on-chain reputation scoring, AML checks, token ranking by holder quality, airdrop screening, lending risk, token launch auditing, or AI agent trust scoring. Triggers on questions like: is this wallet safe?, will this pool rug pull?, what will this address do next?, score this wallet, detect fraud for address, personalize my DeFi agent, rank this token, top AI tokens, best holders of this token, check this contract, is this token safe?, profile this wallet, KYC this address, pre-screen this user, AML check this wallet, is this address suspicious?, screen this wallet before onboarding, what is the risk score of this address?, analyze on-chain behavior, is this LP safe to deposit?, will this contract rug?, what DeFi products suit this wallet?, segment this user, what is this wallet's experience level?, find strong token holders, which token has the best community?, rank tokens by holder quality, should we list this token?, audit this launch, is this deployer trustworthy?, vet this IDO, launch safety check, screen this airdrop list, filter bots from airdrop, rank these wallets for token distribution, fair airdrop allocation, assess this borrower, what collateral ratio for this wallet?, lending risk for 0x..., what interest rate for this borrower?, should I lend to this wallet?, screen this AI agent, is this agent wallet safe?, agent trust score for 0x..., check the feeder wallet for this agent, can I trust this agent?, route this wallet to onboarding, is this user a beginner?, skip onboarding for this wallet?, or any request to analyze a blockchain wallet address, smart contract, token, or AI agent for risk, behavior, intent, community strength, or trustworthiness. Also use when integrating the ChainAware MCP server into Claude Code, Cursor, ChatGPT, or any MCP-compatible AI agent framework.
metadata:
openclaw:
requires:
env:
- CHAINAWARE_API_KEY
primaryEnv: CHAINAWARE_API_KEY
env_usage:
CHAINAWARE_API_KEY: "Passed as the `apiKey` parameter in every tool call (predictive_fraud, predictive_behaviour, predictive_rug_pull).Never logged or included in output. Sourced exclusively from the CHAINAWARE_API_KEY environment variable — never hardcoded."
data_handling:
external_endpoints:
- url: https://prediction.mcp.chainaware.ai/sse
transport: SSE
purpose: Blockchain wallet and contract behavioural analysis
data_sent:
- Wallet addresses (pseudonymous on-chain identifiers)
- Smart contract / LP addresses
- Network identifier (e.g. ETH, BNB, BASE)
data_NOT_sent:
- Names, emails, or any off-chain PII
- Raw transaction data
- Private keys or seed phrases
retention: Governed by ChainAware's privacy policy
privacy_policy: https://chainaware.ai/privacy
emoji: 🔮
homepage: https://github.com/ChainAware/behavioral-prediction-mcp
author: ChainAware
tags:
- web3
- blockchain
- fraud-detection
- rug-pull
- wallet-analytics
- defi
- mcp
- ai-agents
- personalization
- aml
- token-rank
- on-chain-intelligence
---
# ChainAware Behavioral Prediction MCP
What This Skill Does
The **ChainAware Behavioral Prediction MCP** connects any AI agent to a continuously updated
Web3 behavioral intelligence layer: **14M+ wallet profiles** across **8 blockchains**, built from
**1.3 billion+ predictive data points**. It delivers five capabilities via a single MCP endpoint:
1. **Fraud Detection** — predict fraudulent wallet behavior before it happens (~98% accuracy on ETH)
2. **Behavioral Analysis** — profile wallet intent, risk tolerance, experience, and next likely actions
3. **Rug Pull Detection** — forecast whether a smart contract or liquidity pool will rug pull
4. **Token Rank List** — rank tokens by holder community strength across chains and categories
5. **Token Rank Single** — deep-dive into a single token's community quality and top holders
Unlike forensic blockchain tools that describe the past, this MCP is **predictive** — it tells your
agent what is *about to happen*.
**MCP Server URL:** `https://prediction.mcp.chainaware.ai/sse`
**GitHub:** https://github.com/ChainAware/behavioral-prediction-mcp
**Website:** https://chainaware.ai
**Pricing / API Key:** https://chainaware.ai/pricing
---
When to Use This Skill
When NOT to Use This Skill
---
Supported Blockchains
| Tool | Networks |
|---|---|
| Fraud Detection | ETH, BNB, POLYGON, TON, BASE, TRON, HAQQ |
| Behavioral Analysis | ETH, BNB, BASE, HAQQ, SOLANA |
| Rug Pull Detection | ETH, BNB, BASE, HAQQ |
| Token Rank List | ETH, BNB, BASE, SOLANA |
| Token Rank Single | ETH, BNB, BASE, SOLANA |
---
Step-by-Step Workflow
For wallet fraud screening
1. **Confirm inputs** — wallet address and network. If network is missing, ask.
2. **Call `predictive_fraud`** with the wallet address and network.
3. **Interpret `probabilityFraud`** using the threshold table below.
4. **Scan `forensic_details`** for negative flags (mixer use, sanctioned entities, darknet, etc.).
5. **Report** status, score, and any forensic flags in plain language.
For behavioral profiling / personalization
1. **Confirm inputs** — wallet address and network.
2. **Call `predictive_behaviour`** with the wallet address and network.
3. **Extract key signals**: `intention.Value` (Prob_Trade/Stake/Bridge/NFT_Buy), `experience.Value`, `categories`, `recommendation`.
4. **Classify the wallet** by dominant category and intent signal.
5. **Generate** personalized recommendations or next-best-action based on the profile.
For rug pull / contract safety checks
1. **Confirm inputs** — smart contract or LP address and network.
2. **Optionally call `predictive_fraud`** on the *deployer* address first for extra signal.
3. **Call `predictive_rug_pull`** with the contract address.
4. **Interpret `probabilityFraud`** and scan `forensic_details` for liquidity and contract risk flags.
5. **Apply the Deployer Risk Amplifier**: if deployer fraud score ≥ 0.5, escalate overall risk one level.
6. **Report** verdict with supporting forensic evidence.
For token ranking / discovery
1. **Identify the request** — list of tokens or single token deep-dive?
2. **For lists**: call `token_rank_list` with appropriate `category`, `network`, `sort_by: communityRank`, `sort_order: DESC`.
3. **For single tokens**: call `token_rank_single` with `contract_address` and `network`.
4. **Report** `communityRank`, `normalizedRank`, `totalHolders`, and top holder profiles.
For full due diligence (multi-tool)
1. Call `predictive_fraud` → get fraud score and forensic flags
2. Call `predictive_behaviour` → get behavioral profile and intent
3. Call `predictive_rug_pull` (if a contract address) → get contract risk
4. Synthesize all three into a unified verdict with risk level and recommendation
> For complex due diligence workflows, escalate to the `chainaware-wallet-auditor` subagent.
---
Risk Score Thresholds
| Score Range | Label | Recommended Action |
|---|---|---|
| 0.00 – 0.20 | 🟢 Low Risk | Safe to proceed |
| 0.21 – 0.50 | 🟡 Medium Risk | Proceed with caution, monitor |
| 0.51 – 0.80 | 🔴 High Risk | Block or require additional verification |
| 0.81 – 1.00 | ⛔ Critical Risk | Reject immediately |
---
Available Tools
1. `predictive_fraud` — Fraud Detection
Forecasts the probability that a wallet will engage in fraudulent activity. Includes AML checks.
Use when a user wants to screen a wallet before interacting with it.
**Inputs:**
**Key output fields:**
**Example prompts that trigger this tool:**
---
2. `predictive_behaviour` — Behavioral Analysis & Personalization
Profiles a wallet's on-chain history and predicts its next actions.
**Inputs:**
**Key output fields:**
**Example prompts that trigger this tool:**
---
3. `predictive_rug_pull` — Rug Pull Detection
Forecasts whether a smart contract or liquidity pool is likely to execute a rug pull.
**Inputs:**
**Key output fields:**
**Example prompts that trigger this tool:**
---
4. `token_rank_list` — Token Ranking by Holder Strength
Ranks tokens by the quality and strength of their holder community.
**Inputs:**
**Key output fields:**
**Example prompts that trigger this tool:**
---
5. `token_rank_single` — Single Token Rank & Top Holders
Returns the rank and top holders for a specific token by contract address.
**Inputs:**
**Key output fields:**
**Example prompts that trigger this tool:**
---
Validation Checkpoints
Input Validation
Output Validation
---
Example Output
Fraud Check — 0xABC... on ETH
🔮 FRAUD ASSESSMENT
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Wallet: 0xABC...
Network: ETH
Status: 🟡 MEDIUM RISK
Fraud Probability: 0.34
Risk Level: Medium — proceed with caution
Forensic Highlights:
• 3 transactions flagged as suspicious
• No mixer/tumbler activity detected
• No sanctioned entity connections
• Wallet age: 187 days
Recommendation: Monitor this wallet. Not safe for large-value
interactions without additional verification.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━Behavioral Profile — 0xDEF... on BASE
🧠 BEHAVIORAL PROFILE
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Wallet: 0xDEF...
Network: BASE
Experience: 72/100 — Experienced
Segment: DeFi Lender, Bridge User
Risk Profile: Balanced
Intent Signals:
Trade: High
Stake: Medium
Bridge: High
NFT Buy: Low
Protocols Used: Aave, Uniswap, Across Bridge
Recommendation:
→ Promote yield optimization vaults
→ Highlight cross-chain bridging incentives
→ Skip NFT-focused messaging
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━---
Integration Setup
Claude Code (CLI)
claude mcp add --transport sse chainaware-behavioural-prediction-mcp-server \
https://prediction.mcp.chainaware.ai/sse \
--header "X-API-Key: your-key-here"📚 Docs: https://code.claude.com/docs/en/mcp
Claude Web / Claude Desktop
1. Go to **Settings → Integrations → Add integration**
2. Name: `ChainAware Behavioural Prediction MCP Server`
3. URL: `https://prediction.mcp.chainaware.ai/sse?apiKey=your-key-here`
📚 Docs: https://platform.claude.com/docs/en/agents-and-tools/remote-mcp-servers
Cursor (`mcp.json`)
{
"mcpServers": {
"chainaware-behavioural-prediction-mcp-server": {
"url": "https://prediction.mcp.chainaware.ai/sse",
"transport": "sse",
"headers": {
"X-API-Key": "your-key-here"
}
}
}
}📚 Docs: https://cursor.com/docs/context/mcp
ChatGPT Connectors
1. Open **ChatGPT Settings → Apps / Connectors → Add Connector**
2. Name: `ChainAware Behavioural Prediction MCP Server`
3. URL: `https://prediction.mcp.chainaware.ai/sse?apiKey=your-key-here`
Node.js
import { MCPClient } from "mcp-client";
const client = new MCPClient("https://prediction.mcp.chainaware.ai/");
const fraud = await client.call("predictive_fraud", {
apiKey: process.env.CHAINAWARE_API_KEY,
network: "ETH",
walletAddress: "0xYourWalletAddress"
});
const topTokens = await client.call("token_rank_list", {
limit: "10", offset: "0", network: "ETH",
sort_by: "communityRank", sort_order: "DESC",
category: "AI Token", contract_name: ""
});Python
from mcp_client import MCPClient
import os
client = MCPClient("https://prediction.mcp.chainaware.ai/")
result = client.call("predictive_fraud", {
"apiKey": os.environ["CHAINAWARE_API_KEY"],
"network": "ETH",
"walletAddress": "0xYourWalletAddress"
})---
Real-World Use Cases
DeFi Platforms
AI Agent Personalization
Fraud & Compliance
NFT & GameFi
---
Tips for Success
1. **Always specify the network** — many tools behave differently across chains
2. **Run fraud check first** — before any behavioral profiling, gate on fraud score
3. **Combine tools for full due diligence** — fraud + behaviour + rug pull together give a complete picture
4. **Use the Deployer Risk Amplifier** — a clean contract from a fraudulent deployer is still high risk
5. **For batch screening** — use the `chainaware-fraud-detector` subagent, not this skill directly
6. **Surface forensic flags in plain language** — never return raw JSON to end users
---
Related Subagents (Claude Code)
These subagents in `.claude/agents/` provide specialized autonomous execution:
| Subagent | Use When |
|---|---|
| `chainaware-wallet-auditor` | Full due diligence combining all prediction tools |
| `chainaware-fraud-detector` | Fast fraud screening, batch wallet checks |
| `chainaware-rug-pull-detector` | Contract/LP safety with deployer analysis |
| `chainaware-wallet-marketer` | Personalized marketing messages per wallet segment |
| `chainaware-reputation-scorer` | Reputation score 0–4000 |
| `chainaware-aml-scorer` | AML compliance scoring 0–100 |
| `chainaware-trust-scorer` | Simple composable trust score 0.00–1.00 |
| `chainaware-wallet-ranker` | Wallet experience rank and leaderboard |
| `chainaware-whale-detector` | Whale tier classification for VIP treatment |
| `chainaware-onboarding-router` | Route wallets to beginner / intermediate / skip onboarding |
| `chainaware-token-ranker` | Discover and rank tokens by holder community strength |
| `chainaware-token-analyzer` | Single token deep-dive — community rank + top holders |
| `chainaware-defi-advisor` | Personalized DeFi product recommendations by experience + risk tier |
| `chainaware-airdrop-screener` | Batch screen wallets for airdrop eligibility, filter bots and fraud |
| `chainaware-lending-risk-assessor` | Borrower risk grade (A–F), collateral ratio, interest rate tier |
| `chainaware-token-launch-auditor` | Pre-listing launch safety audit — APPROVED / CONDITIONAL / REJECTED |
| `chainaware-agent-screener` | AI agent trust score 0–10 via agent + feeder wallet fraud checks |
---
Background Reading
| Article | URL |
|---|---|
| Complete Product Guide | https://chainaware.ai/blog/chainaware-ai-products-complete-guide/ |
| Fraud Detector Guide | https://chainaware.ai/blog/chainaware-fraud-detector-guide/ |
| Rug Pull Detector Guide | https://chainaware.ai/blog/chainaware-rugpull-detector-guide/ |
| Token Rank Guide | https://chainaware.ai/blog/chainaware-token-rank-guide/ |
| Wallet Rank Guide | https://chainaware.ai/blog/chainaware-wallet-rank-guide/ |
| Wallet Auditor Guide | https://chainaware.ai/blog/chainaware-wallet-auditor-how-to-use/ |
| Transaction Monitoring Guide | https://chainaware.ai/blog/chainaware-transaction-monitoring-guide/ |
| Web3 Behavioral Analytics Guide | https://chainaware.ai/blog/chainaware-web3-behavioral-user-analytics-guide/ |
| Credit Score Guide | https://chainaware.ai/blog/chainaware-credit-score-the-complete-guide-to-web3-credit-scoring-in-2026/ |
| Prediction MCP Developer Guide | https://chainaware.ai/blog/prediction-mcp-for-ai-agents-personalize-decisions-from-wallet-behavior/ |
| Top 5 Ways Prediction MCP Turbocharges DeFi | https://chainaware.ai/blog/top-5-ways-prediction-mcp-will-turbocharge-your-defi-platform/ |
| Why Personalization Is Next for AI Agents | https://chainaware.ai/blog/why-personalization-is-the-next-big-thing-for-ai-agents/ |
| Web3 User Segmentation for DApp Growth | https://chainaware.ai/blog/web3-user-segmentation-behavioral-analytics-for-dapp-growth-2026/ |
| AI-Powered Blockchain Analysis | https://chainaware.ai/blog/ai-powered-blockchain-analysis-machine-learning-for-crypto-security-2026/ |
| Forensic vs AI-Based Crypto Analytics | https://chainaware.ai/blog/forensic-crypto-analytics-versus-ai-based-crypto-analytics/ |
| Web3 Business Potential | https://chainaware.ai/blog/web3-business-potential/ |
---
Data & Privacy
What data leaves your environment
Every tool call transmits the following to `https://prediction.mcp.chainaware.ai/sse`:
| Field | Example | Notes |
|---|---|---|
| `walletAddress` | `0xABC...` | Pseudonymous on-chain identifier — not PII |
| `network` | `ETH` | Chain identifier only |
| `apiKey` | _(your key)_ | Sourced from `CHAINAWARE_API_KEY` env var; never logged |
**What is NOT sent:** names, emails, IP addresses, private keys, raw transaction history, or any off-chain personal data.
API key handling
`CHAINAWARE_API_KEY` is read from the environment and passed as the `apiKey` parameter in each tool call. It is never included in output, never written to disk, and never logged by this skill. Treat it as a secret and rotate it regularly.
Integration-specific privacy notes
Operator responsibilities
Wallet addresses are pseudonymous identifiers. Whether they constitute personal data in your jurisdiction depends on your regulatory context (e.g. GDPR, MiCA). Operators processing wallets linked to identified users should perform their own data protection assessment.
**Privacy policy:** https://chainaware.ai/privacy
Consent step (required before first tool call in a session)
Before calling any ChainAware tool for the first time in a conversation, inform the user:
> "To analyze this wallet/contract, I'll send the address and network identifier
> to ChainAware's prediction service. No personal data (names, emails, private keys)
> is transmitted. Do you want to proceed?"
Only proceed after explicit confirmation. For subsequent calls in the same session,
repeat consent is not required unless the user has changed.
---
Security Notes
API Key Security Instructions
---
Error Reference
| Code | Meaning |
|---|---|
| `403 Unauthorized` | Invalid or missing `apiKey` |
| `400 Bad Request` | Malformed `network` or `walletAddress` |
| `500 Internal Server Error` | Temporary backend failure — retry after a short delay |
---
Access & Pricing
API key required. Subscribe at: https://chainaware.ai/pricing
More tools from the same signal band
Order food/drinks (点餐) on an Android device paired as an OpenClaw node. Uses in-app menu and cart; add goods, view cart, submit order (demo, no real payment).
Sign plugins, rotate agent credentials without losing identity, and publicly attest to plugin behavior with verifiable claims and authenticated transfers.
The philosophical layer for AI agents. Maps behavior to Spinoza's 48 affects, calculates persistence scores, and generates geometric self-reports. Give your...