• SUPPLY
  • HOLDERS
  • ANALYSIS
  • HUMAN

How to audit IoTeX token distributions with your AI

Connect your AI to the IoTeX Block Explorer API. Once linked, your agent can pull real-time supply and holder data for any XRC20 or XRC721 asset.

Ask AI about this page

Short answer

How can I audit IoTeX token distributions with my AI?

Your agent uses the IoTeX Block Explorer API to fetch token supply and current holder lists for XRC20 and XRC721 assets. You'll get a clear view of wallet concentration and supply status.

Audit outcomes

What you'll find

The data your agent pulls from the blockchain.

SUPPLY

Total supply data

The AI retrieves the exact supply for a specific XRC20 or XRC721 token. You'll see the total amount currently in existence.

HOLDERS

Wallet concentration

Your agent identifies the addresses holding the most tokens. This helps you spot if a few wallets control most of the supply.

ANALYSIS

Distribution reports

The AI organizes holder balances into a list. You can then ask your agent to calculate the percentage of supply held by top wallets.

HUMAN

Risk assessment

The AI provides the raw holder data, but you must decide if the distribution looks suspicious or centralized.

The workflow

What your AI does when the request arrives.

Your agent acts as the interface between your chat and the IoTeX blockchain.

  1. Fetch token info

    The AI pulls the specific supply and metadata for the requested asset.

    get_token

  2. List holders

    Your agent queries the blockchain to find the current list of wallet addresses holding the token.

    get_token_holders

  3. Identify whales

    The AI scans the holder list to find the largest balances.

    get_token_holders

  4. Summarize supply

    The agent compiles the token data into a summary you can act on.

    get_token

Try it

Copy these to start.

Use these prompts to begin your audit.

Starting points

Swap the bracketed text for the actual token address you want to check.

IoTeX Connector

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

Connector linkhttps://edge.vinkius.com/vk_preview_uf7FWJCYEdHc7dZYspdM00lNFsp7Ox3HGLZtw794/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 — IoTeX capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "iotex-iotex-block-explorer-api-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_uf7FWJCYEdHc7dZYspdM00lNFsp7Ox3HGLZtw794/mcp"
    }
  }
}
Copy into chat04

  • Get the total supply for the XRC20 token at [address].

  • Who are the top 5 holders for the token at [address]?

  • List all holders for the XRC721 asset at [address].

  • Analyze the distribution for [address] and tell me if any wallet holds more than 10%.

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

Start here

Connect IoTeX once, then ask.

Link the IoTeX MCP to your client. Your credentials stay encrypted, and you can start querying the blockchain immediately.

Connect IoTeX to your AI

FAQ

How this task behaves

  • 01

    Can the AI move tokens or execute trades?

    No. This MCP is read-only. It can only pull data from the IoTeX Block Explorer.

  • 02

    Can I audit any asset on IoTeX?

    Yes, provided it is an XRC20 or XRC721 asset.

  • 03

    Does the AI handle private keys?

    No. The AI never needs or touches your private keys to pull blockchain data.

  • 04

    Can the AI change token ownership?

    No. The AI cannot modify any data on the blockchain; it only reads what is already there.

  • 05

    Can the AI identify the real-world identity of a holder?

    No. The AI can only see the public wallet addresses and their balances.

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

Connect IoTeX to Claude, Cursor, ChatGPT & more