Enables AI agents to perform multi-chain blockchain AML risk analysis, sanctions screening, and transaction tracing across 12 different networks.
Also known as rascal-3/chainanalyzer-mcp
- Stars
- 1
- Tools
- 10
- Downloads, 30 days
- —
- Latest version
- 1.7.0
- Last commit
- Nov 12, 2026
- License
- MIT
What is ChainAnalyzer MCP?
ChainAnalyzer enables AI agents to perform multi-chain blockchain AML risk analysis, sanctions screening, and transaction tracing across 12 different networks. It exposes 10 tools, such as check_address_risk, sanctions_check, hack_exposure_lookup.
Summary generated from the project's README
About ChainAnalyzer MCP server
Performing multi-chain blockchain AML risk analysis and sanctions screening from inside an AI agent is what this server enables. It allows developers to integrate forensic capabilities across 12 different networks, including Bitcoin, Ethereum, Solana, and various EVM chains like Polygon and Arbitrum. Users can deploy this via Claude Desktop, Claude Code, or through agent frameworks like LangChain and ElizaOS.
Security professionals and developers can access specialized tools such as check_address_risk for AML scoring, sanctions_check for OFAC or FATF compliance, and bridge_flow_trace for cross-chain forensic tracing. The server supports different authentication methods, including a standard API key or a pay-per-request model using USDC via the x402 protocol on Base or Solana.
Advanced features include Neo4j graph analysis for wallet clustering and machine learning anomaly detection for transaction tracing. The system provides specific detection for Bitcoin CoinJoin patterns and can identify if an address is connected to known hacks or has been frozen by stablecoin issuers like USDT or USDC.
What you can do with it
- 1Verify address complianceAsk your agent to check if a specific Ethereum address is listed on international sanctions lists.
- 2Investigate hack exposureDetermine if a wallet has any direct or indirect connection to a major security breach.
- 3Trace cross-chain movementsFollow the movement of funds as they move through different bridges and networks.
- 4Bulk AML screeningPerform compliance checks on a large list of addresses simultaneously to ensure they are not high risk.
Written from the project's README. Every use case is checked against a quote from it.
How to install ChainAnalyzer MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall ChainAnalyzer MCP in Claude Code
$ claude mcp add --env 'CHAINANALYZER_API_KEY=<YOUR_CHAINANALYZER_API_KEY>' --env 'X402_PRIVATE_KEY=<YOUR_X402_PRIVATE_KEY>' chainanalyzer-mcp -- npx -y chainanalyzer-mcpInstall ChainAnalyzer MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"chainanalyzer-mcp": {
"command": "npx",
"args": [
"-y",
"chainanalyzer-mcp"
],
"env": {
"CHAINANALYZER_API_KEY": "<YOUR_CHAINANALYZER_API_KEY>",
"X402_PRIVATE_KEY": "<YOUR_X402_PRIVATE_KEY>"
}
}
}
}Install ChainAnalyzer MCP in VS Code
.vscode/mcp.json
{
"servers": {
"chainanalyzer-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"chainanalyzer-mcp"
],
"env": {
"CHAINANALYZER_API_KEY": "<YOUR_CHAINANALYZER_API_KEY>",
"X402_PRIVATE_KEY": "<YOUR_X402_PRIVATE_KEY>"
}
}
}
}Install ChainAnalyzer MCP in VS Code CLI
$ code --add-mcp '{"name":"chainanalyzer-mcp","type":"stdio","command":"npx","args":["-y","chainanalyzer-mcp"],"env":{"CHAINANALYZER_API_KEY":"<YOUR_CHAINANALYZER_API_KEY>","X402_PRIVATE_KEY":"<YOUR_X402_PRIVATE_KEY>"}}'Install ChainAnalyzer MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"chainanalyzer-mcp": {
"command": "npx",
"args": [
"-y",
"chainanalyzer-mcp"
],
"env": {
"CHAINANALYZER_API_KEY": "<YOUR_CHAINANALYZER_API_KEY>",
"X402_PRIVATE_KEY": "<YOUR_X402_PRIVATE_KEY>"
}
}
}
}Install ChainAnalyzer MCP in Codex
$ codex mcp add chainanalyzer-mcp --env 'CHAINANALYZER_API_KEY=<YOUR_CHAINANALYZER_API_KEY>' --env 'X402_PRIVATE_KEY=<YOUR_X402_PRIVATE_KEY>' -- npx -y chainanalyzer-mcpInstall ChainAnalyzer MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.chainanalyzer-mcp] command = "npx" args = ["-y", "chainanalyzer-mcp"] [mcp_servers.chainanalyzer-mcp.env] CHAINANALYZER_API_KEY = "<YOUR_CHAINANALYZER_API_KEY>" X402_PRIVATE_KEY = "<YOUR_X402_PRIVATE_KEY>"
Install ChainAnalyzer MCP in Gemini CLI
$ gemini mcp add -s user -e 'CHAINANALYZER_API_KEY=<YOUR_CHAINANALYZER_API_KEY>' -e 'X402_PRIVATE_KEY=<YOUR_X402_PRIVATE_KEY>' chainanalyzer-mcp npx -- -y chainanalyzer-mcpInstall ChainAnalyzer MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"chainanalyzer-mcp": {
"command": "npx",
"args": [
"-y",
"chainanalyzer-mcp"
],
"env": {
"CHAINANALYZER_API_KEY": "<YOUR_CHAINANALYZER_API_KEY>",
"X402_PRIVATE_KEY": "<YOUR_X402_PRIVATE_KEY>"
}
}
}
}ChainAnalyzer MCP tools 10
Detected from the READMEcheck_address_risksanctions_checkhack_exposure_lookupfreeze_statushack_exposure_batchtrace_transactiondetect_coinjoincluster_walletbatch_screeningbridge_flow_trace
| check_address_risk | — | |
| sanctions_check | — | |
| hack_exposure_lookup | — | |
| freeze_status | — | |
| hack_exposure_batch | — | |
| trace_transaction | — | |
| detect_coinjoin | — | |
| cluster_wallet | — | |
| batch_screening | — | |
| bridge_flow_trace | — |
Configuration
CHAINANALYZER_API_KEYSecretChainAnalyzer API key (tfk_...) for subscription billing (Pro plan or higher). Use this or X402_PRIVATE_KEY.
X402_PRIVATE_KEYSecretWallet private key used to sign x402 USDC micropayments (pay-per-request mode, no account needed). Use this or CHAINANALYZER_API_KEY.
CHAINANALYZER_BASE_URLOverride the API base URL (default: https://chain-analyzer.com)
X402_NETWORKx402 payment network: base (default) or solana
| Name | Description | |
|---|---|---|
| CHAINANALYZER_API_KEY | ChainAnalyzer API key (tfk_...) for subscription billing (Pro plan or higher). Use this or X402_PRIVATE_KEY. | Secret |
| X402_PRIVATE_KEY | Wallet private key used to sign x402 USDC micropayments (pay-per-request mode, no account needed). Use this or CHAINANALYZER_API_KEY. | Secret |
| CHAINANALYZER_BASE_URL | Override the API base URL (default: https://chain-analyzer.com) | |
| X402_NETWORK | x402 payment network: base (default) or solana |
Automated checks
Ran Nov 13, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablePass
- Open source license (OSI)Pass
- Commit or release in the last yearPass
- Package name not close to a popular packagePass
- Remote endpoint uses HTTPSNot checked
- Destructive tools are labelledPass
- No hidden instructions to the modelPass
- No critical advisory in the package or its dependenciesPass
README
View on GitHubchainanalyzer-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
| Tool | Description | Price |
|---|---|---|
check_address_risk |
AML risk score for any blockchain address | $1.00 |
sanctions_check |
OFAC / FATF / JFSA sanctions screening | $0.50 |
hack_exposure_lookup |
Is 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_status |
Is this address frozen / blacklisted by a stablecoin issuer (USDT, USDC, JPYC ...)? Current state per token with timestamps | $0.10 |
hack_exposure_batch |
Known-hack exposure for up to 50 addresses in one call (deposit-list screening) | $5.00 |
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 |
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:
{
"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
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.
{
"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 (any plan, Free included) |
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
All 12 chains are live for self-serve plans.
| Chain | Highlights |
|---|---|
| Bitcoin | OFAC screening, dust attacks, peel chains, CoinJoin detection |
| Ethereum | 18+ detectors, Neo4j graph analysis, sanctions, mixers |
| Polygon / BNB Smart Chain / Base / Arbitrum / Optimism / Avalanche / Kaia | Full EVM AML suite, bridge tracing |
| Solana | Token security (rug pull, honeypot), wallet drainer detection, bridge tracing |
| TRON | USDT flow screening, sanctions (independent scanner) |
| XRP | Exchange / issuer labels, sanctions (independent scanner) |
bridge_flow_trace supports EVM chains, Solana and Kaia. detect_coinjoin is Bitcoin only.
Links
- ChainAnalyzer — Web platform
- Using ChainAnalyzer from AI agents — skill, plugin and MCP setup guide
- API reference
- x402 Protocol — Pay-per-request standard
License
MIT - see LICENSE
Built by refinancier, inc.
ChainAnalyzer MCP questions
How do I add ChainAnalyzer MCP to Claude Code?
Run claude mcp add --env 'CHAINANALYZER_API_KEY=<YOUR_CHAINANALYZER_API_KEY>' --env 'X402_PRIVATE_KEY=<YOUR_X402_PRIVATE_KEY>' chainanalyzer-mcp -- npx -y chainanalyzer-mcp in your terminal. Add --scope user to make it available in every project.
How do I add ChainAnalyzer MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does ChainAnalyzer MCP provide?
It exposes 10 tools, including check_address_risk, sanctions_check, hack_exposure_lookup, freeze_status, hack_exposure_batch.
Which blockchain networks are supported?
The server supports 12 chains: Bitcoin, Ethereum, Polygon, BNB Smart Chain, Base, Arbitrum, Optimism, Avalanche, Solana, Kaia, TRON, and XRP.
Does the free plan include any features?
Yes, the Free plan includes 10 scans per month and allows you to test sanctions, risk, trace, CoinJoin, and clustering tools.