# GoTRON MCP

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

- name: io.github.fbsobreira/gotron-mcp
- version: 0.4.1
- connection class: R0 (autonomous)
- trust: 96/100
- quality: 89/100 (new)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/io.github.fbsobreira%2Fgotron-mcp
- tools: https://api.protogrid.dev/v1/servers/io.github.fbsobreira%2Fgotron-mcp/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "gotron-mcp": {
      "type": "http",
      "url": "https://mcp.gotron.sh/mcp"
    }
  }
}
```


## Trust

- hygiene: 95
- liveness: 100
- freshness: 100
- provenance: 90
- drivers: +repository +namespace-matches-repo +website +reachable +uptime-100% +updated-7d-ago -unpinned-packages(1)
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 89/100 (new)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 100 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 44 of 44 tools declare readOnlyHint or destructiveHint
- pass `tools.directory_hints`: every tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
- pass `tools.token_cost`: about 6,372 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: n/a (weight 15)

- n/a `stability.changes`, `stability.rug_pull`: tool history recorded for 6 of the 7 days needed

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 44, about 6,372 tokens to load them all
- tool set hash: 34af9329717e908fe7393ceed83da000
- badge: [![protogrid quality](https://protogrid.dev/badge/io.github.fbsobreira/gotron-mcp.svg)](https://protogrid.dev/servers/io.github.fbsobreira/gotron-mcp)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

_No tool definition changes recorded._

## Remotes

- https://mcp.gotron.sh/mcp (streamable-http, auth none, reachable true, uptime30d 1)

## Packages

- oci ghcr.io/fbsobreira/gotron-mcp:0.4.1 secrets: GOTRON_NODE_API_KEY

## Tools (44)

- `analyze_account`: Comprehensive account overview: balance, resources, staking, voting, permissions, and delegations in a single call
- `analyze_transfer_cost`: Estimate the cost of a TRX or TRC20 transfer: energy, bandwidth, and TRX burn options
- `decode_abi_output`: Decode ABI-encoded output hex from a contract call. Handles return values, revert reasons (Error(string)), and panic codes (Panic(uint256)).
- `delegate_resource`: Delegate energy or bandwidth to another address (Stake 2.0). Returns unsigned transaction hex for signing.
- `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.
- `estimate_trc20_energy`: Estimate energy cost for a TRC20 transfer without creating a transaction. Dry-runs the transfer to check energy requirements.
- `freeze_balance`: Stake TRX for energy or bandwidth (Stake 2.0). Returns unsigned transaction hex for signing.
- `get_account`: Get TRON account balance and details including TRX balance, bandwidth, energy, frozen resources, and account type
- `get_account_permissions`: Get the permission structure of a TRON account including owner, active, and witness permissions with multi-sig keys and thresholds
- `get_account_resources`: Get energy and bandwidth usage and limits for a TRON account
- `get_bandwidth_prices`: Get current and historical bandwidth prices on the TRON network
- `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.
- `get_chain_parameters`: Get TRON network node info and current energy/bandwidth prices
- `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.
- `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
- `get_delegatable_amount`: Get the maximum amount of energy or bandwidth an account can still delegate
- `get_delegated_resources`: Get resources delegated to and from an account (Stake 2.0 delegation info)
- `get_energy_prices`: Get current and historical energy prices on the TRON network
- `get_network`: Get current MCP server connection info: network name, node address, and latest block
- `get_pending_by_address`: Get pending transactions for a specific address from the mempool
- `get_pending_transactions`: List pending transaction IDs and pool size from the mempool
- `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.
- `get_proposal`: Get full details of a governance proposal by ID, including the complete list of approval addresses.
- `get_token_price`: Get the current USD price of TRX or a TRC20 token. Uses CoinGecko with caching.
- `get_transaction`: Get transaction details by transaction ID
- `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
- `get_trc20_allowance`: Query how many tokens a spender is approved to transfer on behalf of the owner. Flags unlimited approvals as high risk.
- `get_trc20_balance`: Get TRC20 token balance for an account
- `get_trc20_token_info`: Get TRC20 token metadata (name, symbol, decimals, total supply)
- `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
- `is_transaction_pending`: Check if a specific transaction is still in the pending pool (mempool)
- `list_contract_methods`: Get a human-readable summary of a smart contract's methods with signatures, inputs, outputs, and mutability. Auto-resolves proxy contracts.
- `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.
- `list_witnesses`: List super representatives (witnesses) on the TRON network with pagination support.
- `revoke_approval`: Build unsigned transaction to revoke a TRC20 token approval (sets allowance to 0)
- `transfer_trc20`: Create an unsigned TRC20 token transfer transaction. Returns transaction hex for signing.
- `transfer_trx`: Create an unsigned TRX transfer transaction. Returns transaction hex for signing.
- `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).
- `trigger_contract`: Call a smart contract method. Returns unsigned transaction hex for signing. Provide either method+params OR data (pre-packed calldata).
- `undelegate_resource`: Reclaim previously delegated energy or bandwidth (Stake 2.0). Returns unsigned transaction hex for signing.
- `unfreeze_balance`: Unstake TRX (Stake 2.0). Returns unsigned transaction hex for signing. Note: unstaked TRX has a 14-day withdrawal period.
- `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...).
- `vote_witness`: Vote for super representatives. Returns unsigned transaction hex for signing. Requires staked TRX (1 TRX staked = 1 vote).
- `withdraw_expire_unfreeze`: Withdraw TRX that has completed the 14-day unstaking period (Stake 2.0). Returns unsigned transaction hex for signing.