GoTRON MCP

Servidor GoTRON MCP

Servidor MCP para la cadena de bloques TRON: permite a los agentes de IA consultar saldos, tokens, bloques y construir transacciones.

Construido sobre el GoTRON SDK y el Model Context Protocol.

Dos Modos

	Modo Local	Modo Alojado
Transporte	stdio	Streamable HTTP
Herramientas de lectura	Todas	Todas
Constructores de transacciones	Todos (hex de tx sin firmar)	Todos (hex de tx sin firmar)
Firmar/Transmitir	Opt-in mediante --keystore	Deshabilitado
Instalación	Requerida	Instalación cero

Instalación

Instalación con Go

go install github.com/fbsobreira/gotron-mcp/cmd/gotron-mcp@latest

Homebrew

brew install fbsobreira/tap/gotron-mcp

curl

curl -fsSL gotron.sh/install-mcp | sh

Docker

docker run -p 8080:8080 ghcr.io/fbsobreira/gotron-mcp

Alojado (instalación cero)

Conéctate directamente a https://mcp.gotron.sh/mcp — no se necesita instalación.

Configuración de Claude Desktop

Modo local

{
  "mcpServers": {
    "gotron": {
      "command": "gotron-mcp",
      "args": ["--network", "mainnet"],
      "env": {
        "GOTRON_NODE_API_KEY": "your-trongrid-api-key"
      }
    }
  }
}

Modo local con firma mediante keystore

{
  "mcpServers": {
    "gotron": {
      "command": "gotron-mcp",
      "args": ["--network", "mainnet", "--keystore", "~/.tronctl/keystore"],
      "env": {
        "GOTRON_NODE_API_KEY": "your-trongrid-api-key"
      }
    }
  }
}

Modo alojado (instalación cero)

{
  "mcpServers": {
    "gotron": {
      "url": "https://mcp.gotron.sh/mcp"
    }
  }
}

Claude Code

Añadir al proyecto actual:

claude mcp add gotron --scope project -- gotron-mcp --network mainnet

Con keystore:

claude mcp add gotron --scope project -- gotron-mcp --network mainnet --keystore ~/.tronctl/keystore

Añadir globalmente:

claude mcp add gotron --scope user -- gotron-mcp --network mainnet

Alojado (instalación cero):

claude mcp add gotron --scope user --transport http https://mcp.gotron.sh/mcp

Herramientas Disponibles

Solo lectura (ambos modos)

Herramienta	Descripción
get_account	Obtener saldo de cuenta, ancho de banda, energía y detalles
get_account_resources	Obtener uso y límites de energía/ancho de banda
get_trc20_balance	Obtener saldo de token TRC20 para una cuenta
get_trc20_token_info	Obtener nombre, símbolo y decimales del token TRC20
get_block	Obtener bloque por número o el más reciente
get_transaction	Obtener detalles de transacción por ID
list_witnesses	Listar todos los super representantes
get_contract_abi	Obtener ABI de contrato inteligente
estimate_energy	Estimar costo de energía para una llamada a contrato
trigger_constant_contract	Llamar a método de contrato inteligente de solo lectura (view/pure)
decode_abi_output	Decodificar salida codificada en ABI o razones de reversión de llamadas a contrato
list_contract_methods	Obtener resumen legible de métodos de contrato
get_chain_parameters	Obtener parámetros de red
validate_address	Validar una dirección TRON
get_energy_prices	Obtener historial de precios de energía
get_bandwidth_prices	Obtener historial de precios de ancho de banda
list_proposals	Listar propuestas de gobernanza
get_network	Obtener información actual de conexión de red

Constructores de transacciones (ambos modos)

Herramienta	Descripción
transfer_trx	Construir transferencia TRX sin firmar
transfer_trc20	Construir transferencia de token TRC20 sin firmar
freeze_balance	Construir stake TRX sin firmar para energía/ancho de banda (Stake 2.0)
unfreeze_balance	Construir unstake TRX sin firmar (Stake 2.0)
vote_witness	Construir voto sin firmar para super representantes
trigger_contract	Construir llamada a contrato inteligente sin firmar

Firmar y transmitir (modo local + keystore)

Herramienta	Descripción
sign_transaction	Firmar transacción usando keystore local
broadcast_transaction	Transmitir transacción firmada a la red

Configuración

Bandera	Variable de entorno	Predeterminado	Descripción
--node	GOTRON_MCP_NODE	(por red)	Dirección del nodo gRPC de TRON
--api-key	GOTRON_NODE_API_KEY	—	Clave de API de TronGrid
--network	GOTRON_MCP_NETWORK	mainnet	Red: mainnet, nile, shasta
--transport	—	stdio	Transporte: stdio, http
--port	—	8080	Puerto del servidor HTTP
--bind	—	127.0.0.1	Dirección de enlace del servidor HTTP
--fallback-node	GOTRON_MCP_FALLBACK_NODE	—	Nodo gRPC de respaldo (conmutación automática)
--keystore	—	—	Ruta al directorio de keystore de tronctl
--tls	—	false	Usar TLS para conexión gRPC (predeterminado: texto plano)

Preajustes de red

Red	Nodo predeterminado
mainnet	grpc.trongrid.io:50051
nile	grpc.nile.trongrid.io:50051
shasta	grpc.shasta.trongrid.io:50051

--node explícito anula los preajustes de red.

Seguridad

• El servidor nunca almacena ni gestiona claves privadas directamente
• Todas las herramientas de escritura devuelven hex de transacción sin firmar — el usuario decide cómo firmar
• La firma con keystore es opt-in mediante la bandera --keystore
• En modo alojado (HTTP), todas las herramientas de escritura y firma se deshabilitan automáticamente
• La clave de API es opcional y solo se necesita para los límites de tasa de TronGrid

Desarrollo

# Build
make build

# Format code
make fmt

# Run tests
make test

# Lint
make lint

# Run HTTP mode locally
make run-http

Comunidad

Construido y mantenido por un desarrollador de la comunidad CryptoChain.

Si encuentras útil este proyecto, considera apoyar la gobernanza de TRON votando por el Super Representante de CryptoChain:

• Votar en TronScan
• Dirección SR: TKSXDA8HfE9E1y39RczVQ1ZascUEtaSToF

Licencia

LGPL-3.0 — igual que el GoTRON SDK.

Enlaces

• GoTRON SDK
• GoTRON
• Especificación MCP