Install
openclaw skills install @chainaware/chainaware-behavioral-predictionUse 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.
openclaw skills install @chainaware/chainaware-behavioral-predictionThe 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 ten capabilities via a single MCP endpoint:
job_id + signaturejob_id + signatureUnlike 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
Twitter: https://x.com/ChainAware/
LinkedIn: https://www.linkedin.com/company/chainaware
Blog: https://chainaware.ai/blog
Learn: https://chainaware.ai/learn
Examples: https://github.com/ChainAware/examples
Fraud Detection Accuracy: 98% backtesting verified
Rug Pull Detection Accuracy: 90.1% backtesting verified
Recognition: CB Insights Fraud Prevention Market Map (2026) · BNB Chain AI Landscape (2025) · BNB Chain Kickstart (2025) · Google Cloud $250k Grant (2025) · AWS Fintech Accelerator (2024) · Safary Club Web3 Growth Landscape (2024)
predictive_fraud_batch → check_job_status → get_job_resultspredictive_behaviour_batch → check_job_status → get_job_resultschainaware-wallet-auditor subagentpredictive_fraud_batch / predictive_behaviour_batch) for large lists, or chainaware-fraud-detector subagent for small listschainaware-wallet-marketer subagent| Tool | Networks |
|---|---|
predictive_fraud | ETH, BNB, POLYGON, TON, BASE, TRON, HAQQ |
predictive_fraud_batch | ETH, BNB, POLYGON, TON, BASE, TRON, HAQQ |
predictive_behaviour | ETH, BNB, BASE, HAQQ, SOLANA |
predictive_behaviour_batch | ETH, BNB, BASE, HAQQ, SOLANA |
check_job_status | Network-agnostic (uses job_id + signature) |
get_job_results | Network-agnostic (uses job_id + signature) |
predictive_rug_pull | ETH, BNB, BASE, HAQQ |
credit_score | ETH |
token_rank_list | ETH, BNB, BASE, SOLANA |
token_rank_single | ETH, BNB, BASE, SOLANA |
predictive_fraud with the wallet address and network.probabilityFraud using the threshold table below.forensic_details for negative flags (mixer use, sanctioned entities, darknet, etc.).predictive_behaviour with the wallet address and network.intention.Value (Prob_Trade/Stake/Bridge/NFT_Buy), experience.Value, categories, recommendation.predictive_fraud on the deployer address first for extra signal.predictive_rug_pull with the contract address.probabilityFraud and scan forensic_details for liquidity and contract risk flags.token_rank_list with appropriate category, network, sort_by: communityRank, sort_order: DESC.token_rank_single with contract_address and network.communityRank, normalizedRank, totalHolders, and top holder profiles.predictive_fraud_batch or predictive_behaviour_batch with the wallet list and network.job_id and signature from the response — required for all follow-up calls.check_job_status with job_id + signature until status is completed or partial.
pending or processing → wait and retry.partial → some wallets failed but results are available for completed items.get_job_results with job_id + signature to fetch the full per-wallet data.data array returns the same schema as single-wallet predictive_behaviour / predictive_fraud results.Never call
get_job_resultswhile status is stillpendingorprocessing. The jobexpires_attimestamp in the status response indicates how long results are retained.
predictive_fraud → get fraud score and forensic flagspredictive_behaviour → get behavioral profile and intentpredictive_rug_pull (if a contract address) → get contract riskFor complex due diligence workflows, escalate to the
chainaware-wallet-auditorsubagent.
| 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 |
predictive_fraud — Fraud DetectionForecasts 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:
apiKey (string, required) — ChainAware API keynetwork (string, required) — e.g. ETH, BNB, BASEwalletAddress (string, required) — the wallet to evaluateKey output fields:
status — "Fraud", "Not Fraud", or "New Address"probabilityFraud — decimal 0.00–1.00forensic_details — deep on-chain breakdownExample prompts that trigger this tool:
predictive_behaviour — Behavioral Analysis & PersonalizationProfiles a wallet's on-chain history and predicts its next actions.
Inputs:
apiKey (string, required)network (string, required)walletAddress (string, required)Key output fields:
intention — predicted next actions (Prob_Trade, Prob_Stake, Prob_Bridge, Prob_NFT_Buy — High/Medium/Low)recommendation — personalized action suggestionscategories — behavioral segments (DeFi Lender, NFT Trader, Bridge User, etc.)riskProfile — risk tolerance and balance age breakdownexperience — experience score 0–10 (beginner → expert)protocols — which protocols this wallet uses (Aave, Uniswap, GMX, etc.)Example prompts that trigger this tool:
predictive_rug_pull — Rug Pull DetectionForecasts whether a smart contract or liquidity pool is likely to execute a rug pull.
Inputs:
apiKey (string, required)network (string, required)walletAddress (string, required) — smart contract or LP addressKey output fields:
status — "Fraud" or "Not Fraud"probabilityFraud — decimal 0.00–1.00forensic_details — on-chain metrics behind the scoreExample prompts that trigger this tool:
credit_score — Crypto Credit ScoreCalculates a credit/trust score (1–9) for a wallet by combining fraud probability with social graph analysis. Designed for DeFi lending and any use case needing a fast single-number creditworthiness signal.
Inputs:
apiKey (string, required)network (string, required) — ETHwalletAddress (string, required) — the wallet to scoreKey output fields:
creditData.riskRating — integer 1–9 (1 = highest risk, 9 = highest trust)creditData.walletAddress — echoed wallet address| riskRating | Label | Lending Interpretation |
|---|---|---|
| 9 | ✅ Prime | Highest creditworthiness — best terms |
| 7–8 | 🟢 Reliable | Low credit risk — standard terms |
| 5–6 | 🟡 Moderate | Elevated caution — higher collateral |
| 3–4 | 🔴 High Risk | Restricted terms or decline |
| 1–2 | ⛔ Very High Risk | Do not lend |
Example prompts that trigger this tool:
token_rank_list — Token Ranking by Holder StrengthRanks tokens by the quality and strength of their holder community.
Inputs:
limit (string, required) — items per pageoffset (string, required) — page numbernetwork (string, required) — ETH, BNB, BASE, SOLANAsort_by (string, required) — e.g. communityRanksort_order (string, required) — ASC or DESCcategory (string, required) — AI Token, RWA Token, DeFi Token, DeFAI Token, DePIN Tokencontract_name (string, required) — token name search (empty string for no filter)Key output fields:
data.total — total matching tokensdata.contracts[] — array with contractAddress, contractName, ticker, chain, category, communityRank, normalizedRank, totalHoldersExample prompts that trigger this tool:
token_rank_single — Single Token Rank & Top HoldersReturns the rank and top holders for a specific token by contract address.
Inputs:
contract_address (string, required) — token contract or mint addressnetwork (string, required) — ETH, BNB, BASE, SOLANAKey output fields:
data.contract — token details including communityRank, normalizedRank, totalHoldersdata.topHolders[] — holder wallet addresses with balance, walletAgeInDays, transactionsNumber, totalPoints, globalRankExample prompts that trigger this tool:
predictive_fraud_batch — Batch Fraud Detection (Schedule)Schedules an async fraud detection job for a list of wallet addresses. Returns a job handle immediately — results are fetched later via check_job_status + get_job_results.
Inputs:
apiKey (string, required) — ChainAware API keynetwork (string, required) — ETH, BNB, POLYGON, TON, BASE, TRON, HAQQaddresses (array[objects], required) — list of wallet address objects to evaluateKey output fields:
job_id — unique job identifier (store this)signature — access token for follow-up calls (store this)status — always "pending" on schedule responsetotal_items — number of wallets submittedExample prompts that trigger this tool:
predictive_behaviour_batch — Batch Behavioral Analysis (Schedule)Schedules an async behavioral analysis job for a list of wallet addresses. Same fire-and-fetch pattern as predictive_fraud_batch.
Inputs:
apiKey (string, required) — ChainAware API keynetwork (string, required) — ETH, BNB, BASE, HAQQ, SOLANAaddresses (array[objects], required) — list of wallet address objects to evaluateKey output fields:
job_id — unique job identifier (store this)signature — access token for follow-up calls (store this)status — always "pending" on schedule responsetotal_items — number of wallets submittedExample prompts that trigger this tool:
check_job_status — Batch Job ProgressChecks the progress of a scheduled batch job. Returns counts only — no wallet data. Call this after scheduling a batch job and before fetching results.
Inputs:
job_id (string, required) — from predictive_fraud_batch or predictive_behaviour_batchsignature (string, required) — from the same schedule callKey output fields:
status — "pending" | "processing" | "partial" | "completed"completed_items, failed_items, pending_items — progress countsexpires_at — when results will be purged| Status | Meaning | Next Action |
|---|---|---|
pending | Queued, not started | Wait and retry |
processing | Actively running | Wait and retry |
partial | Some done, some failed | Safe to call get_job_results |
completed | All wallets processed | Call get_job_results |
get_job_results — Batch Job ResultsRetrieves the full per-wallet results from a completed or partial batch job. Returns the same rich schema as the single-wallet tools. Only call when check_job_status shows completed or partial.
Inputs:
job_id (string, required) — from the schedule callsignature (string, required) — from the same schedule callKey output fields:
data[] — array of per-wallet results; each entry mirrors predictive_behaviour / predictive_fraud output schemaExample prompts that trigger this tool:
CHAINAWARE_API_KEY environment variable is set (not required for check_job_status / get_job_results)token_rank_list: limit, offset, sort_by, sort_order, and category all providedtoken_rank_single: both contract_address and network providedjob_id and signature stored from the schedule response before calling follow-up toolsget_job_results while job status is pending or processingprobabilityFraud is present and in range 0.00–1.00intention, experience, and categories included in responsejob_id to the user after scheduling; they may need it to check status manually🔮 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
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Wallet: 0xDEF...
Network: BASE
Experience: 7.2/10 — 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
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
CHAINAWARE_API_KEY environment variable is required. Obtain one at https://chainaware.ai/pricinghttps://prediction.mcp.chainaware.ai/sse; no packages to installclaude 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
ChainAware Behavioural Prediction MCP Serverhttps://prediction.mcp.chainaware.ai/sse?apiKey=your-key-here📚 Docs: https://platform.claude.com/docs/en/agents-and-tools/remote-mcp-servers
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
ChainAware Behavioural Prediction MCP Serverhttps://prediction.mcp.chainaware.ai/sse?apiKey=your-key-hereimport { 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: ""
});
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"
})
chainaware-fraud-detector or chainaware-airdrop-screener which call single-wallet tools in a looppredictive_fraud_batch or predictive_behaviour_batch → check_job_status → get_job_resultsThese subagents in .claude/agents/ provide specialized autonomous execution:
| Subagent | Use When |
|---|---|
chainaware-wallet-auditor | Full due diligence — deep behavioural profiling including fraud signals |
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–1000 |
chainaware-aml-scorer | AML compliance scoring 0–100 |
chainaware-trust-scorer | Simple composable trust score 0.00–1.00 |
chainaware-credit-scorer | Crypto credit score 1–9 for lending and creditworthiness decisions |
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 |
chainaware-cohort-analyzer | Segment a batch of wallets into behavioral cohorts with engagement strategies |
chainaware-counterparty-screener | Real-time pre-transaction go/no-go (Safe / Caution / Block) |
chainaware-governance-screener | DAO voter Sybil detection and voting weight calculation |
chainaware-sybil-detector | Bulk Sybil attack detection for DAO votes — ELIGIBLE / REVIEW / EXCLUDE per wallet, pattern flags, and vote multipliers |
chainaware-transaction-monitor | Real-time transaction risk for autonomous agents — ALLOW / FLAG / HOLD / BLOCK |
chainaware-lead-scorer | Sales lead qualification — score, tier, conversion probability, outreach angle |
chainaware-upsell-advisor | Next product recommendation and upsell message for existing users |
chainaware-platform-greeter | Contextual welcome message per wallet per platform |
chainaware-marketing-director | Full-cycle campaign orchestrator — segments, leads, whales, per-cohort messages |
chainaware-compliance-screener | MiCA-aligned compliance report — PASS / EDD / REJECT (~70–75% MiCA coverage) |
chainaware-gamefi-screener | Web3 game / P2E bot detection, player tier classification, reward eligibility |
chainaware-portfolio-risk-advisor | Portfolio-level rug pull scan, risk grade (A–F), rebalancing plan |
chainaware-rwa-investor-screener | RWA investor suitability — QUALIFIED / CONDITIONAL / REFER_TO_KYC / DISQUALIFIED |
chainaware-ltv-estimator | 12-month revenue potential (LTV) as a USD range — tx count × avg tx value × fee rate, scaled by behavioral multipliers. Optional: platform_share, fee_rate |
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.
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.
X-API-Key header — does not appear in URLs or logs?apiKey=...) — these platforms do not support custom SSE headers. Be aware the key will appear in your browser's network tab. Use a restricted-scope key for these integrations.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
| 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 |
API key required. Subscribe at: https://chainaware.ai/pricing