MistTrack MCP Server

MistTrack MCP Server connects MCP clients such as Claude Desktop to the MistTrack OpenAPI. It lets an AI assistant query blockchain addresses and transactions for labels, balances, profiles, counterparties, risk scores, malicious fund signals, and fund-flow traces.

Features

• Address detection for common chains and token formats
• Address labels, overview, profile, action, and counterparty analysis
• MistTrack Risk Score V3.0 for address and transaction hash checks
• Malicious fund checks based on MistTrack threat intelligence
• Recursive multi-layer transaction investigation
• MistTrack dashboard and chain explorer URL generation
• Built-in MCP resources and prompts for risk analysis workflows

Requirements

• Node.js 18 or newer
• A MistTrack API key
• A MistTrack plan that supports OpenAPI access

Get an API key from the MistTrack dashboard: https://dashboard.misttrack.io/apikeys

Installation

Use the package directly through npx:

npx -y misttrack@latest --key YOUR_MISTTRACK_API_KEY

Or install it globally:

npm install -g misttrack
misttrack --key YOUR_MISTTRACK_API_KEY

You can also provide the API key through the environment:

export MISTTRACK_API_KEY=YOUR_MISTTRACK_API_KEY
npx -y misttrack@latest

Claude Desktop Configuration

Add the server to your Claude Desktop MCP configuration:

{
  "mcpServers": {
    "misttrack": {
      "command": "npx",
      "args": [
        "-y",
        "misttrack@latest",
        "--key",
        "YOUR_MISTTRACK_API_KEY"
      ]
    }
  }
}

Restart Claude Desktop after changing the configuration.

Command Options

Tools

Tool names below are the server-side MCP tool names. Some clients display them with a server prefix, such as mcp_misttrack_get_risk_score.

Risk Score

get_risk_score uses MistTrack's official GET /v3/risk_score endpoint.

{
  coin: string;                       // Example: ETH, BTC, USDT-TRC20
  address?: string;                   // Provide either address or txid
  txid?: string;                      // Provide either txid or address
  direction?: 'deposit' | 'withdraw'; // Only used for txid queries, default: deposit
}

Important response fields:

Risk level guide:

Example prompts:

Assess the ETH risk score for address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045.

Check the risk score for this ETH transaction hash using withdraw direction: [TX_HASH]

Recursive Transaction Analysis

analyze_transactions_recursive builds a compact multi-layer transaction graph for fund tracing.

{
  coin: string;
  address: string;
  max_depth?: number;                  // 1-3, default: 1
  start_timestamp?: number;
  end_timestamp?: number;
  transaction_type?: 'in' | 'out' | 'all';
}

It can identify labeled counterparties, important risk entities, label statistics, and traceable fund-flow paths.

Example:

Analyze potential BTC fund flows for 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa with a depth of 2.

Supported Coins

MistTrack supports many chains and token formats. Common examples include:

• Ethereum: ETH, USDT-ERC20, USDC-ERC20, WETH-ERC20
• Bitcoin: BTC
• TRON: TRX, USDT-TRC20, USDC-TRC20
• BNB Smart Chain: BNB, USDT-BEP20, USDC-BEP20
• Polygon: POL-Polygon, USDT-Polygon, USDC-Polygon
• Avalanche: AVAX-Avalanche, USDT-Avalanche, USDC-Avalanche
• Arbitrum, Optimism, Base, zkSync, Merlin, Toncoin, Solana, Litecoin, Dogecoin, Bitcoin Cash, HashKey Chain, and Sui

For the latest full list, see the official MistTrack documentation: https://docs.misttrack.io/openapi/overview

Example Workflows

Address label lookup

Check the labels for this Ethereum address: [ETH_ADDRESS]

Address overview

Analyze the overview information for this Bitcoin address: [BTC_ADDRESS]

Counterparty analysis

Analyze the counterparties of this address: [ETH_ADDRESS]

Exchange fund-flow tracing

Track fund flow between this address and exchanges with depth 2: [ETH_ADDRESS]

Malicious fund detection

Check whether this address has malicious fund exposure: [ETH_ADDRESS]

Local Development

Install dependencies:

npm install

Build TypeScript:

npm run build

Run locally:

npm run dev -- --key YOUR_MISTTRACK_API_KEY

Official Documentation

• MistTrack Docs: https://docs.misttrack.io/
• OpenAPI overview: https://docs.misttrack.io/openapi/overview
• Risk Score V3.0: https://docs.misttrack.io/api-endpoints/get-risk-score-v3