chainanalyzer-mcp
One-line summary: chainanalyzer-mcp gives AI agents tools to run multi-chain blockchain AML risk, sanctions, tracing, and clustering analysis via the ChainAnalyzer API.
check_address_risk— AML risk score (0–100), risk level, detections, and ML anomaly score for an address on Bitcoin, Ethereum, Polygon, Avalanche, or Solana.sanctions_check— Screen an address against OFAC, FATF, JFSA, and ChainAnalyzer ScamDB lists.trace_transaction— Trace fund flows for a transaction with ML anomaly detection (configurable depth 1–5), returning a graph of addresses and transfers.detect_coinjoin— Identify CoinJoin, mixing, and tumbling patterns in a Bitcoin transaction.cluster_wallet— Find related addresses via Neo4j graph clustering (depth 1–3), returning cluster size and linked addresses.batch_screening— Screen up to 50 addresses at once, returning risk level and score per address.Flexible auth/billing — API key (
tfk_), pay-per-call USDC over x402, or keyless dev mode; addresses are auto-detected by chain when omitted.
Provides AML risk analysis for Bitcoin addresses, including sanctions screening, CoinJoin/mixing detection, and transaction tracing.
Provides AML risk analysis for Ethereum addresses, including 18+ detectors, Neo4j graph analysis, sanctions, and mixer detection.
Used for wallet clustering and graph analysis to detect relationships between addresses.
Provides full EVM AML suite for Polygon, compatible with Etherscan V2 API.
Provides token security analysis (rug pull, honeypot) and wallet drainer detection for Solana.
chainanalyzer-mcp
MCP Server for ChainAnalyzer — multi-chain blockchain AML risk analysis for AI agents.
Scan any address across 12 chains, all live for self-serve — Bitcoin, Ethereum, Polygon, BNB Smart Chain, Base, Arbitrum, Optimism, Avalanche, Solana, Kaia, TRON, and XRP. 76+ detection rules, ML anomaly scoring, and Neo4j graph analysis.
Tools
Tool | Description | Price |
| AML risk score for any blockchain address (12 chains) | $0.10 |
| OFAC / FATF / JFSA sanctions screening (12 chains) | $0.05 |
| Is this address connected to a known hack (e.g. Binance 2026)? Verdict, hop distance from the attacker, role and lower-bound amounts per incident (EVM, TRON, Solana, Bitcoin) | $0.05 |
| Is this address frozen / blacklisted by a stablecoin issuer (USDT, USDC, JPYC ...)? Current state per token with timestamps (Ethereum, Polygon, Avalanche, TRON) | $0.02 |
| Known-hack exposure for up to 50 addresses in one call (deposit-list screening) | $1.00 |
| Transaction flow tracing with ML anomaly detection (12 chains) | $0.30 |
| Takes a Bitcoin transaction id and decides from its structure whether it is a CoinJoin: | $0.10 |
| Wallet clustering via Neo4j graph analysis | $0.25 |
| Batch AML screening (up to 50 addresses, 12 chains) | $2.50 |
| Multi-hop cross-chain forensic trace with Solver detection + same-intent correlation (NEAR Intents / Wormhole / Stargate / Across / Synapse / Hop / deBridge). Source chain: EVM chains or Solana | $0.50 |
Prices are per call in x402 mode (USDC, from 2026-11-16). The live list is at https://chain-analyzer.com/x402/api/discover. The batch tools are a fixed price per call for up to 50 addresses.
Related MCP server: sliverc2-mcp
Agent framework examples
Ready-to-use tools for LangChain, OpenAI Agents SDK, Vercel AI SDK and ElizaOS (pay per call over x402 or with an API key): examples/.
Quick Start
Claude Desktop / Claude Code
Add to your MCP configuration:
{
"mcpServers": {
"chainanalyzer-aml": {
"command": "npx",
"args": ["-y", "chainanalyzer-mcp"],
"env": {
"CHAINANALYZER_API_KEY": "tfk_your_api_key"
}
}
}
}From Source
git clone https://github.com/rascal-3/chainanalyzer-mcp.git
cd chainanalyzer-mcp
npm install
npm startAgent Skill & Claude Code Plugin
The repo ships an Agent Skill that tells the agent when to use these tools, how to pick the chain from the address format, which tool to call first, and how to report results. It works with any agent that reads SKILL.md (Claude Code, Cursor, Codex CLI, Gemini CLI, OpenClaw, ...).
Claude Code (plugin: MCP server + skill in one step)
/plugin marketplace add rascal-3/chainanalyzer-mcp
/plugin install chainanalyzer-aml@chainanalyzerSet CHAINANALYZER_API_KEY in your shell environment (or X402_PRIVATE_KEY for pay-per-request). The plugin's .mcp.json reads it from there.
Any other agent
Copy skills/chainanalyzer-aml/ into your agent's skills directory and configure the MCP server as shown in Quick Start.
MCP Registry
Listed in the official MCP Registry as io.github.rascal-3/chainanalyzer-mcp.
Authentication
Choose one of three modes:
1. API Key (all plans, including Free)
Create a tfk_ API key at chain-analyzer.com → Account → Settings → API Keys. Every plan can issue keys; the Free plan includes 10 scans/month, enough to try sanctions, risk, trace, CoinJoin and cluster before paying. batch_screening needs Starter or above and bridge_flow_trace needs Business or above in API-key mode (x402 mode has no plan gates). Rate limits by plan: Free 10/min, Starter 30/min, Pro 60/min, Business 120/min, Enterprise 300/min.
{
"env": {
"CHAINANALYZER_API_KEY": "tfk_your_api_key"
}
}2. x402 USDC Payment (Pay-Per-Request)
No account needed. Set X402_PRIVATE_KEY and the server pays each call automatically in USDC on Base (x402 v2, exact scheme). No extra install is needed. (The ChainAnalyzer x402 API also accepts USDC on Solana when its 402 response offers it, but this server pays on Base only.)
{
"env": {
"X402_PRIVATE_KEY": "0x_private_key_of_a_dedicated_low_balance_wallet",
"X402_MAX_USD_PER_CALL": "1.00"
}
}X402_MAX_USD_PER_CALL(default1.00) caps a single payment. A call priced above it is refused before anything is signed.batch_screeningcosts $2.50, so set it to2.50or more to use that tool.Calls that fail are not charged: the server settles the payment only after a successful response. If a payment is rejected, the error shows the server's reason and hint.
Use a dedicated wallet that holds only a small USDC balance on Base. The key is never logged.
Use a key whose address has no EIP-7702 delegation. If the paying address has an EIP-7702 delegation (it has been turned into a smart account), the USDC signature check on Base can fail and the payment is rejected. Pay from a plain address with no delegation.
3. Dev Mode
No authentication. Works when the ChainAnalyzer server has X402_ENABLED=false.
{
"env": {
"CHAINANALYZER_BASE_URL": "http://localhost:3000"
}
}Environment Variables
Variable | Description | Required |
|
| One of API key or x402 |
| Hex EVM private key of the wallet that pays in USDC on Base | One of API key or x402 |
| Per-call payment limit in USD (default: | No |
| Payment network (default: | No |
| API base URL (default: | No |
Example Usage
Once configured, ask your AI agent:
"Check if this Ethereum address is sanctioned: 0x1234..."
"Analyze the risk score for this Solana wallet: ABC123..."
"Trace the fund flow of this Bitcoin transaction and check for mixing patterns"
"Screen these 20 addresses for AML compliance"
The agent will automatically call the appropriate ChainAnalyzer tools.
Supported Chains
All 12 chains are live for self-serve plans.
Chain | Highlights |
Bitcoin | OFAC screening, dust attacks, peel chains, CoinJoin detection |
Ethereum | 18+ detectors, Neo4j graph analysis, sanctions, mixers |
Polygon / BNB Smart Chain / Base / Arbitrum / Optimism / Avalanche / Kaia | Full EVM AML suite, bridge tracing |
Solana | Token security (rug pull, honeypot), wallet drainer detection, bridge tracing |
TRON | USDT flow screening, sanctions (independent scanner) |
XRP | Exchange / issuer labels, sanctions (independent scanner) |
bridge_flow_trace starts from EVM chains (Kaia included) or Solana. detect_coinjoin is Bitcoin only. freeze_status covers Ethereum, Polygon, Avalanche and TRON; hack_exposure_lookup / hack_exposure_batch cover EVM chains, TRON, Solana and Bitcoin.
Links
ChainAnalyzer — Web platform
Using ChainAnalyzer from AI agents — skill, plugin and MCP setup guide
x402 Protocol — Pay-per-request standard
License
MIT - see LICENSE
Built by refinancier, inc.
Available Tools
6 toolsbatch_screeningA
Batch AML screening for multiple addresses at once (up to 50). Returns risk level and score per address.
Inputs: addresses (required), chain.
check_address_riskA
Get AML risk score for any blockchain address. Returns risk level, score (0-100), detections, and ML anomaly score. Supports BTC, ETH, POL, AVAX, SOL.
Inputs: address (required), chain, lang.
cluster_walletA
Identify related addresses through Neo4j graph clustering. Returns cluster size and related addresses.
Inputs: address (required), depth.
detect_coinjoinB
Detect CoinJoin, mixing, and tumbling patterns in a Bitcoin transaction.
Inputs: tx_hash (required).
sanctions_checkB
Screen address against OFAC, FATF, JFSA, and ChainAnalyzer ScamDB sanctions lists.
Inputs: address (required), chain.
trace_transactionB
Trace fund flows for a transaction with ML anomaly detection. Returns graph of addresses and transfers.
Inputs: tx_hash (required), chain, depth.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool targets a distinct blockchain analysis function: screening (batch vs single address), clustering, mixing detection, sanctions checking, and transaction tracing. No overlap in purpose.
Tools use a consistent verb_noun pattern (e.g., batch_screening, check_address_risk, detect_coinjoin) with one exception: 'cluster_wallet' uses verb_noun but 'wallet' is a bit broader. Overall, naming is clear and predictable.
With 6 tools, the server covers core AML and blockchain analysis functions succinctly without being too sparse or overly numerous.
The tool set covers screening (batch & single), risk scoring, clustering, mixing detection, sanctions, and tracing. A minor gap is the lack of a tool for getting raw transaction data or address history, but the main analysis workflows are complete.
Maintenance
Related MCP Connectors
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceMCP server that integrates with the BlockSec https://blocksec.com platform to provide blockchain transaction analysis.11MIT
- MIT
- AlicenseAqualityDmaintenanceThe first MCP Server dedicated to Bitcoin ecosystem236MIT
- AGPL 3.0