GoTRON MCP

★ 2

from fbsobreira

About MCP server for TRON blockchain — connect AI agents to TRX, TRC20, smart contracts, staking & governance via GoTRON SDK

🔥🔥🔥✓ VerifiedAccount requiredNeeds API keys

#automation #devops #git #finance #security

GoTRON MCP Server

MCP server for TRON blockchain — let AI agents query balances, tokens, blocks, and build transactions.

Built on the GoTRON SDK and the Model Context Protocol.

Two Modes

	Local Mode	Hosted Mode
Transport	stdio	Streamable HTTP
Read tools	All	All
Transaction builders	All (unsigned tx hex)	All (unsigned tx hex)
Sign/Broadcast	Opt-in via `--keystore`	Disabled
Install	Required	Zero install

Available Tools

Read-Only (both modes)

Tool	Description
`get_account`	Get account balance, bandwidth, energy, and details
`get_account_resources`	Get energy/bandwidth usage and limits
`get_trc20_balance`	Get TRC20 token balance for an account
`get_trc20_token_info`	Get TRC20 token name, symbol, and decimals
`get_block`	Get block by number or latest
`get_transaction`	Get transaction details by ID
`list_witnesses`	List all super representatives
`get_contract_abi`	Get smart contract ABI
`estimate_energy`	Estimate energy cost for a contract call
`trigger_constant_contract`	Call read-only (view/pure) smart contract method
`decode_abi_output`	Decode ABI-encoded output or revert reasons from contract calls
`list_contract_methods`	Get human-readable summary of contract methods
`get_chain_parameters`	Get network parameters
`validate_address`	Validate a TRON address
`get_energy_prices`	Get energy price history
`get_bandwidth_prices`	Get bandwidth price history
`list_proposals`	List governance proposals
`get_network`	Get current network connection info

Transaction Builders (both modes)

Tool	Description
`transfer_trx`	Build unsigned TRX transfer
`transfer_trc20`	Build unsigned TRC20 token transfer
`freeze_balance`	Build unsigned stake TRX for energy/bandwidth (Stake 2.0)
`unfreeze_balance`	Build unsigned unstake TRX (Stake 2.0)
`vote_witness`	Build unsigned vote for super representatives
`trigger_contract`	Build unsigned smart contract call

Sign & Broadcast (local mode + keystore)

Tool	Description
`sign_transaction`	Sign transaction using local keystore
`broadcast_transaction`	Broadcast signed transaction to network

Security

The server never stores or manages private keys directly
All write tools return unsigned transaction hex — the user decides how to sign
Keystore signing is opt-in via --keystore flag
In hosted (HTTP) mode, all write and sign tools are automatically disabled
API key is optional and only needed for TronGrid rate limits

Development

# Build
make build

# Format code
make fmt

# Run tests
make test

# Lint
make lint

# Run HTTP mode locally
make run-http

Links

Copy & paste — that's it

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

Before it works, you'll need: GOTRON_NODE_API_KEY

Install

Go Install

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

Hosted (zero install)

Connect directly to https://mcp.gotron.sh/mcp — no installation needed.

Claude Desktop Configuration

Local mode

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

Local mode with keystore signing

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

Hosted mode (zero install)

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

Claude Code

Add to current project:

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

With keystore:

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

Add globally:

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

Hosted (zero install):

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

Configuration

Flag	Env Var	Default	Description
`--node`	`GOTRON_MCP_NODE`	(per network)	TRON gRPC node address
`--api-key`	`GOTRON_NODE_API_KEY`	—	TronGrid API key
`--network`	`GOTRON_MCP_NETWORK`	`mainnet`	Network: mainnet, nile, shasta
`--transport`	—	`stdio`	Transport: stdio, http
`--port`	—	`8080`	HTTP server port
`--bind`	—	`127.0.0.1`	HTTP server bind address
`--fallback-node`	`GOTRON_MCP_FALLBACK_NODE`	—	Fallback gRPC node (auto-failover)
`--keystore`	—	—	Path to tronctl keystore directory
`--tls`	—	`false`	Use TLS for gRPC connection (default: plaintext)

Network Presets

Network	Default Node
mainnet	`grpc.trongrid.io:50051`
nile	`grpc.nile.trongrid.io:50051`
shasta	`grpc.shasta.trongrid.io:50051`

Explicit --node overrides network presets.