# Token Holders API MCP server

Token holder distribution — top holders, whale count, concentration score. x402.

## Links
- Registry page: https://www.getdrio.com/mcp/io-github-br0ski777-token-holders
- Repository: https://github.com/Br0ski777/token-holders-x402
- Website: https://github.com/Br0ski777/token-holders-x402

## Install
- Endpoint: https://token-holders.api.klymax402.com/mcp
- Auth: Not captured

## Setup notes
- Remote endpoint: https://token-holders.api.klymax402.com/mcp

## Tools
- token_get_holder_analysis - Use this when you need to analyze token holder distribution and concentration risk. Returns holder metrics in JSON.

1. topHolders: array of top 10 holders with address, balance, percentage of supply
2. top10Concentration: percentage of total supply held by top 10 wallets
3. whaleCount: number of wallets holding >1% of supply
4. totalHolders: total unique holder count
5. isConcentrated: boolean flag if top 10 hold >50% supply (centralization risk)

Example output: {"topHolders":[{"address":"0xab...cd","balance":"1250000","percent":12.5}],"top10Concentration":45.2,"whaleCount":7,"totalHolders":15420,"isConcentrated":false}

Use this BEFORE buying a token to assess centralization and whale dump risk. Essential for on-chain due diligence and token research.

Do NOT use for token price data -- use token_get_ohlcv_history instead. Do NOT use for token safety -- use token_check_safety instead. Do NOT use for liquidity depth -- use dex_analyze_orderbook_depth instead. Endpoint: https://token-holders.api.klymax402.com/mcp
- token_get_holder_analysis - Use this when you need to analyze token holder distribution and concentration risk. Returns holder metrics in JSON. POST variant of token_get_holder_analysis -- same params passed as JSON body instead of query string.

1. topHolders: array of top 10 holders with address, balance, percentage of supply
2. top10Concentration: percentage of total supply held by top 10 wallets
3. whaleCount: number of wallets holding >1% of supply
4. totalHolders: total unique holder count
5. isConcentrated: boolean flag if top 10 hold >50% supply (centralization risk)

Example output: {"topHolders":[{"address":"0xab...cd","balance":"1250000","percent":12.5}],"top10Concentration":45.2,"whaleCount":7,"totalHolders":15420,"isConcentrated":false}

Use this BEFORE buying a token to assess centralization and whale dump risk. Essential for on-chain due diligence and token research.

Do NOT use for token price data -- use token_get_ohlcv_history instead. Do NOT use for token safety -- use token_check_safety instead. Do NOT use for liquidity depth -- use dex_analyze_orderbook_depth instead. Endpoint: https://token-holders.api.klymax402.com/mcp

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: io.github.Br0ski777
- Version: 1.1.0
- Runtime: Sse
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: May 16, 2026
- Source: https://registry.modelcontextprotocol.io