`get_balance`

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

Native-token balance for an address on a supported EVM chain. Defaults to Ethereum mainnet. Accepts chain by slug (ethereum, polygon, bsc, base, arbitrum, optimism, avalanche, fantom, gnosis, linea, scroll, zksync, blast, mantle) or numeric chain ID.

Parameters

Name	Type	Required	Description
`address`	string	yes	0x address
`chain`	string	no	Chain slug or numeric chain ID (default ethereum)

Example call

Arguments

{
  "address": "0x1234567890123456789012345678901234567890"
}

curl

curl -X POST https://gateway.pipeworx.io/etherscan/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_balance","arguments":{"address":"0x1234567890123456789012345678901234567890"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('get_balance', {
  "address": "0x1234567890123456789012345678901234567890"
});

More examples

{
  "address": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcd",
  "chain": "polygon"
}

Response shape

Always returns: chain_id, chain_name, address, wei, balance, symbol

Field	Type	Description
`chain_id`	number	Numeric chain ID
`chain_name`	string \| null	Human-readable chain name or null
`address`	string	The queried address
`wei`	string	Balance in wei (raw units)
`balance`	string	Formatted balance with decimals
`symbol`	string \| null	Native token symbol or null

Full JSON Schema

{
  "type": "object",
  "properties": {
    "chain_id": {
      "type": "number",
      "description": "Numeric chain ID"
    },
    "chain_name": {
      "type": [
        "string",
        "null"
      ],
      "description": "Human-readable chain name or null"
    },
    "address": {
      "type": "string",
      "description": "The queried address"
    },
    "wei": {
      "type": "string",
      "description": "Balance in wei (raw units)"
    },
    "balance": {
      "type": "string",
      "description": "Formatted balance with decimals"
    },
    "symbol": {
      "type": [
        "string",
        "null"
      ],
      "description": "Native token symbol or null"
    }
  },
  "required": [
    "chain_id",
    "chain_name",
    "address",
    "wei",
    "balance",
    "symbol"
  ]
}

Connect

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

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

See Getting Started for client-specific install steps.

get_balance