get_balance
Query the balance of an Ethereum address in wei using the Arbitrum MCP Server. Input the address and optional RPC URL to retrieve account balance details.
Instructions
Get balance of an address in wei
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| address | Yes | Ethereum address to check balance for | |
| rpcUrl | No | The RPC URL of the chain (optional if default is set) |
Implementation Reference
- src/index.ts:234-250 (handler)The core handler logic for the 'get_balance' MCP tool. Resolves the RPC endpoint using provided rpcUrl or chainName via ChainLookupService, instantiates EthereumAccountClient, calls getBalance(address) to fetch wei balance via eth_getBalance RPC, and formats response as text content.case "get_balance": { const rpcUrl = await this.resolveRpcUrl( (args.rpcUrl as string) || (args.chainName as string) ); const ethereumAccountClient = new EthereumAccountClient(rpcUrl); const balance = await ethereumAccountClient.getBalance( args.address as string ); return { content: [ { type: "text", text: `Balance: ${balance} wei`, }, ], }; }
- src/index.ts:943-961 (registration)Tool registration in getAvailableTools() method returned by ListToolsRequestSchema handler. Defines name, description, and inputSchema for 'get_balance'.{ name: "get_balance", description: "Get balance of an address in wei", inputSchema: { type: "object" as const, properties: { rpcUrl: { type: "string", description: "The RPC URL of the chain (optional if default is set)", }, address: { type: "string", description: "Ethereum address to check balance for", }, }, required: ["address"], }, },
- src/index.ts:946-959 (schema)JSON schema defining input parameters: 'address' (required, string), 'rpcUrl' (optional, string). Note: handler also accepts 'chainName' via args though not in schema.inputSchema: { type: "object" as const, properties: { rpcUrl: { type: "string", description: "The RPC URL of the chain (optional if default is set)", }, address: { type: "string", description: "Ethereum address to check balance for", }, }, required: ["address"],
- Supporting utility method in EthereumAccountClient that executes the 'eth_getBalance' RPC call at 'latest' block, returning raw wei balance as hex string.async getBalance(address: string): Promise<string> { const balance = await this.makeRpcCall('eth_getBalance', [address, 'latest']); return balance; }