Skip to main content
MCP server CX Codex

Token Holder Analysis — Claude Code MCP server: setup & features

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.

no license 5,218 installs updated 2026-04-12

Install into Claude Code · Platform CLI: remote server All methods and platforms ↓
claude mcp add --transport http token-holders https://token-holders--axel-belfort.run.tools
Open on GitHub

What Token Holder Analysis — Distribution & Whale Detection 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.

What it helps with

  • 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 for the agent

  • 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

How to install Token Holder Analysis — Distribution & Whale Detection

Platform CLI: remote server

claude mcp add --transport http token-holders https://token-holders--axel-belfort.run.tools

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about Token Holder Analysis — Distribution & Whale Detection

How to install Token Holder Analysis in Claude Code?

Run claude mcp add --transport http token-holders https://token-holders--axel-belfort.run.tools in your terminal.

What does this MCP server do?

It adds the token_get_holder_analysis tool so your assistant can pull top holder percentages, whale tallies, Gini concentration scores, and trend stats for ERC-20 tokens.

Does the server require an API key?

No API key is needed, but each query requires a $0.005 x402 micropayment settled on Base L2.

Similar MCP servers

All MCP servers for Finance and business →

Project sponsors

Companies that keep this analytics open