Bỏ qua để đến nội dung
tron.guide

Máy chủ MCP & Kỹ năng TRON

Máy chủ MCP TronGrid giúp làm cầu nối giữa blockchain TRON và các trợ lý mã hóa (coding assistants) AI như Claude Code và Cursor một cách trực tiếp. Tận dụng 149 công cụ chuyên biệt cùng với các Kỹ năng xử lý ngôn ngữ tự nhiên (Skills) để truy vấn ví, giải mã giao dịch và phân tích các Hợp đồng thông minh mà không cần viết bất kỳ một dòng mã API tạo sẵn nào.

MCP là gì?

Phần tiêu đề “MCP là gì?”

Giao thức Ngữ cảnh Mô hình (Model Context Protocol - MCP) là một tiêu chuẩn mở nhằm kết nối các trợ lý AI với những dịch vụ bên ngoài. Khi một máy chủ MCP được cấu hình, trình khách (client) AI của bạn — Claude Code, Claude Desktop, Cursor, Windsurf — có thể tự động gọi tới các công cụ trên máy chủ đó trong một phiên trò chuyện bất cứ lúc nào chúng liên quan đến điều bạn đang hỏi.

Đối với các nhà phát triển TRON, điều này có nghĩa là bạn có thể truy vấn các ví, đọc trạng thái của Hợp đồng, giải mã các giao dịch, và tạo các khoản chuyển khoản mà không cần chuyển đổi tab hay viết code API — tất cả đều từ bên trong trình soạn thảo của bạn.

Máy chủ MCP TronGrid là quá trình triển khai chính thức của TRON, được bảo trì bởi đội ngũ TronGrid. Nó phơi bày 149 công cụ tại địa chỉ https://mcp.trongrid.io/mcp.

Thiết lập (Setup)

Phần tiêu đề “Thiết lập (Setup)”

Claude Code

Phần tiêu đề “Claude Code”

Thêm máy chủ thông qua một lệnh duy nhất ở cửa sổ dòng lệnh (terminal):

Terminal
// Task: Kết nối máy chủ MCP của TRON tới instance Claude Code cục bộ của bạn.
claude mcp add --transport http tron-mcp https://mcp.trongrid.io/mcp


# Với một Khóa API TronGrid (cho giới hạn tỷ lệ cao hơn):
claude mcp add --transport http tron-mcp https://mcp.trongrid.io/mcp \
  --header "TRON-PRO-API-KEY:your-api-key"

Xác nhận xem nó đã hoạt động chưa: hãy chạy lệnh /mcp bên trong Claude Code — bạn sẽ thấy tron-mcp hiện lên trạng thái đã kết nối.

Claude Desktop (Mac)

Phần tiêu đề “Claude Desktop (Mac)”

Mở file ~/Library/Application Support/Claude/claude_desktop_config.json và bổ sung thêm:

claude_desktop_config.json
// Task: Thêm máy chủ MCP của TRON vào tệp cấu hình Claude Desktop của bạn.
{
  "mcpServers": {
    "tron-mcp": {
      "type": "http",
      "url": "https://mcp.trongrid.io/mcp",
      "headers": {
        "TRON-PRO-API-KEY": "your-api-key"
      }
    }
  }
}

Hãy khởi động lại Claude Desktop sau khi lưu.

Để có một hướng dẫn cấu hình đầy đủ và các MCP clients khác, hãy xem thêm tài liệu API MCP chính thức.

Các Danh mục Công cụ

Phần tiêu đề “Các Danh mục Công cụ”

Có tất cả 149 công cụ được sắp xếp thành bốn nhóm. Bạn không trực tiếp gọi tới những công cụ này — Các Kỹ năng (Skills) của TRON (xem bên dưới) sẽ điều phối chúng một cách tự động, và Claude sẽ kích hoạt bất kỳ cái nào liên quan đến câu hỏi của bạn. Nhưng việc hiểu được các danh mục giúp bạn biết mình có thể làm được những gì.

Truy vấn HTTP REST — 18 công cụ

Đọc các dữ liệu on-chain thông qua REST API của TronGrid: thông tin tài khoản, chuyển khoản token TRC-20, giao dịch nội bộ, các sự kiện và bản ghi của hợp đồng, thông tin chi tiết về tài sản và số liệu thống kê về khối.

Tốt nhất cho các trang tổng quan, trình kiểm tra số dư và giám sát sự kiện.

Các thao tác với Ví — 73 công cụ

Toàn bộ Full Node API của TRON: tạo và phát đi các giao dịch, quản lý tài khoản, Khóa (stake) và Mở khóa (unstake) TRX (bao gồm cả Stake 1.0 và 2.0), triển khai và gọi đến các Hợp đồng thông minh, xử lý các hoạt động của Siêu Đại diện (Super Representative) và đệ trình các đề xuất quản trị.

Tốt nhất cho các ví tự động hóa, khóa TRX tự động và quy trình CI/CD triển khai hợp đồng.

WalletSolidity Chỉ Đọc — 25 công cụ

Truy vấn riêng trạng thái blockchain đã được đông đặc (solidified) (không thể đảo ngược) — các tài khoản đã được xác nhận, các giao dịch đã được chốt, các khoản ủy quyền được thanh toán, và các khối đã bị đông đặc. Các công cụ này mang tiền tố solidity và bảo đảm rằng dữ liệu sẽ không bao giờ bị khôi phục lại (roll back).

Tốt nhất cho việc xác nhận thanh toán của sàn giao dịch, vết kiểm toán (audit trails) và việc đối soát.

JSON-RPC / Tương thích EVM — 33 công cụ

JSON-RPC tương thích Ethereum: eth_getBalance, eth_call, eth_estimateGas, truy vấn khối, biên lai giao dịch, các điểm đọc bộ nhớ (storage reads). Cho phép các công cụ EVM nhắm thẳng vào TRON mà chỉ cần thay đổi rất ít.

Tốt nhất cho việc di chuyển các script từ Ethereum qua, sử dụng Ethers.js hay viem tương tác với TRON, hoặc cần những tầng tương thích của Hardhat.

Tất cả Các Công cụ Sẵn có

Phần tiêu đề “Tất cả Các Công cụ Sẵn có”
Tên Công cụDanh mụcMô tả
getBlockStatisticsCác khốiNhận số liệu thống kê cho một khối TRON cụ thể dựa theo số khối.
getAccountInfoTài khoảnLấy thông tin tài khoản cho một địa chỉ TRON.
getAccountTransactionsTài khoảnLấy thông tin các giao dịch gần nhất của một địa chỉ tài khoản TRON.
getAccountTrc20TransactionsTài khoảnXem lịch sử chuyển token TRC-20 của một tài khoản TRON.
getInternalTransactionsTài khoảnLấy các giao dịch nội bộ của một địa chỉ tài khoản TRON.
getInternalTransactionsByTxIdTài khoảnXem các giao dịch nội bộ từ một ID giao dịch cụ thể.
getTrc20BalanceTài khoảnXem số dư của token TRC-20 trên một địa chỉ tài khoản TRON.
listAllAssetsTài sảnLiệt kê tất cả tài sản TRC-10 (token) trên blockchain TRON.
getAssetByNameTài sảnLấy các tài sản TRC-10 dựa theo tên.
getAssetByIdentifierTài sảnLấy một tài sản TRC-10 qua ID dạng số hoặc theo địa chỉ của nhà phát hành.
getContractTransactionsCác hợp đồngLấy danh sách giao dịch cho một địa chỉ Hợp đồng thông minh.
getContractInternalTransactionsCác hợp đồngNhận lại các giao dịch nội bộ của một Hợp đồng thông minh.
getTrc20TokenHoldersCác hợp đồngLấy số dư của những người nắm giữ token TRC-20 cho một địa chỉ hợp đồng.
getEventsByTransactionIdCác sự kiệnXem các sự kiện được phát đi bởi một giao dịch cụ thể.
getEventsByContractAddressCác sự kiệnNhận lại các sự kiện được phát đi bởi một địa chỉ Hợp đồng thông minh.
getEventsByBlockNumberCác sự kiệnNhận lại các sự kiện từ một số khối (block number) cụ thể.
getEventsByLatestBlockCác sự kiệnXem các sự kiện từ khối gần nhất.
getTrc20InfoCác token TRC-20Lấy thông tin về token (tên, ký hiệu, số thập phân) cho token TRC-20/721/1155.

Các Kỹ năng TRON

Phần tiêu đề “Các Kỹ năng TRON”

Các Kỹ năng (Skills) của TRON là những quy trình làm việc (workflows) đã được dựng sẵn được phân lớp trên bề mặt của các công cụ MCP. Thay vì bạn phải biết mình cần phải gọi công cụ nào và theo trình tự nào, bạn chỉ cần hỏi một câu bằng ngôn ngữ tự nhiên — Kỹ năng sẽ tự động điều phối hàng loạt công cụ khác nhau và trả lại cho bạn một bản báo cáo định dạng chuẩn, rõ ràng, dễ đọc.

Có Tám Kỹ năng được đóng gói cùng với máy chủ MCP TronGrid và chúng sẽ tự động kích hoạt ngay khi bạn kết nối thành công. Không cần bất cứ tùy chỉnh (cấu hình) nào khác.

Tám Kỹ năng

Phần tiêu đề “Tám Kỹ năng”
Kỹ năng (Skill)Bạn cần hỏi gìBạn sẽ nhận được
Lập Hồ sơ Tài khoản (Account Profiling)“Lập hồ sơ ví (Profile wallet) TN3W4H…”Bóc tách chi tiết các loại tài sản, dung lượng tài nguyên (resource levels), hoạt động gần đây, và thông tin ủy quyền.
Thông tin Khối (Block Info)“Có gì đã xảy ra tại khối số (What happened in block) 68000000?”Dữ liệu mô tả cấu trúc của khối (block metadata), lượng giao dịch (transaction count), thợ đào (miner), cũng như phần thưởng (rewards).
Phân tích Hợp đồng (Contract Analysis)“Hợp đồng này liệu có an toàn không? (Is this contract safe?) [address]“Phần tóm tắt ABI (ABI summary), các hàm được bộc lộ ra ngoài (function exposure), quyền quản lý, cũng như cờ rủi ro (risk flags).
Phân tích Dữ liệu (Data Insights)“Mạng lưới đang hoạt động thế nào? (How’s network activity trending?)”TPS (số giao dịch mỗi giây), địa chỉ đang hoạt động, quy mô khối lượng các lượt chuyển khoản, và các số liệu phản ánh tính lành mạnh của chuỗi.
Danh sách Token (Token List)“Các token TRC-20 top đầu ở hiện tại là gì? (What are the top TRC-20 tokens right now?)”Một bảng xếp hạng đi kèm cả giá, quy mô khối lượng giao dịch và mức vốn hóa thị trường.
Trình Quét Token (Token Scanner)“Quét chi tiết về đồng USDT bên trong TRON (Deep dive on USDT on TRON)“Quy mô tổng cung, số lượng người sở hữu (holder count), khối lượng chuyển khoản (transfer volume) và kiểm tra liệu một hợp đồng đó đã qua chứng thực (verification status).
Thông tin Giao dịch (Transaction Info)“Giải mã giao dịch này giúp tôi (Decode this transaction): [hash]“Lượng dữ liệu đầu vào (inputs) dưới dạng ngôn ngữ con người, danh sách (những) lời gọi nội bộ (internal calls), chi phí Năng lượng (Energy consumed) tiêu tốn, hay là lời lý giải do đâu mà cuộc gọi lại thoái thác (revert reason if any).
Thông tin TRX (TRX Info)“Giá của TRX ra sao và làm sao để khóa để ăn phần trăm? (What’s TRX priced at and what’s staking yield?)”Giá, vốn hóa thị trường (market cap), tỷ suất sinh lợi APY nhờ Khóa (staking APY), và những thông tin kinh tế học của Năng lượng.

Hãy thử Các lệnh Truy vấn Này

Phần tiêu đề “Hãy thử Các lệnh Truy vấn Này”

Bạn có thể sao chép (copy) và dán (paste) bất cứ mục nào bên dưới vào Claude Code sau bước thiết lập:

Các Ví dụ (Prompt Examples)
// Task: Dùng các truy vấn sử dụng văn phong ngôn ngữ tự nhiên sau để kích hoạt các Kỹ năng TRON.
Profile wallet (Lập hồ sơ tài khoản cho ví) TJDENsfBJs4RFETt1X1W8wMDc8M5XnJhCe và khái quát hóa cho tôi vị thế đang Khóa (staking) của nó.


Analyze contract (Phân tích Hợp đồng này giúp tôi) TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t — chức năng của nó là gì và liệu có điều gì tôi cần quan ngại không?


Show me the last 10 TRC-20 transfers (Cho tôi xem 10 lượt chuyển giao (transfers) token TRC-20 gần đây nhất của) cho địa chỉ này TN3W4H6rK2ce4vX9YnFQHwKENnHjoxb2Jq.


Decode transaction (Tiến hành giải mã đoạn băm giao dịch này) [dán hàm băm bất kì vào đây] và dùng ngôn ngữ đơn giản nhất giải thích xem chuyện gì vừa diễn ra.


Which TRC-20 tokens (Có token TRC-20 nào) đã và đang sở hữu khối lượng chuyển đổi nhiều nhất (most transfer volume) ở trong 24 giờ qua?


What is the current staking yield for TRX (Lãi suất staking ở thời điểm này cho một đồng TRX đang ở mức là bao nhiêu) và với 10,000 TRX sẽ tạo được ra thêm bao nhiêu khoản Năng lượng (Energy) hằng ngày?

MCP tools và Các Kỹ năng TRON (TRON Skills)

Phần tiêu đề “MCP tools và Các Kỹ năng TRON (TRON Skills)”

Cả hai sẽ cùng khả dụng (available) trong cùng một khoảng thời gian (simultaneously) — bạn sẽ chẳng bị bắt buộc chọn lựa giữa bất kì bên nào.

Những MCP tools Nguyên gốc (Raw)Các Kỹ năng TRON
Gọi lên bằng cách nàoViết Tên của một Công cụ + Đi cùng các số đo quy chuẩn chính xác của nóChỉ dùng những vấn đề thông qua văn ngôn ngữ tự nhiên
Kiến thức bắt buộc từ trước đóNắm rõ những cấu trúc (surface) của API, các cái tên số đo tiêu chuẩn (parameter names)Bỏ qua hoàn toàn
Các lệnh truy vấn bao hàm (những) sự thực thi diễn ra ở nhiều nấc (Multi-step)Điều hướng thủ công thông qua bàn tay ngườiHoạt động Tự động
Dữ liệu Báo cáo Nhận được (Output)Tệp JSON nguyên dạngBản báo cáo cấu trúc tốt (Formatted)
Phù hợp Nhất Để làmTự động hóa công việc, chuẩn bị tạo ra script (kịch bản), thực hiện tùy chỉnh hợp nhất (custom integrations)Tiến hành các hoạt động liên quan Khám phá, Nghiên cứu khoa học, hoặc Sửa/bắt lỗi (debugging)

Sử dụng (Những) Kỹ năng (Skills) khi bạn thực hiện hoạt động thám báo/đo lường thử (investigating), thao tác việc gỡ lỗi (debugging) mã lập trình, hoặc muốn được khám phá sâu thêm. Chỉ dùng (những) công cụ chuẩn (MCP tools nguyên gốc) khi bạn phải tiến hành khởi dựng hạ tầng hoạt động theo kiểu tự động hóa hoặc thực sự cần đến (những) lượng dữ liệu đầu ra được sắp xếp bằng cấu trúc JSON một cách (có) bài bản, rành rọt, chặt chẽ để nhằm cho (nhiều) quy trình tinh chỉnh xử lý dữ liệu (further processing) trong một thời điểm (kế tiếp) theo sau đó.

Các Giới hạn Tỷ lệ (Rate limits)

Phần tiêu đề “Các Giới hạn Tỷ lệ (Rate limits)”
Cấp bậc/Bậc (Tier)Số yêu cầu được nhận (Requests)Phương thức để có (How to get)
Miễn Phí (Free)Một loạt định dạng quy chuẩn của các khoản cho trước đối với TronGridChẳng hề đòi/được cần đến loại chìa khoá (key)
ProCường độ truy cập/tốc độ đọc ghi cao hơn hẳnLấy Key tại API ở trang chủ trongrid.io

Khi được khởi chạy, Hãy cung cấp đoạn key do (chính) bạn có (pass your key as the TRON-PRO-API-KEY header) tới thẳng trong bước tinh chỉnh mã cài đặt về chuẩn MCP tại hệ thống (theo như trong phần Hướng dẫn Thiết lập ngay bên trên (shown in Setup above)).

Nếu bạn có nhu cầu tiếp cận để truy xuất API dạng REST cũng như truy xuất nhanh với Node endpoint mà chưa cần tới (những) chuẩn MCP, vui lòng truy cập sang tham khảo bảng tại mục: Truy cập API & Node.