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

```bash