MCP Server Tron

A comprehensive Model Context Protocol (MCP) server that provides blockchain services for the TRON network. This server enables AI agents to interact with TRON blockchain with a unified interface through tools and AI-guided prompts for TRX, TRC20 tokens and smart contracts.

Contents

• Overview
• Features
• Supported Networks
• Prerequisites
• Installation
• Configuration
  • Environment Variables
  • Server Configuration
• Usage
• API Reference
  • Tools
  • Prompts
• Security Considerations
• Project Structure
• License

Overview

The MCP TRON Server leverages the Model Context Protocol to provide blockchain services to AI agents. It fully supports the TRON ecosystem using tronweb.

Key capabilities:

• Blockchain Data: Read blocks, transactions, and chain parameters (Energy/Bandwidth costs).
• Smart Contracts: Interact with any TRON smart contract (Read/Write).
• Tokens: Transfer TRX and TRC20 tokens; check balances.
• Address Management: Convert between Hex (0x...) and Base58 (T...) formats.
• Wallet Integration: Agent-wallet-managed file-backed wallets.
• Multi-Network: Seamless support for Mainnet, Nile, and Shasta.
• Dynamic Access Control: Write-capable tools stay registered; --readonly hides them, and wallet-dependent handlers fail at execution time if no wallet is available.

Features

Blockchain Data Access

• TRON network support: Mainnet, Nile, Shasta.
• Chain information: Block number, Chain ID, RPC endpoints.
• Block data: Access by number or hash.
• Transaction details: Detailed info including resource usage (Energy/Bandwidth).
• Resource Costs: Query current chain parameters for Energy and Bandwidth prices.

Token Services

• Native TRX: Check balance and transfer.
• TRC20 Tokens:
  • Check balances.
  • Transfer tokens.
  • Get token metadata (name, symbol, decimals).

Address Services

• Format Conversion: Convert between Hex (41... or 0x...) and Base58 (T...) formats.
• Validation: Verify if an address is valid on TRON.

Smart Contract Interactions

• Read Contract: Call view and pure functions.
• Write Contract: Execute state-changing functions.
• ABI Fetching: Automatically fetches ABI from the blockchain for verified contracts.

Governance & Proposals

• Super Representatives: List, vote, create/update witnesses, manage brokerage.
• Proposals: List, view, create, approve, and delete governance proposals.
• Rewards: Query and withdraw SR voting rewards.

Events & Data Queries

• Contract Events: Query events by transaction, contract address, or block number.
• Account Data: Transaction history, TRC20 transfers, internal transactions, token balances (via TronGrid).
• Contract Data: Contract transaction history, internal transactions, token holder lists.
• Mempool: View pending transactions and pool size.
• Node Info: List connected nodes and query node details.

Staking & Resource Delegation (Stake 2.0)

• Staking: Freeze/unfreeze TRX for Energy or Bandwidth.
• Delegation: Delegate and undelegate resources to other accounts.
• Queries: Available unfreeze count, withdrawable amounts, delegation details.

Wallet & Security

• Agent Wallet: File-backed wallet storage via agent-wallet SDK.
• HD Wallet: Supports BIP-44 derivation path `m/44'/19

... View full README on GitHub