# Tronscan MCP

> Tronscan (TRON Blockchain Explorer API) lets your AI agent query real-time data from the TRON network. Use this server to analyze account metrics, track complex token holdings (TRC10, TRC20, etc.), inspect smart contract event logs, and monitor resource consumption like Energy/Bandwidth directly via natural language prompts.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Tags:** tron, blockchain-explorer, smart-contracts, crypto-analysis, trc20

## Description

Yo, this is your deep dive into the TRON network. The `Tronscan API` lets your AI agent query real-time data straight from the TRON blockchain. You're not just checking a balance; you're running on-chain forensics. Use this server to analyze account metrics, track complex token holdings (TRC10, TRC20, etc.), inspect smart contract event logs, and monitor resource consumption like Energy/Bandwidth using natural language prompts.

**Account Status & Security Audits**

You can run a full profile check on any address. The `get_account_analysis` tool pulls together a summary of an account's balance, its transfer history, energy usage, bandwidth used, and total transaction count. For deeper dives, the `get_account_detail` fetches comprehensive metadata for that specific blockchain address; you can also call `list_accounts` to get an initial list of available addresses for batch processing. If security is what you care about, use `get_account_security` to pull risk data points or check multi-signature setups with `get_multisign_security`. You'll find behavioral context too; the `get_account_tags` tool identifies any tags linked to an address, and `get_auth_security` retrieves specific authorization security posture data. Wanna see what resources are allocated? Use `list_account_resources` for staking 1.0 details or `list_account_resources_v2` for the updated staking 2.0 view. You can also check an account's voting history with `list_account_votes` or review any proposals using `get_account_tags`.

**Token & Asset Tracking**

Tracking tokens is a whole other ballgame. The `get_token_asset_overview` provides a general snapshot of all token assets an account holds, perfect for portfolio checks. If you need to list every single token type held by an address with a positive balance, run `list_account_tokens`. For specific coin types, there are dedicated tools: `list_trc10_holders` queries addresses holding TRC10 tokens, while `list_trc20_holders` lists those with any TRC20, TRC721, or TRC1155 balance. You can see the full inventory count for multi-token NFTs using `list_trc1155_inventory`, and get specific details on non-fungible assets via `list_trc721_inventory`. If you need to know how much of a stablecoin is floating around, use `get_stablecoin_total_supply` for the total circulating amount. You can also check major fund movements with `get_stablecoin_big_amount`, or flag suspicious activity using `get_stablecoin_blacklist` and `get_stablecoin_distribution`. When it comes to tracking approvals—the allowances granted on an account—`list_approvals` generates that full list. For general token standards, the `list_tokens_overview` gives you a summary of all available token types.

**Smart Contract Analysis & Events**

When you need to audit code or usage, these tools are for ya. Use `get_contract_detail` to fetch the detailed operational metadata for any deployed smart contract address. To see what’s going down inside a contract, `get_contract_events` returns a chronological list of every recorded event that happened there. You can analyze performance with `get_contract_analysis`, which runs a daily summary on how well the contract is doing. Wanna know where the money's coming from? The `get_turnover` calculates total protocol revenue generated by a system or smart contract. To see exactly how much energy a specific contract used, check `get_contract_energy_stats`. You can also list all addresses that have deployed contracts using `list_contracts`, and review the most frequently run functions on a contract with `get_contract_top_calls`. For internal activity—transactions that didn't leave the contract boundary—use `list_internal_transactions`.

**Network Overview & Transactions**

Want to know how the whole chain is running? The `get_homepage_bundle` pulls core network stats for a general view. `get_tps` reports the current Transactions Per Second rate in real time, and `get_block_stats` gets statistical metrics about any given block hash. For total funds, `get_funds` returns the entire TRX supply and its market cap data. You can see resource usage across the board with `get_energy_stats`, which provides current network-wide energy consumption rates, or use `get_net_stats` for bandwidth usage stats. To track activity flow, `list_transactions` fetches a paginated list of recent transaction hashes, and `list_blocks` retrieves either a list of block hashes or the full content of a specific block.

**Specific Flow Tracking**

Need to follow money? The `list_transfers` lists every transfer, covering both TRX and TRC10 tokens. For detailed transaction records, use `get_transaction_detail` on a hash, or check the security risk level of a specific move with `get_transaction_security`. If you're looking at token movements generally, `list_trc20_transfers` provides the full history log for TRC20 and TRC721 tokens. You can also use `list_approvals` to see all allowances granted across the board, or run a broad search using `search_v2` with specific keywords across Tronscan's indexed data.

## Tools

### get_account_analysis
Retrieves a summary of an account's balance, transfers, energy, bandwidth, and transaction count.

### get_account_detail
Fetches comprehensive metadata about a specific blockchain address.

### get_account_security
Retrieves security-related data points for an account, useful for risk assessment.

### get_account_tags
Identifies behavioral tags associated with a specific blockchain address.

### get_account_token_asset_overview
Provides an overview of all token assets held by an account, useful for portfolio tracking.

### get_acquisition_cost_stats
Calculates and returns resource costs associated with acquiring or utilizing the account's resources.

### get_auth_security
Retrieves specific data concerning an account's authorization security posture.

### get_block_stats
Gets statistical metrics about a given block on the TRON network.

### get_chain_parameters
Retrieves fundamental operational parameters for the entire TRON chain.

### get_consumption_stats
Calculates burn and staking income statistics related to an account or contract.

### get_contract_analysis
Performs a daily analysis summary on the performance of a smart contract.

### get_contract_detail
Fetches detailed operational metadata for a specific deployed smart contract address.

### get_contract_energy_stats
Provides statistics detailing the energy consumption related to a particular contract.

### get_contract_events
Returns a chronological list of all recorded events that happened for a given smart contract.

### get_contract_top_calls
Lists and aggregates the most frequently executed functions or calls on a specific contract.

### get_daily_accounts
Retrieves data listing new accounts created within a 24-hour period.

### get_daily_transactions
Gathers trend data showing the volume of transactions over a daily cycle.

### get_energy_stats
Provides current statistics on network-wide energy consumption rates.

### get_funds
Returns the total TRX supply and the corresponding market capitalization data.

### get_homepage_bundle
Retrieves a bundled set of core statistics for general network overviews.

### get_multisign_security
Gets security data specifically related to multi-signature wallet setups.

### get_net_stats
Provides statistics on bandwidth consumption and usage across the network.

### get_nodemap
Retrieves a map or list of active nodes participating in the TRON network.

### get_stablecoin_big_amount
Identifies and lists large transactions involving stablecoins, useful for tracking major funds movements.

### get_stablecoin_blacklist
Checks for and returns transaction records flagged as suspicious or blacklisted for stablecoins.

### get_stablecoin_distribution
Determines how stablecoins are held across different groups of addresses (holder distribution).

### get_stablecoin_total_supply
Calculates the current total circulating supply amount for a given stablecoin.

### get_token_security
Retrieves security metrics and data points specific to token types on the network.

### get_top10
Fetches a curated list containing the top 10 most active or notable addresses/contracts.

### get_tps
Reports the current Transactions Per Second (TPS) rate for the TRON network in real time.

### get_transaction_detail
Retrieves every specific field and detail associated with a single transaction hash.

### get_transaction_security
Checks the security integrity and risk level of a given transaction.

### get_trc10_token
Provides specific details and metrics for TRC10 token movements.

### get_trc20_token
Retrieves data and metrics covering TRC20, TRC721, and TRC1155 tokens.

### get_turnover
Calculates the total protocol revenue generated by a smart contract or system.

### get_url_security
Checks and reports on the security status of associated URLs linked to an account or contract.

### list_account_resources
Lists the current staking 1.0 resources (Stake) allocated to a specific account address.

### list_account_resources_v2
Lists and tracks the updated staking 2.0 resources for an account.

### list_account_tokens
Retrieves a list of all token types held by an account that have a positive balance.

### list_account_votes
Gets the voting history and participation details for a specific account address.

### list_accounts
Retrieves an initial list of available blockchain accounts, often used for batch processing.

### list_approvals
Generates a comprehensive list of all token approvals or allowances granted to an account.

### list_blocks
Retrieves either a list of recent block hashes or the detailed content of a specific block.

### list_contracts
Gets a full, queryable list of all deployed smart contract addresses on the network.

### list_internal_transactions
Retrieves transactions that occurred internally within a contract without being external transfers.

### list_proposals
Lists governance proposals currently active or passed on the TRON network.

### list_tokens_overview
Provides a general listing and summary of all token standards available on the chain.

### list_transactions
Fetches a paginated list of recent transaction hashes for bulk review.

### list_transfers
Lists all transfers, covering both TRX and TRC10 tokens across the network.

### list_trc10_holders
Queries and lists all addresses that currently hold a balance of TRC10 tokens.

### list_trc1155_inventory
Lists the full inventory count of multi-token NFTs (TRC1155) held by an address.

### list_trc1155_transfers
Retrieves a history of all transfers involving TRC1155 tokens.

### list_trc20_holders
Lists all addresses that possess a balance greater than zero for any TRC20, TRC721, or TRC1155 token type.

### list_trc20_transfers
Provides the full transaction history log for all movements of TRC20 and TRC721 tokens.

### list_trc721_inventory
Lists the specific collection count and inventory details for non-fungible TRC721 NFTs.

### list_voted
Retrieves a list of all votes cast by an account, critical for governance tracking.

### list_witnesses
Gets the current list of approved witnesses responsible for maintaining network consensus.

### search_v2
Runs a general, advanced search across Tronscan's indexed blockchain data using specific keywords or criteria.

## Prompt Examples

**Prompt:** 
```
Show me the detailed balance and analysis for address TXYZ...
```

**Response:** 
```
I've retrieved the analysis for address TXYZ... The account currently holds 1,500 TRX with an estimated total asset value of $180. Energy is at 95% capacity and Bandwidth is fully available.
```

**Prompt:** 
```
List the top verified smart contracts on TRON sorted by transaction count.
```

**Response:** 
```
Fetching the top verified contracts... The most active contract is currently 'USDT Token' (TR7NH...) with over 2 million transactions, followed by 'JustLend' and 'SunSwap'.
```

**Prompt:** 
```
What are the recent events for the contract address TR7NH...?
```

**Response:** 
```
I've found the latest events for the USDT contract. Recent activities include multiple 'Transfer' events and 'Approval' updates. Would you like me to decode the parameters for the last five transfers?
```

## Capabilities

### Audit Account Status
Retrieves a full profile of an account, including current balances, transfer history, consumed energy, bandwidth usage, and transaction count.

### Track Specific Assets
Lists all token types held by an address (TRC10, TRC20, etc.) or provides the total circulation for stablecoins like USDT.

### Analyze Contract Behavior
Retrieves metadata and event logs for a smart contract, showing how it was called, what resources it spent, and its current function details.

### Monitor Network Health
Pulls high-level data points like total network TPS, block statistics, or the list of active nodes across the TRON chain.

## Use Cases

### Debugging a DeFi Smart Contract
A developer needs to know why their collateral liquidation failed. They ask their agent: 'What happened with contract X?'. The agent runs `get_contract_events` and then `list_internal_transactions`. This reveals that the failure wasn't due to code logic, but a resource exhaustion error confirmed by `get_account_analysis`.

### Tracking Suspicious Funds
An analyst suspects funds are moving through a mixer. They run 'Show all stablecoin transactions involving addresses near TXYZ'. The agent uses `list_trc20_transfers`, filters by the target asset, and cross-references suspicious patterns using `get_stablecoin_blacklist` to map the full fund path.

### Auditing Governance Participation
A DAO team needs proof of stakeholder commitment. They query an address for its voting history via `list_account_votes`. The data confirms if the owner participated in recent governance rounds and shows resource allocation using `get_account_resources`.

### Verifying Token Holdings
A client asks, 'What exactly does this address own?'. Instead of calling three different tools for TRX, TRC20, and NFTs, the agent runs `list_account_tokens` which consolidates all assets into one view. They then use `get_token_asset_overview` for a detailed breakdown.

## Benefits

- **Full Asset Visibility:** Instead of opening multiple tabs, use `list_account_tokens` to get a single list of all token types (TRC10, TRC20, etc.) an address holds. This cuts down on asset tracking time by 75%.
- **Contract Forensics:** When debugging a contract failure, don't guess what happened. Use `get_contract_events` to pull the exact sequence of events that occurred and analyze resource spending with `get_contract_energy_stats`. This is key for root cause analysis.
- **Resource Management:** Stop worrying about insufficient gas or energy. The tools like `list_account_resources` and `get_consumption_stats` give you a clear view of staking resources, letting you predict future operational costs accurately.
- **Investor Intelligence:** Track large money movements using specialized calls. Functions like `get_stablecoin_big_amount` quickly flag major fund transfers, helping analysts monitor 'whale' activity without manually sifting through millions of transactions.
- **Network Health Check:** Get a real-time pulse on the network. Use `get_tps` to check throughput instantly or use `list_blocks` to verify block finality and overall chain stability.

## How It Works

The bottom line is: you stop navigating multiple explorer tabs and start asking the blockchain for exactly what you need.

1. Subscribe to this MCP Server and supply your Tronscan Pro API Key.
2. Your agent converts a natural language query (e.g., 'Show me all assets for TXYZ...') into a specific tool call (`list_account_tokens`).
3. The server executes the call against the TRON blockchain, returning raw, structured data to your AI client.

## Frequently Asked Questions

**How do I check if an account has enough energy for a transaction using get_account_analysis?**
The `get_account_analysis` tool provides the current Energy and Bandwidth metrics. If those values are low or near zero, the account likely won't be able to execute complex transactions requiring high resource spending.

**What is the difference between list_transactions and get_transaction_detail?**
`list_transactions` gives you a paginated list of transaction hashes for bulk review. `get_transaction_detail` takes one specific hash and returns every single field associated with that unique transaction, giving you granular data.

**Should I use get_trc20_token or list_account_tokens to check assets?**
`list_account_tokens` gives a broad overview of all asset types held. Use `get_trc20_token` when you need specific, detailed metrics only for the TRC20 standard (like its unique token IDs and type).

**How do I find out what assets are circulating total supply?**
Use `get_stablecoin_total_supply` if you're checking a specific stablecoin like USDT, or run `list_tokens_overview` for a general list of token standards and their associated circulation data.

**How does get_account_security help me check an account's security status?**
It returns a comprehensive view of the account's associated risk factors. This data tells you if the account has passed multi-signature checks or flags potential vulnerabilities based on its history.

**What is the difference between list_account_resources and get_acquisition_cost_stats?**
list_account_resources shows your current staked amounts for governance (Stake 1.0/2.0). However, get_acquisition_cost_stats tracks the historical resource spending required to achieve those stakes.

**If I use list_contracts and get no results, does that mean the contract doesn't exist?**
No, it usually means the contract hasn't been indexed by Tronscan or you need a specific address to filter by. You should check if the smart contract is active on the network first.

**Are there rate limits when I run mass queries using list_transactions?**
Yes, high volume requests will hit API rate limits. For large data sets, always implement pagination and consider exponential backoff to manage your query load effectively.

**Can I check the energy and bandwidth resources of a TRON account?**
Yes! You can use the `list_account_resources_v2` tool to get detailed information about Stake 2.0 resources, including available energy and bandwidth for any address.

**How do I see all the TRC20 tokens held by a specific address?**
Use the `list_account_tokens` tool with the target address. You can filter by `show: 1` to specifically list TRC20 tokens and their current balances.

**Is it possible to monitor live events from a smart contract?**
Yes. The `get_contract_events` tool allows you to retrieve a list of event information for a specific contract address, helping you track interactions and state changes.