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
claude mcp add --transport http token-holders https://token-holders--axel-belfort.run.toolsWhat 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_analysisto 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.toolsPlatform CLI: remote server
codex mcp add token-holder-analysis-distribution-whale-detection --url https://token-holders--axel-belfort.run.toolsConfig file
{
"mcpServers": {
"token-holder-analysis-distribution-whale-detection": {
"url": "https://token-holders--axel-belfort.run.tools"
}
}
}Config file
{
"servers": {
"token-holder-analysis-distribution-whale-detection": {
"type": "http",
"url": "https://token-holders--axel-belfort.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http token-holder-analysis-distribution-whale-detection https://token-holders--axel-belfort.run.toolsStep 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.