# rascal-3/chainanalyzer-mcp [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/rascal-3/chainanalyzer-mcp  
**GitHub Stars:** 1  
**npm Downloads (last month):** 277  
**Views:** 1  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/rascal-3-chainanalyzer-mcp

## Description
Multi-chain AML risk scoring and sanctions screening for AI agents. 76+ detection rules, ML anomaly scoring, and Neo4j graph analysis across Bitcoin, Ethereum, Polygon, Avalanche, and Solana. Pay-per-request via x402 USDC on Base or Solana ($0.003–$0.05). npx chainanalyzer-mcp.

## Tools
Capabilities this server exposes over MCP:

- **check_address_risk** — AML risk score for any blockchain address
- **sanctions_check** — OFAC / FATF / JFSA sanctions screening
- **trace_transaction** — Transaction flow tracing with ML anomaly detection
- **detect_coinjoin** — CoinJoin / mixing pattern detection (Bitcoin)
- **cluster_wallet** — Wallet clustering via Neo4j graph analysis
- **batch_screening** — Batch AML screening (up to 50 addresses)
- **bridge_flow_trace** — Multi-hop cross-chain forensic trace with Solver detection + same-intent correlation (NEAR Intents / Wormhole / Stargate / Across / Synapse / Hop / deBridge)

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "chainanalyzer-mcp": {
    "command": "npx",
    "args": ["-y","chainanalyzer-mcp"],
    "env": {
      "CHAINANALYZER_API_KEY": "",
      "X402_PRIVATE_KEY": "",
      "X402_NETWORK": "",
      "CHAINANALYZER_BASE_URL": ""
    }
  }
}
```

**Requires environment variables:** `CHAINANALYZER_API_KEY`, `X402_PRIVATE_KEY`, `X402_NETWORK`, `CHAINANALYZER_BASE_URL` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation & 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](https://github.com/rascal-3/chainanalyzer-mcp/blob/HEAD/LICENSE)

---

Built by [refinancier, inc.](https://chain-analyzer.com)