# Token Holder Analysis — Distribution & Whale Detection

Token Holder Analysis — Distribution & Whale Detection is an MCP server for Claude Code that analyzes ERC-20 holder distribution, whale shares, Gini concentration, and wallet trends.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 5218 installs
- Author: axel-belfort
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/axel-belfort/token-holders
- Updated: 2026-04-12
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/token-holder-analysis-distribution-whale-detection

## What it does

This server supplies AI agents with the `token_get_holder_analysis` tool. It examines holder distribution across arbitrary ERC-20 assets, surfacing the top 10 wallets with individual percentage shares, aggregate holdings of the top tier, wallets carrying over 1% of total supply, and overall address counts. The output also covers the Gini concentration metric, smart money labels, and indications of whether the holder base is expanding or shrinking.

Traditional API keys are unnecessary because each call costs $0.005 via x402 micropayments on Base L2. The tool does not evaluate honeypot flags or rug-pull logic directly; smart contract safety checks require running `token_check_safety` instead.

## Requirements
- Remote server: `https://token-holders--axel-belfort.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http token-holders https://token-holders--axel-belfort.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add token-holder-analysis-distribution-whale-detection --url https://token-holders--axel-belfort.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "token-holder-analysis-distribution-whale-detection": {
            "url": "https://token-holders--axel-belfort.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "token-holder-analysis-distribution-whale-detection": {
            "type": "http",
            "url": "https://token-holders--axel-belfort.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http token-holder-analysis-distribution-whale-detection https://token-holders--axel-belfort.run.tools
```

## When to use it
- inspect ERC-20 ownership concentration across top addresses
- detect wallets controlling more than 1% of token supply
- calculate the Gini distribution score for asset decentralization
- monitor whether an asset holder base is expanding or shrinking

## Example prompts
- Inspect the holder distribution for ERC-20 token `0x...`
- Run `token_get_holder_analysis` to check how many whales hold over 1% supply
- Evaluate wallet concentration and smart money activity for this contract address

## Similar
- [token-holder-analysis](https://affpapa.org/en/nevibecode/skills/token-holder-analysis.md) — skill · 491 installs
- [gmgn-holder-analysis](https://affpapa.org/en/nevibecode/skills/gmgn-holder-analysis.md) — skill · 12800 installs
- [token-economics](https://affpapa.org/en/nevibecode/skills/token-economics.md) — skill · 495 installs
- [NFT Metadata — Token Image, Attributes & Collection Info](https://affpapa.org/en/nevibecode/mcp/nft-metadata-token-image-attributes-collection-info.md) — MCP server · 6157 installs
- [Warden Token Terminal](https://affpapa.org/en/nevibecode/mcp/warden-token-terminal.md) — MCP server · ★ 2 repo stars
- [query-token-audit](https://affpapa.org/en/nevibecode/skills/query-token-audit.md) — skill · 12000 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
