# Tronscan MCP for AI Agents AI Agent Connect

> Tronscan (TRON Blockchain Explorer API) MCP. It lets your AI agent dig into the TRON blockchain to pull account data, track token balances, and audit smart contracts in real-time. It's the bridge between your agent and the TRON network's raw data.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_xWjZNDlzf3RGcwviKuDxH0EfFuMlZkROjpD1naPv/ai-agent-connect
- **Tags:** tron, blockchain-explorer, smart-contracts, crypto-analysis, trc20

## Description

Instead of jumping between tabs and manually copy-pasting data from a block explorer, you can now let your agent do the heavy lifting. This Connector connects your AI client directly to the Tronscan API, turning a simple chat window into a full-scale blockchain analytics suite. You can ask your agent to pull a history of transactions for a specific wallet, check the current energy and bandwidth of a contract, or see who holds a specific TRC20 token. It handles the messy details of blockchain data retrieval so you can focus on the actual analysis. Whether you're debugging a contract's event logs or tracking whale movements, the information comes back in a clean, usable format. It's a huge jump in speed for anyone who spends their day staring at on-chain data. You'll find this Connector in the Vinkius catalog alongside hundreds of other specialized connectors, making it easy to build a custom stack of tools for your agent. From checking stablecoin distributions to verifying smart contract source code status, the data is just a prompt away.

## Tools

### get_account_security
Checks the security status of a given account. It's a fast way to verify if a wallet has known issues.

### list_proposals
Lists all current proposals on the network. Use this to stay updated on TRON governance.

### get_multisign_security
Checks the security of multi-sign accounts. This is a must-have for checking high-value treasury wallets.

### get_account_detail
Retrieves specific, deep-dive information for a single account. Use this when you need more than just a balance summary.

### get_account_tags
Fetches behavioral tags associated with an account. This helps in identifying types of users or entities.

### get_account_token_asset_overview
Summarizes the token assets held by a specific account. It provides a high-level view of a portfolio.

### get_acquisition_cost_stats
Provides statistics on resource acquisition costs. This is useful for planning contract deployments.

### get_auth_security
Pulls data regarding authorization security. Use this to check permission settings on the network.

### get_block_stats
Retrieves statistics for a specific block. Use this to analyze network performance at a specific point in time.

### get_chain_parameters
Pulls the current parameters of the TRON chain. This gives you the technical specs of the network right now.

### get_consumption_stats
Shows statistics for burn and staking income. This is vital for understanding network incentives.

### get_contract_analysis
Provides a daily analysis of a specific contract. It helps in monitoring the health of a decentralized app.

### get_contract_detail
Fetches the specific details of a smart contract. Use this for deep dives into contract logic and status.

### get_contract_energy_stats
Shows the energy statistics for a contract. This is essential for checking if a contract can handle its load.

### get_contract_events
Returns a list of event information for a contract. This is the primary way to see what's happening inside a contract.

### get_contract_top_calls
Lists the top call statistics for a contract. Use this to see which functions are being used the most.

### get_daily_accounts
Shows the number of new users added daily. This is a great metric for tracking network growth.

### get_daily_transactions
Shows the daily trend of transactions. It provides a pulse on the network's daily activity.

### get_energy_stats
Provides statistics on energy consumption. Use this to monitor overall network energy usage.

### get_funds
Retrieves the TRX supply and current marketcap. This gives you the big picture of the TRON economy.

### get_homepage_bundle
Pulls a bundle of data for the homepage. It provides a snapshot of the network's current state.

### get_net_stats
Shows the current bandwidth consumption. Use this to monitor network congestion in real-time.

### get_nodemap
Provides a map of the current network nodes. This helps in understanding the infrastructure of the TRON network.

### get_stablecoin_big_amount
Lists large transactions involving stablecoins. This is perfect for tracking whale movements.

### get_stablecoin_blacklist
Shows transactions involving blacklisted stablecoins. Use this for compliance and security monitoring.

### get_stablecoin_distribution
Shows how stablecoins are distributed among holders. This provides insight into the market's liquidity.

### get_stablecoin_total_supply
Shows the total circulation of stablecoins. Use this to get a macro view of the TRON stablecoin market.

### get_token_security
Checks the security data for a specific token. Use this to vet new tokens before you decide to hold them.

### get_top10
Retrieves the top 10 data points for the network. It's a quick way to see what's trending.

### get_tps
Shows the current transactions per second. Use this to check the live speed of the TRON network.

### get_transaction_detail
Pulls the specific details of a transaction. Use this to troubleshoot failed or pending transfers.

### get_transaction_security
Checks the security data for a transaction. This helps in identifying potentially risky movements.

### get_trc10_token
Fetches details for TRC10 tokens. Use this to explore older token standards on the network.

### get_trc20_token
Fetches details for TRC20, TRC721, and TRC1155 tokens. This is your main tool for checking modern tokens and NFTs.

### get_turnover
Shows the total revenue of a protocol. Use this to analyze the success of a decentralized application.

### get_url_security
Checks the security status of a URL. This is a great first step in avoiding phishing sites.

### list_account_resources
Lists the Stake 1.0 resources for an account. This helps in understanding legacy resource management.

### list_account_resources_v2
Lists the Stake 2.0 resources for an account. Use this for modern resource and bandwidth tracking.

### list_contracts
Generates a list of all smart contracts on the network. It's the starting point for broad contract discovery.

### list_internal_transactions
Fetches a list of internal blockchain transactions. This is key for tracing complex smart contract interactions.

### list_transactions
Returns a list of transactions. This is the standard way to browse recent activity on the chain.

### list_trc10_holders
Shows the holders of TRC10 tokens. Use this to analyze older token distribution.

### list_trc1155_inventory
Lists the inventory for TRC1155 NFTs. This is the primary tool for checking multi-token NFT collections.

### list_trc1155_transfers
Shows the transfers for TRC1155 tokens. Use this to track the movement of multi-token NFTs.

### list_trc20_holders
Shows the holders of TRC20, TRC721, and TRC1155 tokens. This helps in analyzing large-scale token ownership.

### list_trc20_transfers
Shows the transfers for TRC20 and TRC721 tokens. This is your go-to for tracking standard token movement.

### list_trc721_inventory
Lists the inventory for TRC721 NFTs. Use this to check a user's collection of unique NFTs.

### list_voted
Shows the voted list for an account. This lets you see which governance proposals a user has supported.

### list_witnesses
Shows the witness list for the network. This provides insight into the validator structure.

### search_v2
Performs a search on Tronscan using the v2 engine. This is the most efficient way to find specific entities on the chain.

### get_account_analysis
Pulls a summary of an account's balance, transfers, and resource usage. This helps you get a quick snapshot of wallet health.

### list_account_tokens
Lists all tokens with a balance greater than zero for an account. This is the best way to see a wallet's full holdings.

### list_account_votes
Shows the votes associated with an account. Use this to see how a user is participating in governance.

### list_accounts
Returns a list of accounts on the network. This is useful for broad searching and discovery.

### list_approvals
Shows the approval list for a specific account. This is critical for checking which contracts can spend a user's funds.

### list_blocks
Lists the blocks on the network or provides details for one. Use this to navigate the blockchain's history.

### list_tokens_overview
Provides a broad overview of available tokens. It's great for seeing what's currently active on the chain.

### list_transfers
Shows a history of TRX and TRC10 transfers. This helps in tracking basic asset movement.

## Prompt Examples

**Prompt:** 
```
Show me the balance and resource status for address TXYZ...
```

**Response:** 
```
I've retrieved the analysis for address TXYZ.

**Account Summary**
*   **TRX Balance:** 1,500 TRX
*   **Estimated Value:** $180
*   **Energy:** 95% capacity
*   **Bandwidth:** Fully available

I can also pull the full transaction history or check the security status of this wallet if you'd like.
```

**Prompt:** 
```
What are the top 5 most active contracts on TRON right now?
```

**Response:** 
```
Fetching the top verified contracts...

| Rank | Contract Name | Transactions |
| :--- | :--- | :--- |
| 1 | **USDT Token** | 2,000,000+ |
| 2 | **JustLend** | 850,000+ |
| 3 | **SunSwap** | 620,000+ |
| 4 | **BithSwap** | 410,000+ |
| 5 | **JustLend (V2)** | 380,000+ |

Would you like me to pull the specific event logs for any of these?
```

**Prompt:** 
```
List all the TRC20 tokens held by this wallet: [Address]
```

**Response:** 
```
I've pulled the token inventory for the requested wallet. Here are the assets held with a balance greater than zero:

*   **USDT** (TRC20): 50,000.00
*   **USDC** (TRC20): 12,500.00
*   **BTC** (TRC20): 0.05
*   **LTC** (TRC20): 10.00

Would you like me to check the security data for any of these specific tokens?
```

## Capabilities

### Pull account profiles
Get a full breakdown of a wallet's balances, transactions, and resource usage.

### Track token holdings
See every TRC20, TRC721, and TRC1155 token held by any specific address.

### Audit smart contracts
Retrieve live event logs and contract details for security and performance checks.

### Monitor network resources
Check real-time TPS, bandwidth consumption, and block statistics.

### Track whale movements
Identify large stablecoin transactions and high-activity entities on the chain.

### Check contract security
Verify authorization security and multi-sign data for deployed contracts.

## Use Cases

### Verifying contract resource limits
A developer needs to know if a contract has enough energy for a deployment. They ask the agent to check get_contract_energy_stats.

### Tracking whale movements
A crypto researcher wants to see large stablecoin movements. They ask the agent to list get_stablecoin_big_amount.

### Auditing wallet safety
A user wants to know if a specific wallet has been flagged for security issues. They ask the agent to check get_account_security.

### Monitoring network growth
A data scientist wants to see the daily growth of the network. They ask the agent to pull get_daily_accounts.

## Benefits

- Get instant account summaries with get_account_analysis so you don't have to click through multiple pages to see a wallet's health.
- Track every TRC20 and TRC721 token held by an address using list_account_tokens for a complete portfolio view.
- Audit smart contracts quickly by pulling live event logs with get_contract_events to spot errors or anomalies.
- Monitor network health using get_tps and get_net_stats to see real-time congestion and bandwidth availability.
- Verify token safety with get_token_security to identify risks before interacting with new assets.
- Manage governance easily by checking votes and proposals with list_account_votes and list_proposals.

## How It Works

The bottom line is you get real-time TRON network data inside your AI client without leaving your workspace.

1. Subscribe to the Connector on Vinkius.
2. Add your Tronscan Pro API Key to the configuration.
3. Ask your agent to pull TRON blockchain data.

## Frequently Asked Questions

**Can the Tronscan MCP help me track whale movements?**
Yes, it can pull large stablecoin transactions and identify high-activity entities on the network to help you spot whale movements.

**Does this work for TRC20 tokens?**
Yes, it covers TRC20, TRC721, and TRC1155 tokens, allowing you to track balances and transfers across all major TRON standards.

**Can I use this to check if a smart contract is safe?**
Yes, it provides tools for contract analysis, security checks, and event logs, which are essential for auditing and verifying contract safety.

**Is this good for checking my voting status?**
Yes, it can pull your votes and current proposals, making it easy to monitor your participation in TRON governance.

**Can I see how much energy my account has left?**
Yes, the Connector can provide a full account analysis that includes your current energy and bandwidth levels.

**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.