`covalent_token_balances`

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

Token balances for wallet X on chain Y — every ERC-20/native token held by an address, with USD quotes. Works across 100+ chains via Covalent/GoldRush. Example: covalent_token_balances({ address: “0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045”, chain: “eth-mainnet”, _apiKey: “your-key” })

Parameters

Name	Type	Required	Description
`address`	string	yes	Wallet address (0x…), ENS name, or other supported domain
`chain`	string	no
`_apiKey`	string	yes	Covalent / GoldRush API key (free tier at goldrush.dev)

Example call

Arguments

{
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "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_balances","arguments":{"address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","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_balances', {
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "chain": "eth-mainnet",
  "_apiKey": "your-covalent-api-key"
});

More examples

{
  "address": "vitalik.eth",
  "_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_balances