io.blockchainanalysis/mcp

Official8 tools

BlockchainAnalysis

Crypto compliance MCP: stablecoin-freeze, token security, wallet screening, KYT & oracle verdicts.

Screen wallets and tokens for compliance, stablecoin freezes, and crypto risk verdicts.

Captured live from the server via tools/list.

check_stablecoin_freeze

Check whether Tether (USDT) or Circle (USDC) have blacklisted a wallet address on-chain. Reads the issuer's blacklist function directly across 9 chains (ETH, BSC, POLYGON, ARBITRUM, OPTIMISM, BASE, AVALANCHE, TRON, SOL). A frozen address can no longer send or receive that stablecoin. The result reports the observed on-chain fact (frozen / not frozen at check time), never the cause of a freeze. Free.

Parameters (2)

addressstringrequired
Wallet address to check. Format must match the chain (0x… for EVM, T… for Tron, base58 for Solana).
chainstringrequired
Chain to check. One of: ETH, BSC, POLYGON, ARBITRUM, OPTIMISM, BASE, AVALANCHE, TRON, SOL

get_freeze_events

Query the canonical stablecoin freeze ledger — the HISTORY of freeze / unfreeze / destroy events by Tether (USDT), Circle (USDC/EURC), Paxos (USDP) and First Digital (FDUSD), sourced from the issuers' own on-chain blacklist events across Ethereum, Polygon, Optimism, TRON and more. Filter by frozen address, chain, kind, or time; omit all filters for the most recent events. This is the EVENT HISTORY — to check whether an address is frozen right now, use check_stablecoin_freeze instead. Each row is a verifiable on-chain fact (issuer acted on address at block/time); it never states the cause. Free.

Parameters (5)

addressstring
Filter to a single frozen wallet address (case-insensitive). Omit to list across all addresses.
chainstring
Filter by chain code, e.g. ETH, POLYGON, OPTIMISM, TRON. Omit for all chains.
kindstring
Filter by event kind: 'freeze' (blacklisted), 'unfreeze' (removed), 'destroy' (funds burned).
sincestring
Only events at/after this time. ISO 8601 or YYYY-MM-DD (UTC).
limitinteger
Max events to return (default 50, hard cap 500). Ordered newest first.

check_token_security

Simulate a buy-and-sell of an ERC-20 token on its main DEXes to surface honeypots (tokens you can buy but not sell), extreme transfer taxes, name/symbol impersonation, and active mint authority — cross-referenced against BA's 1B+ entity labels. Reports observed facts (e.g. 'sell simulation reverted'), not verdicts. Live on Base, BNB Chain, Ethereum, Optimism, Polygon, Arbitrum. No transaction is sent. Free.

Parameters (2)

tokenstringrequired
ERC-20 token contract address (0x + 40 hex).
chainstringrequired
Chain to scan. One of: BASE, BSC, ETH, OPTIMISM, POLYGON, ARBITRUM

check_token_approvals

List a wallet's active ERC-20 token approvals on Ethereum and who can move its funds — risk-scored against BA's 1B+ entity labels (scam / phishing / exploit / sanctioned spenders), flagging unlimited allowances and stale grants. The wallet's attack surface at a glance. Read-only. Ethereum only. Free.

Parameters (1)

walletstringrequired
Wallet address to scan (0x + 40 hex). Ethereum only.

list_supported_chains

List the BlockchainAnalysis MCP tools, the chains each supports, and pricing. Call this first to discover what the server can do (and which calls are free vs paid) before invoking a tool. Free.

No parameters.

screen_address

Screen a wallet against BlockchainAnalysis's 1B+ entity-label dataset: sanctions (OFAC / EU / UN / UK HMT / Swiss SECO), scam, phishing, exploit, mixer, exchange, and more — each label carries a threat level (SAFE→CRITICAL), source, and confidence. Returns the raw labels for the address. Works across major EVM chains plus TRON, SOL, and BTC. Paid per call via x402 (USDC).

Parameters (2)

addressstringrequired
Wallet address to screen (format must match the chain).
chainstringrequired
Chain ID, uppercase — e.g. ETH, BSC, POLYGON, ARBITRUM, OPTIMISM, BASE, AVALANCHE, TRON, SOL, BTC.

kyt_risk

Assess a wallet's KYT (Know-Your-Transaction) risk: combines real-time sanctions screening, BA entity classification, a VASP/jurisdiction risk score, and cluster context into a single risk verdict (critical / high / medium / low / unknown) with flags. Behavioral risk, distinct from a raw label list. Covers 11 chains: Ethereum, Bitcoin, Tron, Solana, BSC, Polygon, Arbitrum, Optimism, Base, Avalanche, Linea. Paid per call via x402 (USDC).

Parameters (2)

addressstringrequired
Wallet address to assess (format must match the chain).
chainstringrequired
Chain ID, uppercase — e.g. ETH, BTC, TRON, SOL, BSC, POLYGON, ARBITRUM, BASE.

oracle_verdict

Get a consumer-protection verdict for a wallet or contract: a normalized verdict (e.g. safe / caution / high_risk) with a 0-100 score, confidence tier, and plain-language reasons, derived from BA sanctions + entity labels. Answers 'is it safe to interact with this address?' Distinct from raw labels (screen_address) and transactional risk (kyt_risk). Supported chains: btc, eth, bsc, polygon, arbitrum, optimism, base, avalanche, fantom, tron, sol. Paid per call via x402 (USDC).

Parameters (2)

addressstringrequired
Wallet or contract address (format must match the chain).
chainstringrequired
Chain ID, lowercase — one of: btc, eth, bsc, polygon, arbitrum, optimism, base, avalanche, fantom, tron, sol

Install

claude_desktop_config.json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://blockchainanalysis.io/api/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.