GoTRON MCP

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

TRON blockchain: accounts, TRC20 tokens, staking, contracts, resources and transaction builders

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "GoTRON MCP": {
      "url": "https://mcp.gotron.sh/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (44)

• analyze_account destructive

  Comprehensive account overview: balance, resources, staking, voting, permissions, and delegations in a single call

  Parameters:

  • address (required) — string — TRON base58 address (starts with T)

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• analyze_transfer_cost destructive

  Estimate the cost of a TRX or TRC20 transfer: energy, bandwidth, and TRX burn options

  Parameters:

  • from (required) — string — Sender TRON address (base58)
  • to (required) — string — Recipient TRON address (base58)
  • amount (required) — string — Amount to transfer (e.g., '100')
  • contract_address — string — TRC20 contract address (omit for TRX transfer)

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• decode_abi_output destructive

  Decode ABI-encoded output hex from a contract call. Handles return values, revert reasons (Error(string)), and panic codes (Panic(uint256)).

  Parameters:

  • contract_address (required) — string — Contract address (base58, starts with T; needed to fetch ABI for decoding)
  • method (required) — string — Method signature (e.g., 'balanceOf(address)')
  • data (required) — string — Hex-encoded output bytes to decode (0x prefix optional)

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• delegate_resource destructive

  Delegate energy or bandwidth to another address (Stake 2.0). Returns unsigned transaction hex for signing.

  Parameters:

  • from (required) — string — Delegator address (base58, starts with T)
  • to (required) — string — Recipient address (base58, starts with T)
  • resource (required) — string — Resource type
  • amount (required) — string — Amount in TRX to delegate (e.g., '100.5')
  • memo — string — Optional memo to attach to the transaction
  • lock_period — number — Lock period in blocks (~3 seconds each). If set, delegation cannot be undone until the lock expires.
  • permission_id — number — Permission ID for multi-sig transactions

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• estimate_energy destructive

  Estimate energy cost for a smart contract call. Requires a full node with vm.supportConstant=true and vm.estimateEnergy=true; falls back to secondary node if primary does not support it.

  Parameters:

  • from (required) — string — Caller address (base58, starts with T)
  • contract_address (required) — string — Smart contract address (base58, starts with T)
  • method (required) — string — Contract method signature (e.g., 'transfer(address,uint256)')
  • params (required) — string — Method parameters as JSON array. Plain values: ["TJD...", "1000"] (types inferred from method signature). Typed objects also accepted: [{"address": "TJD..."}, {"uint256": "1000"}]

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• estimate_trc20_energy destructive

  Estimate energy cost for a TRC20 transfer without creating a transaction. Dry-runs the transfer to check energy requirements.

  Parameters:

  • from (required) — string — Sender address (base58, starts with T)
  • to (required) — string — Recipient address (base58, starts with T)
  • contract_address (required) — string — TRC20 contract address (base58, starts with T)
  • amount (required) — string — Amount in human-readable units (e.g., '100.5' for 100.5 USDT)

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• freeze_balance destructive

  Stake TRX for energy or bandwidth (Stake 2.0). Returns unsigned transaction hex for signing.

  Parameters:

  • from (required) — string — Account address (base58, starts with T)
  • amount (required) — string — Amount in TRX to stake (e.g., '100.5')
  • resource (required) — string — Resource type
  • memo — string — Optional memo to attach to the transaction
  • permission_id — number — Permission ID for multi-sig transactions

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• get_account destructive

  Get TRON account balance and details including TRX balance, bandwidth, energy, frozen resources, and account type

  Parameters:

  • address (required) — string — TRON base58 address (starts with T)

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• get_account_permissions destructive

  Get the permission structure of a TRON account including owner, active, and witness permissions with multi-sig keys and thresholds

  Parameters:

  • address (required) — string — TRON base58 address (starts with T)

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• get_account_resources destructive

  Get energy and bandwidth usage and limits for a TRON account

  Parameters:

  • address (required) — string — TRON base58 address (starts with T)

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• get_bandwidth_prices destructive

  Get current and historical bandwidth prices on the TRON network

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• get_block destructive

  Get a TRON block by number or latest. Use include_transactions to get transaction details with decoded contract data (sender, receiver, amounts) and pagination.

  Parameters:

  • limit — number — Max transactions to return when include_transactions is true (default: 50)
  • offset — number — Skip first N transactions (default: 0, for pagination)
  • block_number — number — Block number (omit for latest)
  • transaction_type — string — Filter transactions by type (e.g., 'TransferContract', 'TriggerSmartContract')
  • include_transactions — boolean — Include decoded transaction details with contract data — sender, receiver, amounts (default: false)

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• get_chain_parameters destructive

  Get TRON network node info and current energy/bandwidth prices

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• get_contract_abi destructive

  Get the ABI of a smart contract on TRON. Automatically resolves proxy contracts (ERC-1967). Note: many TRON contracts are deployed without on-chain ABI — if empty, check TronScan for verified source code.

  Parameters:

  • contract_address (required) — string — Smart contract address (base58, starts with T)

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• get_contract_events destructive

  Get decoded events emitted by a smart contract via TronGrid REST API. Returns a compact summary per event. Use a small limit and paginate with fingerprint to control response size

  Parameters:

  • contract_address (required) — string — TRON smart contract base58 address (starts with T)
  • limit — number — Number of results to return (1-200, default 10). Start small to avoid large responses; use fingerprint to paginate for more
  • event_name — string — Filter by specific event name (e.g. Transfer, Approval)
  • fingerprint — string — Pagination cursor from previous response meta.fingerprint — pass to fetch the next page
  • max_timestamp — number — Maximum block timestamp in milliseconds
  • min_timestamp — number — Minimum block timestamp in milliseconds
  • only_confirmed — boolean — Only return confirmed transactions

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• get_delegatable_amount destructive

  Get the maximum amount of energy or bandwidth an account can still delegate

  Parameters:

  • address (required) — string — TRON base58 address (starts with T)
  • resource (required) — string — Resource type

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• get_delegated_resources destructive

  Get resources delegated to and from an account (Stake 2.0 delegation info)

  Parameters:

  • address (required) — string — TRON base58 address (starts with T)

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• get_energy_prices destructive

  Get current and historical energy prices on the TRON network

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• get_network destructive

  Get current MCP server connection info: network name, node address, and latest block

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• get_pending_by_address destructive

  Get pending transactions for a specific address from the mempool

  Parameters:

  • address (required) — string — TRON address (base58, starts with T)

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• get_pending_transactions destructive

  List pending transaction IDs and pool size from the mempool

  Parameters:

  • limit — number — Max transaction IDs to return (default: 10)
  • offset — number — Skip first N transaction IDs (default: 0, for pagination)

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• get_pq_capabilities destructive

  Report which TIP-899 post-quantum signature schemes the connected node enables and this build can sign (FN-DSA-512 needs the gotron-mcp-pq build). TIP-899 is a draft live only on Nile. can_sign reflects the node and this build; signing also needs local mode with a keystore.

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• get_proposal destructive

  Get full details of a governance proposal by ID, including the complete list of approval addresses.

  Parameters:

  • proposal_id (required) — number — Proposal ID

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• get_token_price destructive

  Get the current USD price of TRX or a TRC20 token. Uses CoinGecko with caching.

  Parameters:

  • token (required) — string — Token to price: 'TRX' or a TRC20 contract address (e.g., TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t for USDT)

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• get_transaction destructive

  Get transaction details by transaction ID

  Parameters:

  • transaction_id (required) — string — Transaction hash / txid (64-char hex string)

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• get_transaction_history destructive

  Get transaction history for a TRON address via TronGrid REST API. Returns a compact summary per transaction. Use a small limit and paginate with fingerprint to control response size

  Parameters:

  • address (required) — string — TRON base58 address (starts with T)
  • limit — number — Number of results to return (1-200, default 10). Start small to avoid large responses; use fingerprint to paginate for more
  • only_to — boolean — Only show incoming transactions
  • only_from — boolean — Only show outgoing transactions
  • fingerprint — string — Pagination cursor from previous response meta.fingerprint — pass to fetch the next page
  • max_timestamp — number — Maximum block timestamp in milliseconds
  • min_timestamp — number — Minimum block timestamp in milliseconds
  • only_confirmed — boolean — Only return confirmed transactions

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• get_trc20_allowance destructive

  Query how many tokens a spender is approved to transfer on behalf of the owner. Flags unlimited approvals as high risk.

  Parameters:

  • owner (required) — string — Token owner address (base58)
  • spender (required) — string — Approved spender address (base58)
  • contract_address (required) — string — TRC20 token contract address

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• get_trc20_balance destructive

  Get TRC20 token balance for an account

  Parameters:

  • address (required) — string — TRON base58 address
  • contract_address (required) — string — TRC20 contract address

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• get_trc20_token_info destructive

  Get TRC20 token metadata (name, symbol, decimals, total supply)

  Parameters:

  • contract_address (required) — string — TRC20 contract address

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• get_trc20_transfers destructive

  Get TRC20 token transfer history for a TRON address via TronGrid REST API. Returns a compact summary per transfer with token info. Use a small limit and paginate with fingerprint to control response size

  Parameters:

  • address (required) — string — TRON base58 address (starts with T)
  • limit — number — Number of results to return (1-200, default 10). Start small to avoid large responses; use fingerprint to paginate for more
  • only_to — boolean — Only show incoming transfers
  • only_from — boolean — Only show outgoing transfers
  • fingerprint — string — Pagination cursor from previous response meta.fingerprint — pass to fetch the next page
  • max_timestamp — number — Maximum block timestamp in milliseconds
  • min_timestamp — number — Minimum block timestamp in milliseconds
  • only_confirmed — boolean — Only return confirmed transactions

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• is_transaction_pending destructive

  Check if a specific transaction is still in the pending pool (mempool)

  Parameters:

  • transaction_id (required) — string — Transaction hash / txid (64-char hex string)

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• list_contract_methods destructive

  Get a human-readable summary of a smart contract's methods with signatures, inputs, outputs, and mutability. Auto-resolves proxy contracts.

  Parameters:

  • contract_address (required) — string — Smart contract address (base58, starts with T)

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• list_proposals destructive

  List governance proposals on the TRON network with pagination support. Returns a compact summary per proposal (use get_proposal for full details including approval addresses). Newest first by default.

  Parameters:

  • limit — number — Max proposals to return (default: 5)
  • order — string — Sort order by proposal ID: 'desc' (default, newest first) or 'asc' (oldest first)
  • offset — number — Skip first N proposals (default: 0, for pagination)

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• list_witnesses destructive

  List super representatives (witnesses) on the TRON network with pagination support.

  Parameters:

  • limit — number — Max witnesses to return (default: 5)
  • offset — number — Skip first N witnesses (default: 0, for pagination)

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• revoke_approval destructive

  Build unsigned transaction to revoke a TRC20 token approval (sets allowance to 0)

  Parameters:

  • owner (required) — string — Token owner address (base58) — the account revoking the approval
  • spender (required) — string — Spender address to revoke
  • contract_address (required) — string — TRC20 token contract address
  • fee_limit — number — Fee limit in TRX (default 15, max 15000)
  • permission_id — number — Permission ID for multi-sig transactions

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• transfer_trc20 destructive

  Create an unsigned TRC20 token transfer transaction. Returns transaction hex for signing.

  Parameters:

  • from (required) — string — Sender address (base58, starts with T)
  • to (required) — string — Recipient address (base58, starts with T)
  • contract_address (required) — string — TRC20 contract address (base58, starts with T)
  • amount (required) — string — Amount in token units (human-readable, e.g., '100.5')
  • fee_limit — number — Fee limit in TRX, range 0-15000 (default: 100)
  • permission_id — number — Permission ID for multi-sig transactions

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• transfer_trx destructive

  Create an unsigned TRX transfer transaction. Returns transaction hex for signing.

  Parameters:

  • from (required) — string — Sender address (base58, starts with T)
  • to (required) — string — Recipient address (base58, starts with T)
  • amount (required) — string — Amount in TRX (e.g., '100.5')
  • memo — string — Optional memo to attach to the transaction
  • permission_id — number — Permission ID for multi-sig transactions

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• trigger_constant_contract destructive

  Call a read-only (view/pure) smart contract method. No transaction created, no fees. Returns decoded result. Provide either method+params OR data (pre-packed calldata).

  Parameters:

  • contract_address (required) — string — Smart contract address (base58, starts with T)
  • data — string — Pre-packed ABI calldata as hex (0x prefix optional). When provided, method and params are ignored.
  • from — string — Caller address (base58, starts with T; optional — defaults to zero address)
  • method — string — Method signature (e.g., 'totalSupply()', 'balanceOf(address)'). Required unless data is provided.
  • params — string — Method parameters as JSON array. Plain values: ["TJD...", "1000"] (types inferred from method signature). Typed objects also accepted: [{"address": "TJD..."}, {"uint256": "1000"}]
  • token_id — string — TRC10 token ID for simulating TRC10 token transfers
  • call_value — number — Amount in SUN to send with call (default: 0, 1 TRX = 1000000 SUN). Required for simulating payable functions.
  • token_value — number — TRC10 token amount to send with call (default: 0)

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• trigger_contract destructive

  Call a smart contract method. Returns unsigned transaction hex for signing. Provide either method+params OR data (pre-packed calldata).

  Parameters:

  • from (required) — string — Caller address (base58, starts with T)
  • contract_address (required) — string — Smart contract address (base58, starts with T)
  • data — string — Pre-packed ABI calldata as hex (0x prefix optional). When provided, method and params are ignored.
  • method — string — Method signature (e.g., 'transfer(address,uint256)'). Required unless data is provided.
  • params — string — Method parameters as JSON array. Plain values: ["TJD...", "1000"] (types inferred from method signature). Typed objects also accepted: [{"address": "TJD..."}, {"uint256": "1000"}]
  • fee_limit — number — Fee limit in whole TRX (integer), range 0-15000 (default: 100)
  • call_value — number — Amount to send with call in SUN (default: 0)
  • permission_id — number — Permission ID for multi-sig transactions

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• undelegate_resource destructive

  Reclaim previously delegated energy or bandwidth (Stake 2.0). Returns unsigned transaction hex for signing.

  Parameters:

  • from (required) — string — Delegator address (base58, starts with T)
  • to (required) — string — Address to reclaim from (base58, starts with T)
  • resource (required) — string — Resource type
  • amount (required) — string — Amount in TRX to undelegate (e.g., '100.5')
  • memo — string — Optional memo to attach to the transaction
  • permission_id — number — Permission ID for multi-sig transactions

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• unfreeze_balance destructive

  Unstake TRX (Stake 2.0). Returns unsigned transaction hex for signing. Note: unstaked TRX has a 14-day withdrawal period.

  Parameters:

  • from (required) — string — Account address (base58, starts with T)
  • amount (required) — string — Amount in TRX to unstake (e.g., '100.5')
  • resource (required) — string — Resource type
  • memo — string — Optional memo to attach to the transaction
  • permission_id — number — Permission ID for multi-sig transactions

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• validate_address destructive

  Validate a TRON address and convert supported inputs to TRON base58/hex. Accepts base58 (T...), TRON hex (41...), or Ethereum/EVM format (0x...).

  Parameters:

  • address (required) — string — TRON address (base58 T..., hex 41..., or Ethereum 0x...)

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• vote_witness destructive

  Vote for super representatives. Returns unsigned transaction hex for signing. Requires staked TRX (1 TRX staked = 1 vote).

  Parameters:

  • from (required) — string — Voter address (base58, starts with T)
  • votes (required) — object — Map of witness address to vote count, e.g., {"TKSXDA...": 100, "TLyqz...": 50}
  • memo — string — Optional memo to attach to the transaction
  • permission_id — number — Permission ID for multi-sig transactions

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• withdraw_expire_unfreeze destructive

  Withdraw TRX that has completed the 14-day unstaking period (Stake 2.0). Returns unsigned transaction hex for signing.

  Parameters:

  • from (required) — string — Account address (base58, starts with T)
  • memo — string — Optional memo to attach to the transaction
  • permission_id — number — Permission ID for multi-sig transactions

  Hints: read-only no · destructive yes · idempotent no · open-world yes

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.