Server data from the Official MCP Registry
Token holder distribution — top holders, whale count, concentration score. x402.
About
Token holder distribution — top holders, whale count, concentration score. x402.
Remote endpoints: sse: https://token-holders.api.klymax402.com/mcp
Security Report
Valid MCP server (1 strong, 0 medium validity signals). 5 known CVEs in dependencies Imported from the Official MCP Registry. Trust signals: trusted author (174/179 approved).
1 tool verified · Open access · 5 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
How to Connect
Remote Plugin
No local installation needed. Your AI client connects to the remote endpoint directly.
Add this to your MCP configuration to connect:
{
"mcpServers": {
"io-github-br0ski777-token-holders": {
"url": "https://token-holders.api.klymax402.com/mcp"
}
}
}Documentation
View on GitHubFrom the project's GitHub README.
Token Holders API
Token holder distribution -- top holders, concentration %, whale count. On-chain due diligence for agents. Pay-per-call via x402 (USDC on Base L2) -- no API key, no signup, no rate-limit wall.
Part of the klymax402 marketplace -- 100 x402 micropayment APIs for AI agents, one wallet, USDC on Base.
Quickstart -- MCP
Add to your MCP client config (Claude Desktop, Cursor, ElizaOS, etc.):
{
"mcpServers": {
"token-holders": {
"url": "https://token-holders.api.klymax402.com/mcp"
}
}
}
Quickstart -- HTTP (x402)
curl "https://token-holders.api.klymax402.com/api/holders?address=0x0000000000000000000000000000000000dEaD"
# -> 402 Payment Required, with an x402 payment challenge in the response body
Any x402-aware client (@x402/fetch, x402-agent-tools, ATXP) handles the 402 -> sign -> retry cycle automatically.
Tools
| Tool | Method | Path | Price | Description |
|---|---|---|---|---|
token_get_holder_analysis | GET | /api/holders | $0.012 | Get token holder analysis with concentration metrics |
token_get_holder_analysis | POST | /api/holders | $0.012 | Get token holder analysis with concentration metrics (POST variant) |
token_get_holder_analysis
Use this when you need to analyze token holder distribution and concentration risk. Returns holder metrics in JSON.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
address | string | yes | Token contract address (0x...) |
chain | string | no | Chain: base, ethereum (default: ethereum) |
Returns
topHolders-- array of top 10 holders with address, balance, percentage of supplytop10Concentration-- percentage of total supply held by top 10 walletswhaleCount-- number of wallets holding >1% of supplytotalHolders-- total unique holder countisConcentrated-- boolean flag if top 10 hold >50% supply (centralization risk)
Example response:
{"topHolders":[{"address":"0xab...cd","balance":"1250000","percent":12.5}],"top10Concentration":45.2,"whaleCount":7,"totalHolders":15420,"isConcentrated":false}
When to use: buying a token to assess centralization and whale dump risk. Essential for on-chain due diligence and token research.
Not for: token price data (use token_get_ohlcv_history), token safety (use token_check_safety), liquidity depth (use dex_analyze_orderbook_depth).
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.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
address | string | yes | Token contract address (0x...) |
chain | string | no | Chain: base, ethereum (default: ethereum) |
Returns
topHolders-- array of top 10 holders with address, balance, percentage of supplytop10Concentration-- percentage of total supply held by top 10 walletswhaleCount-- number of wallets holding >1% of supplytotalHolders-- total unique holder countisConcentrated-- boolean flag if top 10 hold >50% supply (centralization risk)
Example response:
{"topHolders":[{"address":"0xab...cd","balance":"1250000","percent":12.5}],"top10Concentration":45.2,"whaleCount":7,"totalHolders":15420,"isConcentrated":false}
When to use: buying a token to assess centralization and whale dump risk. Essential for on-chain due diligence and token research.
Not for: token price data (use token_get_ohlcv_history), token safety (use token_check_safety), liquidity depth (use dex_analyze_orderbook_depth).
Example agent prompts
- "Analyze token holder distribution and concentration risk"
- "Analyze token holder distribution and concentration risk"
Payment
- Protocol: x402 -- HTTP-native pay-per-call, no signup, no API key
- Network: Base L2 (
eip155:8453) - Asset: USDC
- Facilitator: Coinbase CDP (primary), PayAI (fallback)
Part of klymax402
100 x402 micropayment APIs for AI agents -- one wallet, USDC on Base, zero signup.
- Catalog: https://klymax402.com/llms.txt
- Full API reference: https://klymax402.com/llms-full.txt
- Live stats: https://klymax402.com/stats
License
MIT
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Fetch
Freeby Modelcontextprotocol · Developer Tools
Web content fetching and conversion for efficient LLM usage
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.