gotron-mcp

README

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

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

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

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.

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

Community

Built and maintained by a CryptoChain community developer.

If you find this project useful, consider supporting TRON governance by voting for the CryptoChain Super Representative:

• Vote on TronScan
• SR Address: TKSXDA8HfE9E1y39RczVQ1ZascUEtaSToF

License

LGPL-3.0 — same as the GoTRON SDK.

Links

• GoTRON SDK
• GoTRON
• MCP Specification