rascal-3/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.