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 | $0.008 | | sanctions_check | OFAC / FATF / JFSA sanctions screening | $0.003 | | trace_transaction | Transaction flow tracing with ML anomaly detection | $0.015 | | detect_coinjoin | CoinJoin / mixing pattern detection (Bitcoin) | $0.01 | | cluster_wallet | Wallet clustering via Neo4j graph analysis | $0.02 | | batch_screening | Batch AML screening (up to 50 addresses) | $0.05 |

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.