Skip to main content
All on-chain tools use viem to interact with public RPC endpoints. Every tool that accepts a chain parameter defaults to ethereum if omitted.

​
get_eth_balance

Returns the native token balance (ETH, MATIC, AVAX, BNB, etc.) for an address. Parameters: address (required), chain (optional) 
{
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "balance_wei": "5688914350696581971",
  "balance_eth": "5.688914350696581971",
  "chain": "Ethereum"
}

​
is_contract

Checks whether an address is a smart contract, a regular EOA, or an EOA with EIP-7702 delegation. Parameters: address (required), chain (optional) 
{
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "is_contract": false,
  "is_eip7702": true,
  "type": "EOA with EIP-7702 delegation (has delegated code but is still an EOA)",
  "chain": "Ethereum"
}
The tool uses getBytecode() to check for deployed code. If the bytecode starts with 0xef0100, it’s identified as an EIP-7702 delegated EOA rather than a traditional contract.

​
get_token_balance

Returns an ERC-20 token balance for a wallet. Automatically resolves the token’s name, symbol, and decimals. Parameters: address (required), token_address (required), chain (optional) 
{
  "address": "0x1234...",
  "token": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
  "token_name": "USD Coin",
  "token_symbol": "USDC",
  "balance_raw": "1000000000",
  "balance_formatted": "1000.0",
  "decimals": 6,
  "chain": "Ethereum"
}

​
get_token_info

Returns metadata for an ERC-20 token contract: name, symbol, decimals, and total supply. Parameters: token_address (required), chain (optional) 
{
  "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
  "name": "USD Coin",
  "symbol": "USDC",
  "decimals": 6,
  "total_supply_raw": "25000000000000",
  "total_supply_formatted": "25000000.0",
  "chain": "Ethereum"
}

​
get_gas_price

Returns the current gas price in wei and Gwei. Parameters: chain (optional) 
{
  "gas_price_wei": "12000000",
  "gas_price_gwei": "0.0120",
  "chain": "Base"
}

​
get_block

Returns the latest block info, including number, timestamp, transaction count, and base fee. Parameters: chain (optional) 
{
  "number": 20145832,
  "timestamp": 1718464968,
  "time_iso": "2025-06-15T20:02:48.000Z",
  "hash": "0xabc123...",
  "tx_count": 142,
  "gas_used": "15000000",
  "base_fee_gwei": "0.012000",
  "chain": "Ethereum"
}

​
get_tx_count

Returns the transaction count (nonce) for an address — the total number of transactions sent. Parameters: address (required), chain (optional) 
{
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "nonce": 1423,
  "chain": "Ethereum"
}

​
resolve_ens

Resolves an ENS name to an Ethereum address. Always uses Ethereum mainnet regardless of the chain parameter. Parameters: name (required) 
{
  "name": "vitalik.eth",
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "resolved": true
}
If the name doesn’t resolve: 
{
  "name": "doesntexist.eth",
  "resolved": false,
  "error": "Name not found"
}

​
get_transaction

Retrieves transaction details by hash, including from/to, value, gas, and status. Parameters: hash (required), chain (optional) 
{
  "hash": "0xabc123...",
  "from": "0x1234...",
  "to": "0x5678...",
  "value_eth": "1.5",
  "gas": "21000",
  "block_number": 20145832,
  "status": "mined",
  "chain": "Ethereum"
}