io.github.rascal-3/chainanalyzer-mcp
Multi-chain AML risk scoring, sanctions screening, and tx tracing across BTC, ETH, POL, AVAX, SOL.
Open source Open in the app JSON README (API)
About
Multi-chain AML risk scoring, sanctions screening, and tx tracing across BTC, ETH, POL, AVAX, SOL.
Details
- Kind
- MCP servers
- Topic
- Security & identity
- Publisher
- rascal-3
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.1.1
- Stars
- 1
- Forks
- 1
- Open pull requests
- 1
- Last push
- 2026-08-08T18:51:41Z
- Repository state
- ativo
- Language
- TypeScript
- License
- MIT
- Added
- 2026-08-29 04:01:16
- Updated
- 2026-08-29 04:01:16
- Origin id
io.github.rascal-3/chainanalyzer-mcp
README
# chainanalyzer-mcp
MCP Server for [ChainAnalyzer](https://chain-analyzer.com) — 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 |
|------|-------------|-------|
| `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 |
| `bridge_flow_trace` | Multi-hop cross-chain forensic trace with Solver detection + same-intent correlation (NEAR Intents / Wormhole / Stargate / Across / Synapse / Hop / deBridge) | $3.00 |
## Quick Start
### Claude Desktop / Claude Code
Add to your MCP configuration:
```json
{
"mcpServers": {
"chainanalyzer-aml": {
"command": "npx",
"args": ["-y", "chainanalyzer-mcp"],
"env": {
"CHAINANALYZER_API_KEY": "tfk_your_api_key"
}
}
}
}
```
### From Source
```bash
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](https://chain-analyzer.com) (Pro plan).
```json
{
"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.
```json
{
"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`.
```json
{
"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](https://chain-analyzer.com) — Web platform
- [Documentation](https://chain-analyzer.com/docs/api) — API reference
- [x402 Protocol](https://x402.org) — Pay-per-request standard
## License
MIT - see [LICENSE](LICENSE)
---
Built by [refinancier, inc.](https://chain-analyzer.com)