br0ski777 avatar

Token Holders API

br0ski777/token-holders-x402

Gives Claude access to blockchain token holder analytics through a dedicated API. You get top holder lists, whale counts, and concentration scores to analyze token distribution patterns. Useful when you're researching crypto projects, assessing decentralization risk, or building investment tools that need on-chain holder data. The server connects via SSE transport to a hosted endpoint at klymax402.com, so no local blockchain node required. Reach for this when you need to quickly surface who holds what and how concentrated ownership is without writing your own chain queries.

tool
1
transport
SSE
last updated
May 16, 2026

Tools

1 tools

Public tool metadata for what this MCP can expose to an agent.

token_get_holder_analysisUse this when you need to analyze token holder distribution. Returns top 10 holders with percentages, concentration metrics (top 10 hold X%), whale count (holders with >1% supply), and total holder co2 params

Use this when you need to analyze token holder distribution. Returns top 10 holders with percentages, concentration metrics (top 10 hold X%), whale count (holders with >1% supply), and total holder co

Parameters* required
addressstring
Token contract address (0x...)
chainstring
Chain: base, ethereum (default: base)

Sponsors

Readme

Token Holders API

MCP Server x402 License: MIT

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

View the full README on GitHub

Details

Repository
github.com/br0ski777/token-holders-x402
Website
github.com/Br0ski777/token-holders-x402
Transport
SSE
Registry
MCP registry, active

More from br0ski777