What it does
The tool takes a token contract address and an optional chain (base or ethereum) and returns the ten largest holders with their balances and share of supply. It also reports the percentage of supply held by the top ten wallets, the number of wallets holding more than 1% of supply, the total count of unique holders, and a flag that is set when the top ten hold more than 50%.
It is intended for checking centralisation and whale sell-off risk before buying a token, as part of on-chain research. The publisher directs users to other tools for price history, token safety checks and liquidity depth.
It is available as an MCP tool and as an HTTP endpoint (/api/holders) accepting GET or POST requests. Each call is paid in USDC on Base L2 using the x402 protocol, and x402-aware clients handle the payment step automatically.
Limitations and requirements
Each call is paid in USDC on Base L2 through the x402 protocol, so the client must be x402-aware to complete the payment step. The required input is a token contract address. The chain parameter accepts only base or ethereum.
Safety
Our team has not reviewed this resource. Only automated rules checked it; resources with high-risk signals are not published. These are signals, not a guarantee that installing it is safe. Try it in a sandbox project first.
- Runs code or changes an assistant's behaviour
Sources
- Official MCP Registry first seen 13 Nov 2026 · last seen 13 Nov 2026 · its page on the source
Token Holders API
Token holder distribution — top holders, whale count, concentration score. x402.
v1.1.0As shown on registry.modelcontextprotocol.io when we last read it