TronScan Realtime Network

---

name: tronscan-realtime-network description: | Query TRON real-time network data: latest block height, current TPS, node count, latest TVL, total transaction count, real-time vote count. Use when user asks "real-time TPS", "current block height", "node count", "TVL", "total tx count", or network status. Do NOT use for historical trends (use tronscan-data-insights); block details (use tronscan-block-info). metadata: author: tronscan-mcp version: "1.0" mcp-server: https://mcp.tronscan.org/mcp

---

Realtime Network Data

Overview

| Tool | Function | Use Case | |------|----------|----------| | getLatestBlock | Latest solidified block | Solidified block height, hash, timestamp, witness, tx count | | getCurrentTps | TPS & height | Current TPS, latest block height, historical max TPS | | getHomepageData | Homepage summary | TPS, node count, chain overview, TVL, frozen | | getNodeMap | Node map | Real-time node info and geographic distribution | | getWitnessGeneralInfo | Witness aggregate | Total vote count, block stats, witness count | | getTransactionStatistics | Tx statistics | Total tx count, token tx volume aggregates |

Use Cases

1. Latest solidified block / confirmed block height: Use getLatestBlock for solidified block (not chain-head latest); use getCurrentTps for latest block height. 2. Real-time TPS: Use getCurrentTps for current TPS; use getHomepageData for overview TPS. 3. Real-time node count: Use getHomepageData for node count; use getNodeMap for node list and distribution. 4. Latest TVL: Use getHomepageData for latest TVL in homepage overview. 5. Total transaction count: Use getTransactionStatistics for total tx count and token tx volume. 6. Real-time vote count: Use getWitnessGeneralInfo for total vote count and witness stats.

MCP Server

Prerequisite: TronScan MCP Guide

Tools

getLatestBlock

API: getLatestBlock — Calls /api/block/latest; returns latest solidified block (number, hash, size, timestamp, witness, tx count). Note: Returns solidified block, not the chain-head latest block.

Use when: User asks for "confirmed block", "solidified block height", or needs a stable block number. If user asks "latest block height" or "current block", clarify that the response is the solidified block and may lag behind the chain head.

Response: number (block height), hash, size, timestamp, witness, tx count, etc.

Note: Fields such as witnessName, fee, energyUsage, blockReward, voteReward, confirmations, netUsage may be 0 or null (underlying API does not return them)—ignore them. Use tronscan-block-info getBlocks when these fields are needed.

getCurrentTps

API: getCurrentTps — Get current TPS, latest block height, and historical max TPS

Use when: User asks for "real-time TPS", "current TPS", "throughput", or "latest block height".

Response: currentTps, latest block height, historical max TPS.

getHomepageData

API: getHomepageData — Get homepage data (TPS, node count, overview, frozen, TVL, etc.)

Use when: User asks for "network overview", "node count", "TVL", or "homepage stats".

Response: TPS, node count, chain overview, frozen resources, TVL, etc.

getNodeMap

API: getNodeMap — Get current node info and geographic distribution

Use when: User asks for "node count", "node distribution", or "node map".

Response: Current node info and geographic distribution.

getWitnessGeneralInfo

API: getWitnessGeneralInfo — Get witness aggregate stats (total votes, block stats, witness count)

Use when: User asks for "real-time vote count", "total votes", or "witness stats".

Response: Total vote count, block stats, witness count.

getTransactionStatistics

API: getTransactionStatistics — Get transaction statistics (total tx, token tx volume, etc.)

Use when: User asks for "total transaction count" or "tx volume".

Response: Total tx count, token tx volume, and other aggregates.

Troubleshooting

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.

Notes

For a single "real-time network" dashboard, prefer getHomepageData first (covers TPS, nodes, TVL); then add getCurrentTps for precise TPS/height, getWitnessGeneralInfo for votes, and getTransactionStatistics for total tx count.

All tools are invoked via TronScan MCP tools/call with the tool name and required arguments.

getLatestBlock may return 0/null for witnessName, blockReward, voteReward, fee, energyUsage, netUsage, confirmations; use tronscan-block-info getBlocks when these fields are needed.

For a single "real-time network" dashboard, prefer getHomepageData first (covers TPS, nodes, TVL); then add getCurrentTps for precise TPS/height, getWitnessGeneralInfo for votes, and getTransactionStatistics for total tx count.

All tools are invoked via TronScan MCP tools/call with the tool name and required arguments.

getLatestBlock may return 0/null for witnessName, blockReward, voteReward, fee, energyUsage, netUsage, confirmations; use tronscan-block-info getBlocks when these fields are needed.