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

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)

Transaction Builders (both modes)

Sign & Broadcast (local mode + keystore)

Configuration

Network Presets

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