chainanalyzer-mcp
MCP Server for ChainAnalyzer — multi-chain blockchain AML risk analysis for AI agents.
Scan any address across 8 chains live for self-serve — Bitcoin, Ethereum, Polygon, Base, Arbitrum, Optimism, Avalanche, Solana — plus BNB Smart Chain on Enterprise rollout (paid Etherscan tier required, available via API key only). 76+ detection rules across 9 chains, ML anomaly scoring, and Neo4j graph analysis.
Tools
| Tool | Description | Price |
|---|---|---|
check_address_risk | AML risk score for any blockchain address | $1.00 |
sanctions_check | OFAC / FATF / JFSA sanctions screening | $0.50 |
trace_transaction | Transaction flow tracing with ML anomaly detection | $3.00 |
detect_coinjoin | CoinJoin / mixing pattern detection (Bitcoin) | $1.00 |
cluster_wallet | Wallet clustering via Neo4j graph analysis | $2.50 |
batch_screening | Batch AML screening (up to 50 addresses) | $5.00 |
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 start
Authentication
Choose one of three modes:
1. API Key (Subscription)
Get a tfk_ API key from chain-analyzer.com (Pro plan).
{
"env": {
"CHAINANALYZER_API_KEY": "tfk_your_api_key"
}
}
2. x402 USDC Payment (Pay-Per-Request)
No account needed. Pay with USDC on Base or Solana per request.
{
"env": {
"X402_PRIVATE_KEY": "your_wallet_private_key",
"X402_NETWORK": "base"
}
}
Requires the x402 npm package: npm install x402
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 |
|---|---|---|
CHAINANALYZER_API_KEY | tfk_ API key (subscription auth) | One of API key or x402 |
X402_PRIVATE_KEY | Wallet private key for USDC payments | One of API key or x402 |
X402_NETWORK | Payment network: base or solana (default: base) | No |
CHAINANALYZER_BASE_URL | API base URL (default: https://chain-analyzer.com) | 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
- Bitcoin — OFAC screening, dust attacks, peel chains, CoinJoin detection
- Ethereum — 18+ detectors, Neo4j graph analysis, sanctions, mixers
- Polygon — Full EVM AML suite, Etherscan V2 compatible
- Avalanche — Full EVM AML suite, Routescan API
- Solana — Token security (rug pull, honeypot), wallet drainer detection
Links
- ChainAnalyzer — Web platform
- Documentation — API reference
- x402 Protocol — Pay-per-request standard
License
MIT - see LICENSE
Built by refinancier, inc.