• DATA
  • MONITORING
  • AUDIT
  • HUMAN

How to analyze token holder distribution with your AI

Connect your agent to the ZetaChain blockchain to monitor wallet concentrations and movement patterns.

Ask AI about this page

Short answer

How can I use my AI to check token holder distribution?

Your agent uses the ZetaChain Explorer API to fetch specific token data and wallet lists. It then calculates concentration levels and tracks recent transfers to identify large holders. You'll get a clear picture of ownership concentration.

The outcomes

What you get from the analysis

The AI turns raw blockchain data into clear ownership insights.

DATA

Concentration reports

The agent identifies top wallets and calculates what percentage of the supply they hold. You'll see exactly how centralized a token is.

MONITORING

Whale movement alerts

By pulling transfer history, your agent spots large shifts in ownership. You'll know when major holders move assets.

AUDIT

Holder lists

The agent pulls lists of addresses holding a specific token. This helps you verify the legitimacy of a project's distribution.

HUMAN

Risk assessment

The AI provides the raw data and patterns, but you decide if the concentration poses a risk. You make the final call on whether to act.

The workflow

What your AI does when the request arrives.

The agent moves from basic token info to deep holder analysis through a series of API calls.

  1. Identify the token

    The agent first pulls the basic contract details and metadata for the specific token you want to check.

    get_token

  2. Fetch the holders

    Once the token is identified, the agent pulls the list of all addresses currently holding that asset.

    get_token_holders

  3. Track movement

    The agent looks at recent transaction logs to see how tokens are moving between wallets.

    get_token_transfers

  4. Calculate concentration

    The agent aggregates the data to show you exactly how much of the supply is held by the top wallets.

    get_token_holders

Try it

Copy these to start.

Use these prompts to kick off your analysis.

Starting points

Replace the token addresses in these prompts with the actual contract addresses you want to check.

ZetaChain Explorer Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_FxFPARpDsAcntF5AhDfsxYeqUUw9oVG4fSfBSSlY/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — ZetaChain Explorer capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "zetachain-explorer-zetachain-block-explorer-api-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_FxFPARpDsAcntF5AhDfsxYeqUUw9oVG4fSfBSSlY/mcp"
    }
  }
}
Copy into chat04

  • Get the holder list for token 0x123... and tell me the top 5 wallets.

  • Check the transfer history for token 0xabc... to see if any large wallets moved funds today.

  • Analyze the concentration of token 0x789... and tell me if it's too centralized.

  • List all holders for token 0xdef... and calculate the total percentage held by the top 10 addresses.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Zetachain Explorer once, then ask.

Just link the MCP to your client. Your credentials stay encrypted, and you can start asking questions immediately.

Connect Zetachain Explorer to your AI

FAQ

How this task behaves

  • 01

    Can the AI execute trades based on the holder data?

    No. This MCP only reads data from the blockchain. It cannot send transactions or execute trades.

  • 02

    Can the AI change the token's ownership or settings?

    No. The tools are strictly for querying existing blockchain data.

  • 03

    How recent is the transfer history?

    The agent pulls the most recent transfer data available through the ZetaChain Explorer API.

  • 04

    Does the AI store my wallet private keys?

    No. This MCP does not require or store private keys, as it only performs read-only queries.

  • 05

    Can I use this to track any token on ZetaChain?

    Yes, as long as the token is indexed and accessible via the ZetaChain Explorer API.

  • More questions about Zetachain Explorer? The Connector page answers them. See everything the Zetachain Explorer Connector can do

Connect ZetaChain Explorer to Claude, Cursor, ChatGPT & more