Chainanalyzer Mcp

io.github.rascal-3Published by GitHub account rascal-3v1.7.0Updated Nov 3, 2026

Blockchain AML for AI agents: risk scoring, sanctions, tx & bridge tracing across 12 chains.

VerifiedSTDIODesktop onlyFinanceSecurity & Monitoring

Overview

AI-generated overview

ChainAnalyzer MCP gives an AI assistant blockchain AML tools: address risk scoring, sanctions screening, transaction and bridge tracing across 12 chains.

What you can do
  • Score and screen addresses: AML risk scores, OFAC/FATF/JFSA sanctions checks, and batch screening of up to 50 addresses
  • Trace funds: transaction flow tracing with ML anomaly detection and multi-hop cross-chain bridge tracing
  • Analyze wallets and patterns: wallet clustering via graph analysis and CoinJoin/mixing detection on Bitcoin
  • Coverage spans Bitcoin, Ethereum, Solana, TRON, XRP and several EVM chains
When to use it
Useful when an assistant needs to vet a crypto address or transaction for compliance, sanctions exposure or suspicious fund flows, or to trace funds across chains and bridges. Suited to AML/compliance checks and crypto due diligence rather than general blockchain data browsing.
Requirements
Runs locally via npx (Node.js). Needs either a ChainAnalyzer API key in CHAINANALYZER_API_KEY or a wallet private key in X402_PRIVATE_KEY for pay-per-request USDC payments; x402 mode also needs the x402 npm package. Optional X402_NETWORK (base or solana) and CHAINANALYZER_BASE_URL. Network access to the ChainAnalyzer API.
Before you install
Every tool is billed per request (roughly $0.50 to $5.00), either against a plan or as USDC micropayments. X402_PRIVATE_KEY is a wallet private key that signs payments, so it controls real funds; prefer a dedicated low-balance wallet. Addresses and transactions you submit are sent to the third-party ChainAnalyzer API. Some tools require higher plans in API-key mode.

Installation

In SourceWeft

  1. Open Chainanalyzer Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

chainanalyzer-mcp

MCP Server for ChainAnalyzer — 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

ToolDescriptionPrice
check_address_riskAML risk score for any blockchain address$1.00
sanctions_checkOFAC / FATF / JFSA sanctions screening$0.50
hack_exposure_lookupIs this address connected to a known hack (e.g. Binance 2026)? Verdict, hop distance from the attacker, role and lower-bound amounts per incident (EVM, TRON, Solana, Bitcoin)$0.50
freeze_statusIs this address frozen / blacklisted by a stablecoin issuer (USDT, USDC, JPYC ...)? Current state per token with timestamps$0.10
hack_exposure_batchKnown-hack exposure for up to 50 addresses in one call (deposit-list screening)$5.00
trace_transactionTransaction flow tracing with ML anomaly detection$3.00
detect_coinjoinCoinJoin / mixing pattern detection (Bitcoin)$1.00
cluster_walletWallet clustering via Neo4j graph analysis$2.50
batch_screeningBatch AML screening (up to 50 addresses)$5.00
bridge_flow_traceMulti-hop cross-chain forensic trace with Solver detection + same-intent correlation (NEAR Intents / Wormhole / Stargate / Across / Synapse / Hop / deBridge)$3.00

Agent framework examples

Ready-to-use tools for LangChain, OpenAI Agents SDK, Vercel AI SDK and ElizaOS (pay per call over x402 or with an API key): examples/.

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.gitcd chainanalyzer-mcpnpm installnpm start

Agent Skill & Claude Code Plugin

The repo ships an Agent Skill that tells the agent when to use these tools, how to pick the chain from the address format, which tool to call first, and how to report results. It works with any agent that reads SKILL.md (Claude Code, Cursor, Codex CLI, Gemini CLI, OpenClaw, ...).

Claude Code (plugin: MCP server + skill in one step)

/plugin marketplace add rascal-3/chainanalyzer-mcp/plugin install chainanalyzer-aml@chainanalyzer

Set CHAINANALYZER_API_KEY in your shell environment (or X402_PRIVATE_KEY for pay-per-request). The plugin's .mcp.json reads it from there.

Any other agent

Copy skills/chainanalyzer-aml/ into your agent's skills directory and configure the MCP server as shown in Quick Start.

MCP Registry

Listed in the official MCP Registry as io.github.rascal-3/chainanalyzer-mcp.

Authentication

Choose one of three modes:

1. API Key (all plans, including Free)

Create a tfk_ API key at chain-analyzer.com → Account → Settings → API Keys. Every plan can issue keys; the Free plan includes 10 scans/month, enough to try sanctions, risk, trace, CoinJoin and cluster before paying. batch_screening needs Starter or above and bridge_flow_trace needs Business or above in API-key mode (x402 mode has no plan gates). Rate limits by plan: Free 10/min, Starter 30/min, Pro 60/min, Business 120/min, Enterprise 300/min.

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

VariableDescriptionRequired
CHAINANALYZER_API_KEYtfk_ API key (any plan, Free included)One of API key or x402
X402_PRIVATE_KEYWallet private key for USDC paymentsOne of API key or x402
X402_NETWORKPayment network: base or solana (default: base)No
CHAINANALYZER_BASE_URLAPI 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

All 12 chains are live for self-serve plans.

ChainHighlights
BitcoinOFAC screening, dust attacks, peel chains, CoinJoin detection
Ethereum18+ detectors, Neo4j graph analysis, sanctions, mixers
Polygon / BNB Smart Chain / Base / Arbitrum / Optimism / Avalanche / KaiaFull EVM AML suite, bridge tracing
SolanaToken security (rug pull, honeypot), wallet drainer detection, bridge tracing
TRONUSDT flow screening, sanctions (independent scanner)
XRPExchange / issuer labels, sanctions (independent scanner)

bridge_flow_trace supports EVM chains, Solana and Kaia. detect_coinjoin is Bitcoin only.

Links

License

MIT - see LICENSE

Built by refinancier, inc.

Source: README.md at commit ef6d3cf

Tools

0
SourceWeft started this package once in an isolated sandbox, without credentials, to list its tools. That failed: the server did not start.

Version history

3
  1. v1.7.0LatestNov 3, 2026
  2. v1.5.0Oct 18, 2026
  3. v1.1.1Sep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts