name: tronscan-block-info description: | Query TRON latest block, block reward, block time, producer, burned TRX, resource use, transaction count. Use when user asks "latest block", "block height", "block producer", "block reward", "burned TRX", or network load. Do NOT use for real-time TPS/network dashboard (use tronscan-realtime-network); tx by hash (use tronscan-transaction-info). metadata: author: tronscan-mcp version: "1.0" mcp-server: https://mcp.tronscan.org/mcp

Block Info

Tool	Function	Use Case
getLatestBlock	Latest block	Block number, hash, size, timestamp, witness, tx count
getBlocks	Block list	Pagination, sort, filter by producer/time
getBlockStatistic	Block statistics	24h payment total, block count, burn total

Latest Block: Use getLatestBlock for current block number, hash, size, timestamp, witness, tx count.
Block Reward: Reward info can be derived from block data or chain params; block list gives block-level data.
Block Time / Producer: Use getLatestBlock or getBlocks for timestamp and witness (producer).
Burned TRX: Use getBlockStatistic for 24h burn total; per-block burn may be in block payload.
Resource Consumption: Block-level resource use is reflected in block size and tx count; use getBlockStatistic for aggregates.
Transaction Count: Use getLatestBlock for tx count in latest block; use getBlocks for multiple blocks.
Network Load: Combine getLatestBlock, getBlocks, and getBlockStatistic for real-time load view.

API: getLatestBlock — Calls /api/block/latest; returns latest solidified block (number, hash, size, timestamp, witness, tx count)
Use when: User asks for "latest block", "current block", or "block height".
Response: number, hash, size, timestamp, witness, tx count, etc.
Note: /api/block/latest does not return witnessName, fee, energyUsage, blockReward, voteReward, confirmations, netUsage. These may appear as 0 or null in the response—ignore them. For witness name, block reward, fees, or resource usage, use getBlocks instead.

API: getBlocks — Get block list with pagination, sort, filter by producer/time range
Use when: User asks for "recent blocks", "blocks by producer", or "blocks in time range".
Input: limit, sort (e.g. -number), optional producer address, start/end time.

API: getBlockStatistic — Get block statistics (24h payment total, block count, burn total)
Use when: User asks for "block stats", "24h blocks", or "burned TRX".
Response: 24h payment, block count, burn total, and related aggregates.

MCP connection failed: If you see "Connection refused", verify TronScan MCP is connected in Settings > Extensions.
API rate limit / 429: TronScan API has call count and frequency limits when no API key is used. If you encounter rate limiting or 429 errors, go to TronScan Developer API to apply for an API key, then add it to your MCP configuration and retry.

For "block reward", combine block data with getChainParameters (Witness category) if reward rules are needed.
Real-time monitoring: poll getLatestBlock and/or getBlockStatistic for load and burn.
getLatestBlock may return 0/null for witnessName, blockReward, voteReward, fee, energyUsage, netUsage, confirmations (underlying /api/block/latest does not provide them); use getBlocks when these fields are needed.