Servers Playground How we check Add a server Log in

GoTRON MCP

Working · 2.1 s

io.github.fbsobreira/gotron-mcpv0.4.1

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

Crypto & Web3

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://mcp.gotron.sh/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

analyze_account Destructive

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

addressstring, required

TRON base58 address (starts with T)

The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.

I understand, run it anyway

GoTRON MCP MCP server | mcptry

Tools (44)

analyze_account

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

destructive

Argument	Type	Description
address*	string	TRON base58 address (starts with T)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "address"
  ],
  "properties": {
    "address": {
      "type": "string",
      "description": "TRON base58 address (starts with T)"
    }
  }
}

analyze_transfer_cost

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

destructive

Argument	Type	Description
to*	string	Recipient TRON address (base58)
from*	string	Sender TRON address (base58)
amount*	string	Amount to transfer (e.g., '100')
contract_address	string	TRC20 contract address (omit for TRX transfer)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "from",
    "to",
    "amount"
  ],
  "properties": {
    "to": {
      "type": "string",
      "description": "Recipient TRON address (base58)"
    },
    "from": {
      "type": "string",
      "description": "Sender TRON address (base58)"
    },
    "amount": {
      "type": "string",
      "description": "Amount to transfer (e.g., '100')"
    },
    "contract_address": {
      "type": "string",
      "description": "TRC20 contract address (omit for TRX transfer)"
    }
  }
}

decode_abi_output

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

destructive

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

Input schema (JSON)

{
  "type": "object",
  "required": [
    "contract_address",
    "method",
    "data"
  ],
  "properties": {
    "data": {
      "type": "string",
      "description": "Hex-encoded output bytes to decode (0x prefix optional)"
    },
    "method": {
      "type": "string",
      "description": "Method signature (e.g., 'balanceOf(address)')"
    },
    "contract_address": {
      "type": "string",
      "description": "Contract address (base58, starts with T; needed to fetch ABI for decoding)"
    }
  }
}

delegate_resource

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

destructive

Argument	Type	Description
to*	string	Recipient address (base58, starts with T)
from*	string	Delegator address (base58, starts with T)
memo	string	Optional memo to attach to the transaction
amount*	string	Amount in TRX to delegate (e.g., '100.5')
resource*	string	Resource type
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

Input schema (JSON)

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

estimate_energy

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.

destructive

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

Input schema (JSON)

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

estimate_trc20_energy

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

destructive

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

Input schema (JSON)

{
  "type": "object",
  "required": [
    "from",
    "to",
    "contract_address",
    "amount"
  ],
  "properties": {
    "to": {
      "type": "string",
      "description": "Recipient address (base58, starts with T)"
    },
    "from": {
      "type": "string",
      "description": "Sender address (base58, starts with T)"
    },
    "amount": {
      "type": "string",
      "description": "Amount in human-readable units (e.g., '100.5' for 100.5 USDT)"
    },
    "contract_address": {
      "type": "string",
      "description": "TRC20 contract address (base58, starts with T)"
    }
  }
}

freeze_balance

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

destructive

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

Input schema (JSON)

{
  "type": "object",
  "required": [
    "from",
    "amount",
    "resource"
  ],
  "properties": {
    "from": {
      "type": "string",
      "description": "Account address (base58, starts with T)"
    },
    "memo": {
      "type": "string",
      "description": "Optional memo to attach to the transaction"
    },
    "amount": {
      "type": "string",
      "description": "Amount in TRX to stake (e.g., '100.5')"
    },
    "resource": {
      "enum": [
        "ENERGY",
        "BANDWIDTH"
      ],
      "type": "string",
      "description": "Resource type"
    },
    "permission_id": {
      "type": "number",
      "description": "Permission ID for multi-sig transactions"
    }
  }
}

get_account

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

destructive

Argument	Type	Description
address*	string	TRON base58 address (starts with T)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "address"
  ],
  "properties": {
    "address": {
      "type": "string",
      "description": "TRON base58 address (starts with T)"
    }
  }
}

get_account_permissions

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

destructive

Argument	Type	Description
address*	string	TRON base58 address (starts with T)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "address"
  ],
  "properties": {
    "address": {
      "type": "string",
      "description": "TRON base58 address (starts with T)"
    }
  }
}

get_account_resources

Get energy and bandwidth usage and limits for a TRON account

destructive

Argument	Type	Description
address*	string	TRON base58 address (starts with T)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "address"
  ],
  "properties": {
    "address": {
      "type": "string",
      "description": "TRON base58 address (starts with T)"
    }
  }
}

get_bandwidth_prices

Get current and historical bandwidth prices on the TRON network

destructive

No arguments.

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {}
}

get_block

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

destructive

Argument	Type	Description
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)

Input schema (JSON)

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

get_chain_parameters

Get TRON network node info and current energy/bandwidth prices

destructive

No arguments.

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {}
}

get_contract_abi

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.

destructive

Argument	Type	Description
contract_address*	string	Smart contract address (base58, starts with T)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "contract_address"
  ],
  "properties": {
    "contract_address": {
      "type": "string",
      "description": "Smart contract address (base58, starts with T)"
    }
  }
}

get_contract_events

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

destructive

Argument	Type	Description
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
contract_address*	string	TRON smart contract base58 address (starts with T)

Input schema (JSON)

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

get_delegatable_amount

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

destructive

Argument	Type	Description
address*	string	TRON base58 address (starts with T)
resource*	string	Resource type

Input schema (JSON)

{
  "type": "object",
  "required": [
    "address",
    "resource"
  ],
  "properties": {
    "address": {
      "type": "string",
      "description": "TRON base58 address (starts with T)"
    },
    "resource": {
      "enum": [
        "ENERGY",
        "BANDWIDTH"
      ],
      "type": "string",
      "description": "Resource type"
    }
  }
}

get_delegated_resources

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

destructive

Argument	Type	Description
address*	string	TRON base58 address (starts with T)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "address"
  ],
  "properties": {
    "address": {
      "type": "string",
      "description": "TRON base58 address (starts with T)"
    }
  }
}

get_energy_prices

Get current and historical energy prices on the TRON network

destructive

No arguments.

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {}
}

get_network

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

destructive

No arguments.

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {}
}

get_pending_by_address

Get pending transactions for a specific address from the mempool

destructive

Argument	Type	Description
address*	string	TRON address (base58, starts with T)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "address"
  ],
  "properties": {
    "address": {
      "type": "string",
      "description": "TRON address (base58, starts with T)"
    }
  }
}

get_pending_transactions

List pending transaction IDs and pool size from the mempool

destructive

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

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "limit": {
      "type": "number",
      "description": "Max transaction IDs to return (default: 10)"
    },
    "offset": {
      "type": "number",
      "description": "Skip first N transaction IDs (default: 0, for pagination)"
    }
  }
}

get_pq_capabilities

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.

destructive

No arguments.

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {}
}

get_proposal

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

destructive

Argument	Type	Description
proposal_id*	number	Proposal ID

Input schema (JSON)

{
  "type": "object",
  "required": [
    "proposal_id"
  ],
  "properties": {
    "proposal_id": {
      "type": "number",
      "description": "Proposal ID"
    }
  }
}

get_token_price

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

destructive

Argument	Type	Description
token*	string	Token to price: 'TRX' or a TRC20 contract address (e.g., TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t for USDT)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "token"
  ],
  "properties": {
    "token": {
      "type": "string",
      "description": "Token to price: 'TRX' or a TRC20 contract address (e.g., TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t for USDT)"
    }
  }
}

get_transaction

Get transaction details by transaction ID

destructive

Argument	Type	Description
transaction_id*	string	Transaction hash / txid (64-char hex string)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "transaction_id"
  ],
  "properties": {
    "transaction_id": {
      "type": "string",
      "description": "Transaction hash / txid (64-char hex string)"
    }
  }
}

get_transaction_history

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

destructive

Argument	Type	Description
limit	number	Number of results to return (1-200, default 10). Start small to avoid large responses; use fingerprint to paginate for more
address*	string	TRON base58 address (starts with T)
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

Input schema (JSON)

get_trc20_allowance

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

destructive

Argument	Type	Description
owner*	string	Token owner address (base58)
spender*	string	Approved spender address (base58)
contract_address*	string	TRC20 token contract address

Input schema (JSON)

{
  "type": "object",
  "required": [
    "owner",
    "spender",
    "contract_address"
  ],
  "properties": {
    "owner": {
      "type": "string",
      "description": "Token owner address (base58)"
    },
    "spender": {
      "type": "string",
      "description": "Approved spender address (base58)"
    },
    "contract_address": {
      "type": "string",
      "description": "TRC20 token contract address"
    }
  }
}

get_trc20_balance

Get TRC20 token balance for an account

destructive

Argument	Type	Description
address*	string	TRON base58 address
contract_address*	string	TRC20 contract address

Input schema (JSON)

{
  "type": "object",
  "required": [
    "address",
    "contract_address"
  ],
  "properties": {
    "address": {
      "type": "string",
      "description": "TRON base58 address"
    },
    "contract_address": {
      "type": "string",
      "description": "TRC20 contract address"
    }
  }
}

get_trc20_token_info

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

destructive

Argument	Type	Description
contract_address*	string	TRC20 contract address

Input schema (JSON)

{
  "type": "object",
  "required": [
    "contract_address"
  ],
  "properties": {
    "contract_address": {
      "type": "string",
      "description": "TRC20 contract address"
    }
  }
}

get_trc20_transfers

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

destructive

Argument	Type	Description
limit	number	Number of results to return (1-200, default 10). Start small to avoid large responses; use fingerprint to paginate for more
address*	string	TRON base58 address (starts with T)
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

Input schema (JSON)

is_transaction_pending

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

destructive

Argument	Type	Description
transaction_id*	string	Transaction hash / txid (64-char hex string)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "transaction_id"
  ],
  "properties": {
    "transaction_id": {
      "type": "string",
      "description": "Transaction hash / txid (64-char hex string)"
    }
  }
}

list_contract_methods

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

destructive

Argument	Type	Description
contract_address*	string	Smart contract address (base58, starts with T)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "contract_address"
  ],
  "properties": {
    "contract_address": {
      "type": "string",
      "description": "Smart contract address (base58, starts with T)"
    }
  }
}

list_proposals

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.

destructive

Argument	Type	Description
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)

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "limit": {
      "type": "number",
      "description": "Max proposals to return (default: 5)"
    },
    "order": {
      "type": "string",
      "description": "Sort order by proposal ID: 'desc' (default, newest first) or 'asc' (oldest first)"
    },
    "offset": {
      "type": "number",
      "description": "Skip first N proposals (default: 0, for pagination)"
    }
  }
}

list_witnesses

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

destructive

Argument	Type	Description
limit	number	Max witnesses to return (default: 5)
offset	number	Skip first N witnesses (default: 0, for pagination)

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "limit": {
      "type": "number",
      "description": "Max witnesses to return (default: 5)"
    },
    "offset": {
      "type": "number",
      "description": "Skip first N witnesses (default: 0, for pagination)"
    }
  }
}

revoke_approval

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

destructive

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

Input schema (JSON)

{
  "type": "object",
  "required": [
    "owner",
    "spender",
    "contract_address"
  ],
  "properties": {
    "owner": {
      "type": "string",
      "description": "Token owner address (base58) — the account revoking the approval"
    },
    "spender": {
      "type": "string",
      "description": "Spender address to revoke"
    },
    "fee_limit": {
      "type": "number",
      "description": "Fee limit in TRX (default 15, max 15000)"
    },
    "permission_id": {
      "type": "number",
      "description": "Permission ID for multi-sig transactions"
    },
    "contract_address": {
      "type": "string",
      "description": "TRC20 token contract address"
    }
  }
}

transfer_trc20

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

destructive

Argument	Type	Description
to*	string	Recipient address (base58, starts with T)
from*	string	Sender address (base58, starts with T)
amount*	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
contract_address*	string	TRC20 contract address (base58, starts with T)

Input schema (JSON)

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

transfer_trx

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

destructive

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

Input schema (JSON)

{
  "type": "object",
  "required": [
    "from",
    "to",
    "amount"
  ],
  "properties": {
    "to": {
      "type": "string",
      "description": "Recipient address (base58, starts with T)"
    },
    "from": {
      "type": "string",
      "description": "Sender address (base58, starts with T)"
    },
    "memo": {
      "type": "string",
      "description": "Optional memo to attach to the transaction"
    },
    "amount": {
      "type": "string",
      "description": "Amount in TRX (e.g., '100.5')"
    },
    "permission_id": {
      "type": "number",
      "description": "Permission ID for multi-sig transactions"
    }
  }
}

trigger_constant_contract

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

destructive

Argument	Type	Description
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)
contract_address

trigger_contract

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

destructive

Argument	Type	Description
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)
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
contract_address*	string

undelegate_resource

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

destructive

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

Input schema (JSON)

{
  "type": "object",
  "required": [
    "from",
    "to",
    "resource",
    "amount"
  ],
  "properties": {
    "to": {
      "type": "string",
      "description": "Address to reclaim from (base58, starts with T)"
    },
    "from": {
      "type": "string",
      "description": "Delegator address (base58, starts with T)"
    },
    "memo": {
      "type": "string",
      "description": "Optional memo to attach to the transaction"
    },
    "amount": {
      "type": "string",
      "description": "Amount in TRX to undelegate (e.g., '100.5')"
    },
    "resource": {
      "enum": [
        "ENERGY",
        "BANDWIDTH"
      ],
      "type": "string",
      "description": "Resource type"
    },
    "permission_id": {
      "type": "number",
      "description": "Permission ID for multi-sig transactions"
    }
  }
}

unfreeze_balance

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

destructive

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

Input schema (JSON)

{
  "type": "object",
  "required": [
    "from",
    "amount",
    "resource"
  ],
  "properties": {
    "from": {
      "type": "string",
      "description": "Account address (base58, starts with T)"
    },
    "memo": {
      "type": "string",
      "description": "Optional memo to attach to the transaction"
    },
    "amount": {
      "type": "string",
      "description": "Amount in TRX to unstake (e.g., '100.5')"
    },
    "resource": {
      "enum": [
        "ENERGY",
        "BANDWIDTH"
      ],
      "type": "string",
      "description": "Resource type"
    },
    "permission_id": {
      "type": "number",
      "description": "Permission ID for multi-sig transactions"
    }
  }
}

validate_address

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

destructive

Argument	Type	Description
address*	string	TRON address (base58 T..., hex 41..., or Ethereum 0x...)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "address"
  ],
  "properties": {
    "address": {
      "type": "string",
      "description": "TRON address (base58 T..., hex 41..., or Ethereum 0x...)"
    }
  }
}

vote_witness

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

destructive

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

Input schema (JSON)

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

withdraw_expire_unfreeze

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

destructive

Argument	Type	Description
from*	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

Input schema (JSON)

{
  "type": "object",
  "required": [
    "from"
  ],
  "properties": {
    "from": {
      "type": "string",
      "description": "Account address (base58, starts with T)"
    },
    "memo": {
      "type": "string",
      "description": "Optional memo to attach to the transaction"
    },
    "permission_id": {
      "type": "number",
      "description": "Permission ID for multi-sig transactions"
    }
  }
}

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

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