MistTrack MCP Server

April 28, 2026 · View on GitHub

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

Option	Description	Default
`-k, --key <key>`	MistTrack API key	`MISTTRACK_API_KEY`
`-u, --base-url <url>`	MistTrack API base URL	`https://openapi.misttrack.io`
`-r, --rate-limit <limit>`	API request rate limit, requests per second	`1.0`
`-m, --max-retries <retries>`	Maximum retry count for retryable API errors	`3`
`-d, --retry-delay <delay>`	Initial retry delay in seconds	`1.0`
`-b, --retry-backoff <backoff>`	Retry backoff multiplier	`2.0`

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.

Tool	Purpose
`detect_address_chain`	Detect likely chains and token formats from an address
`get_address_labels`	Get MistTrack labels for an address
`get_address_overview`	Get address balance, transaction statistics, and formatted overview
`get_address_action`	Get transaction action analysis for an address
`get_address_trace`	Get address profile, interacted platforms, and threat intelligence
`get_address_counterparty`	Get address counterparty analysis
`check_malicious_funds`	Check malicious fund signals from address threat intelligence
`get_risk_score`	Get MistTrack Risk Score V3.0 for an address or transaction hash
`get_dashboard_url`	Generate a MistTrack dashboard URL
`get_chain_explorer_url`	Generate a blockchain explorer URL for an address or transaction hash
`get_url_info`	Return both MistTrack dashboard and explorer URLs
`analyze_transactions_recursive`	Recursively analyze transaction relationships and fund-flow paths

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:

Field	Description
`score`	Risk score returned by MistTrack
`risk_level`	`Low`, `Moderate`, `High`, or `Severe`
`detail_list`	Human-readable risk indicators
`risk_detail`	Detailed risk exposure records used in scoring
`risk_detail[].hop_dic`	Hop-level fund-flow path between the queried target and risk entity
`address_label`	Entity label for the queried address, or from/to address label for txid queries
`risk_report_url`	MistTrack AML risk report URL

Risk level guide:

Level	Score	Suggested operation
`Severe`	`91-100`	Prohibit withdrawals and trading, report immediately
`High`	`71-90`	Maintain high-level surveillance and perform deeper investigation
`Moderate`	`31-70`	Apply moderate supervision
`Low`	`0-30`	Minimal supervision

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]

Label Check Example

Address overview

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

Address Overview Example

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]

Exchange Fund Flow

Malicious fund detection

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

Malicious Fund Detection

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