Skip to content
tron.guide

MCP Server & TRON Skills

The TronGrid MCP Server bridges the TRON blockchain directly to AI coding assistants like Claude Code and Cursor. Leverage 149 specialized tools and natural language Skills to query wallets, decode transactions, and analyze smart contracts without writing a single line of boilerplate API code.

What is MCP?

Section titled “What is MCP?”

Model Context Protocol (MCP) is an open standard for connecting AI assistants to external services. When an MCP server is configured, your AI client — Claude Code, Claude Desktop, Cursor, Windsurf — can call tools on that server automatically during a conversation, whenever they’re relevant to what you’re asking.

For TRON developers this means querying wallets, reading contract state, decoding transactions, and composing transfers without switching tabs or writing boilerplate — all from inside your editor.

The TronGrid MCP Server is the official TRON implementation, maintained by the TronGrid team. It exposes 149 tools at https://mcp.trongrid.io/mcp.

Setup

Section titled “Setup”

Claude Code

Section titled “Claude Code”

Add the server with a single terminal command:

Terminal
# Task: Connect the TRON MCP server to your local Claude Code instance.
claude mcp add --transport http tron-mcp https://mcp.trongrid.io/mcp


# With a TronGrid API key (higher rate limits):
claude mcp add --transport http tron-mcp https://mcp.trongrid.io/mcp \
  --header "TRON-PRO-API-KEY:your-api-key"

Confirm it’s live: run /mcp inside Claude Code — tron-mcp should appear as connected.

Claude Desktop (Mac)

Section titled “Claude Desktop (Mac)”

Open ~/Library/Application Support/Claude/claude_desktop_config.json and add:

claude_desktop_config.json
// Task: Add the TRON MCP server to your Claude Desktop configuration file.
{
  "mcpServers": {
    "tron-mcp": {
      "type": "http",
      "url": "https://mcp.trongrid.io/mcp",
      "headers": {
        "TRON-PRO-API-KEY": "your-api-key"
      }
    }
  }
}

Restart Claude Desktop after saving.

For the full configuration reference and other MCP clients, see the official MCP API docs.

Tool Categories

Section titled “Tool Categories”

The 149 tools are organized into four groups. You don’t call these directly — TRON Skills (below) orchestrate them automatically, and Claude will invoke whichever are relevant when you ask a question. But understanding what’s available helps you know what’s possible.

HTTP REST Queries — 18 tools

Read on-chain data via TronGrid’s REST API: account info, TRC-20 token transfers, internal transactions, contract events and logs, asset details, and block statistics.

Best for dashboards, balance checkers, and event monitors.

Wallet Operations — 73 tools

The full TRON Full Node API: create and broadcast transactions, manage accounts, stake and unstake TRX (both Stake 1.0 and 2.0), deploy and call smart contracts, handle Super Representative operations, and submit governance proposals.

Best for programmatic wallets, automated staking, and CI/CD contract deployment.

WalletSolidity Read-Only — 25 tools

Query the solidified (irreversible) blockchain state only — confirmed accounts, finalized transactions, settled delegations, solidified blocks. These tools have a solidity prefix and guarantee the data will never roll back.

Best for exchange settlement confirmation, audit trails, and reconciliation.

JSON-RPC / EVM-Compatible — 33 tools

Ethereum-compatible JSON-RPC: eth_getBalance, eth_call, eth_estimateGas, block queries, transaction receipts, storage reads. Lets existing EVM tooling target TRON with minimal changes.

Best for porting Ethereum scripts, using Ethers.js or viem against TRON, or Hardhat compatibility layers.

All Available Tools

Section titled “All Available Tools”
Tool NameCategoryDescription
getBlockStatisticsBlocksGet statistics for a specific TRON block by block number.
getAccountInfoAccountsGet account information for a TRON address.
getAccountTransactionsAccountsGet recent transactions for a TRON account address.
getAccountTrc20TransactionsAccountsGet TRC-20 token transfer history for a TRON account.
getInternalTransactionsAccountsGet internal transactions for a TRON account address.
getInternalTransactionsByTxIdAccountsGet internal transactions for a specific transaction ID.
getTrc20BalanceAccountsGet TRC-20 token balances for a TRON account address.
listAllAssetsAssetsList all TRC-10 assets (tokens) on the TRON blockchain.
getAssetByNameAssetsGet TRC-10 assets by name.
getAssetByIdentifierAssetsGet a TRC-10 asset by its numeric ID or issuer address.
getContractTransactionsContractsGet transactions for a smart contract address.
getContractInternalTransactionsContractsGet internal transactions for a smart contract.
getTrc20TokenHoldersContractsGet TRC-20 token holder balances for a contract address.
getEventsByTransactionIdEventsGet events emitted by a specific transaction.
getEventsByContractAddressEventsGet events emitted by a smart contract address.
getEventsByBlockNumberEventsGet events from a specific block number.
getEventsByLatestBlockEventsGet events from the latest block.
getTrc20InfoTRC-20 TokensGet token info (name, symbol, decimals) for TRC-20/721/1155 tokens.

TRON Skills

Section titled “TRON Skills”

TRON Skills are pre-built workflows layered on top of the MCP tools. Instead of knowing which tools to call and in what order, you ask a natural language question — the Skill orchestrates multiple tool calls and returns a formatted, readable report.

Eight Skills ship with the TronGrid MCP Server and activate automatically once it’s connected. No extra configuration needed.

The eight Skills

Section titled “The eight Skills”
SkillWhat you askWhat you get
Account Profiling”Profile wallet TN3W4H…”Asset breakdown, resource levels, recent activity, delegations
Block Info”What happened in block 68000000?”Block metadata, transaction count, miner, rewards
Contract Analysis”Is this contract safe? [address]“ABI summary, function exposure, ownership, risk flags
Data Insights”How’s network activity trending?”TPS, active addresses, transfer volume, health metrics
Token List”What are the top TRC-20 tokens right now?”Ranked list with price, volume, and market cap
Token Scanner”Deep dive on USDT on TRON”Supply, holder count, transfer volume, contract verification status
Transaction Info”Decode this transaction: [hash]“Human-readable inputs, internal calls, Energy consumed, revert reason if any
TRX Info”What’s TRX priced at and what’s staking yield?”Price, market cap, staking APY, Energy economics

Try these prompts

Section titled “Try these prompts”

Copy and paste any of these into Claude Code after setup:

Prompt Examples
// Task: Use these natural language prompts to trigger specialized TRON Skills.
Profile wallet TJDENsfBJs4RFETt1X1W8wMDc8M5XnJhCe and summarize its staking position


Analyze contract TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t — what does it do and are there any concerns?


Show me the last 10 TRC-20 transfers for address TN3W4H6rK2ce4vX9YnFQHwKENnHjoxb2Jq


Decode transaction [paste any tx hash] and explain what it did in plain English


Which TRC-20 tokens have seen the most transfer volume in the past 24 hours?


What is the current staking yield for TRX and how much Energy does 10,000 TRX generate per day?

MCP tools vs. TRON Skills

Section titled “MCP tools vs. TRON Skills”

Both are available simultaneously — you don’t have to choose.

Raw MCP toolsTRON Skills
How to invokeTool name + exact parametersNatural language question
Prior knowledge neededAPI surface, parameter namesNone
Multi-step queriesManual orchestrationAutomatic
OutputRaw JSONFormatted report
Best forAutomation, scripts, custom integrationsExploration, research, debugging

Use Skills when you’re investigating, debugging, or exploring. Use raw MCP tools when you’re building automation or need structured JSON output for further processing.

Rate limits

Section titled “Rate limits”
TierRequestsHow to get
FreeStandard TronGrid limitsNo key required
ProHigher throughputAPI key from trongrid.io

Pass your key as the TRON-PRO-API-KEY header in your MCP configuration (shown in Setup above).

For direct node endpoints and REST API access without MCP, see API & Node Access.