`covalent_token_holders`

Pack: covalent · Endpoint: https://gateway.pipeworx.io/covalent/mcp

Top holders of token X on chain Y — the largest wallet holders of an ERC-20 token contract, with balances. Works across 100+ chains via Covalent/GoldRush. Example: covalent_token_holders({ token_address: “0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48”, chain: “eth-mainnet”, _apiKey: “your-key” })

Parameters

Name	Type	Required	Description
`token_address`	string	yes	ERC-20 token contract address (0x…)
`chain`	string	no
`_apiKey`	string	yes	Covalent / GoldRush API key (free tier at goldrush.dev)

Example call

Arguments

{
  "token_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
  "chain": "eth-mainnet",
  "_apiKey": "your-covalent-api-key"
}

curl

curl -X POST https://gateway.pipeworx.io/covalent/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"covalent_token_holders","arguments":{"token_address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","chain":"eth-mainnet","_apiKey":"your-covalent-api-key"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('covalent_token_holders', {
  "token_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
  "chain": "eth-mainnet",
  "_apiKey": "your-covalent-api-key"
});

More examples

{
  "token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
  "_apiKey": "your-covalent-api-key"
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "covalent": {
      "url": "https://gateway.pipeworx.io/covalent/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

covalent_token_holders