Danh mục công cụ MCP

Máy chủ Helius MCP cung cấp 10 công cụ công khai: 9 công cụ miền được định tuyến cùng expandResult. Mọi thao tác Helius và Solana đều có thể truy cập dưới dạng đối số action trên công cụ được định tuyến phù hợp, đồng thời công cụ/thao tác thích hợp được tự động chọn dựa trên yêu cầu bằng ngôn ngữ tự nhiên của bạn.

Cấu trúc lệnh gọi công cụ được định tuyến

Cả 9 công cụ được định tuyến đều có chung cấu trúc đối số:

Trường	Mô tả
`action`	Tên thao tác Helius cần chạy (ví dụ: `getBalance`, `createWebhook`)
tham số dành riêng cho miền	Ví dụ: `address`, `signatures`, `webhookURL`
`detail` (không bắt buộc)	`summary`, `standard` hoặc `full` — kiểm soát mức độ chi tiết của phản hồi
`_feedback`, `_feedbackTool`, `_model` (không bắt buộc)	Các trường đo từ xa

Ví dụ về lệnh gọi:

{
  "name": "heliusWallet",
  "arguments": {
    "action": "getBalance",
    "address": "Gh9ZwEmdLJ8DscKNTkTqPbNwLNNBjuSzaG9Vp2KGtKJr",
    "_feedback": "initial balance check",
    "_feedbackTool": "heliusWallet.getBalance",
    "_model": "your-model-id"
  }
}

`expandResult`

Các phản hồi lớn ưu tiên phần tóm tắt. Công cụ được định tuyến trả về một bản tóm tắt ngắn gọn cùng resultId khi phản hồi đầy đủ quá lớn hoặc khi detail: "summary" được yêu cầu. Gọi expandResult bằng resultId đó để truy xuất theo yêu cầu một phần, phạm vi, trang hoặc lát tiếp nối cụ thể của phản hồi gốc. Cách này giúp giảm mức sử dụng token cho các truy vấn khám phá, đồng thời vẫn cho phép tác nhân xem sâu vào toàn bộ tải trọng khi cần.

heliusAccount

Thiết lập tài khoản, xác thực, gói dịch vụ và thanh toán — bao gồm quy trình đăng ký tự động.

Thao tác	Mô tả
`getStarted`	Kiểm tra trạng thái thiết lập và nhận các bước tiếp theo được đề xuất
`setHeliusApiKey`	Cấu hình khóa API của bạn
`generateKeypair`	Tạo ví Solana để đăng ký
`signup`	Tạo tài khoản Helius thông qua liên kết thanh toán được lưu trữ. `mode: "link"` trả về URL thanh toán để người dùng mở trong trình duyệt; `mode: "autopay"` thanh toán USDC từ cặp khóa cục bộ; `mode: "resume"` thăm dò một ý định đã tạo trước đó. Mọi lượt đăng ký mới (tất cả các gói, bao gồm Agent) đều yêu cầu `email`, `firstName`, `lastName`.
`getAccountStatus`	Kiểm tra trạng thái tài khoản và tín dụng
`getAccountPlan`	Kiểm tra trước khi thực hiện: gói hiện tại, số dư tín dụng và những thao tác nào cần nâng cấp (0 tín dụng)
`getHeliusPlanInfo`	Xem thông tin chi tiết về gói hiện tại
`compareHeliusPlans`	So sánh các gói hiện có
`previewUpgrade`	Xem trước chi phí nâng cấp
`upgradePlan`	Nâng cấp gói của bạn. `mode: "link"` trả về URL thanh toán; `mode: "autopay"` thanh toán USDC từ cặp khóa cục bộ. Yêu cầu `email`, `firstName`, `lastName`.
`payRenewal`	Thanh toán gia hạn gói. `mode: "link"` trả về URL thanh toán; `mode: "autopay"` thanh toán USDC từ cặp khóa cục bộ.
`purchaseCredits`	Mua tín dụng trả trước (nạp thêm một lần). `mode: "link"` trả về URL thanh toán; `mode: "autopay"` thanh toán USDC từ cặp khóa cục bộ.

heliusWallet

Số dư ví, tài sản nắm giữ, lịch sử và tra cứu danh tính.

Thao tác	Mô tả
`getBalance`	Lấy số dư SOL của một địa chỉ
`getTokenBalances`	Lấy số dư token của một địa chỉ
`getWalletBalances`	Danh mục đầu tư đầy đủ với giá trị bằng USD
`getWalletBalanceAt`	Số dư chính xác của một token (hoặc SOL gốc) trong ví tại dấu thời gian, ngày giờ hoặc slot trước đây
`getWalletHistory`	Lịch sử giao dịch của ví kèm các thay đổi số dư
`getWalletTransfers`	Lịch sử gửi/nhận của ví
`getWalletFundedBy`	Truy vết nguồn tiền của ví
`getWalletIdentity`	Tra cứu chủ sở hữu ví theo địa chỉ hoặc miền SNS/ANS
`batchWalletIdentity`	Tra cứu danh tính hàng loạt cho tối đa 100 địa chỉ hoặc miền

heliusAsset

NFT, NFT nén, token có thể thay thế, bộ sưu tập, bằng chứng Merkle và chủ sở hữu token thông qua Digital Asset Standard (DAS).

Thao tác	Mô tả
`getAsset`	Lấy một tài sản theo địa chỉ mint (đơn lẻ hoặc hàng loạt)
`getAssetsByOwner`	Lấy tất cả tài sản thuộc sở hữu của một ví
`getAssetsByGroup`	Lấy tài sản theo bộ sưu tập
`searchAssets`	Tìm kiếm tài sản linh hoạt theo nhiều tiêu chí
`getSignaturesForAsset`	Lịch sử giao dịch của một tài sản (theo mint)
`getNftEditions`	Lấy các phiên bản in của NFT chính
`getAssetProof`	Lấy bằng chứng Merkle cho NFT nén, cần thiết để chuyển hoặc đốt NFT đó
`getAssetProofBatch`	Lấy bằng chứng Merkle cho tối đa 1.000 NFT nén trong một yêu cầu
`getTokenHolders`	Lấy danh sách những người nắm giữ nhiều token nhất

heliusTransaction

Phân tích giao dịch, lịch sử địa chỉ và chuyển khoản, cùng chức năng tìm kiếm lịch sử phía máy chủ.

Thao tác	Mô tả
`parseTransactions`	Phân tích giao dịch thành định dạng con người có thể đọc được. Trên mainnet, thao tác này sử dụng Parsed Events API và trả về tên chương trình, tên lệnh đã giải mã cùng lỗi chương trình đã giải mã; trên devnet, thao tác này sử dụng Enhanced Transactions
`getTransactionHistory`	Lịch sử địa chỉ ở chế độ `raw`, `parsed` hoặc `signatures`. `raw` trả về chữ ký/dữ liệu đầy đủ GTFA, `parsed` trả về lịch sử được phân tích bằng Parsed Events trên mainnet (Enhanced Transactions trên devnet), còn `signatures` trả về các bản ghi chữ ký gọn nhẹ. Không có thao tác MCP `getTransactionsForAddress` riêng biệt
`scanTransactionHistory`	Tìm kiếm phía máy chủ trong lịch sử của một địa chỉ để tìm các giao dịch gọi những chương trình hoặc lệnh cụ thể, hay tương tác với các mint token cụ thể, rồi chỉ trả về kết quả khớp: đã phân tích, dưới dạng chữ ký hoặc dưới dạng số lượng. Phân trang bằng `paginationToken`; một trang có thể không có kết quả khớp nhưng vẫn trả về token. Chỉ dành cho mainnet. 10 tín dụng cộng thêm 1 cho mỗi trang lịch sử được quét. Xem Quét lịch sử giao dịch
`getTransfersByAddress`	Các bản ghi chuyển SOL/token đã chuẩn hóa cho một địa chỉ — không phải đối tượng giao dịch hoàn chỉnh

heliusChain

Trạng thái chuỗi và kiểm tra tài khoản thô — đọc RPC, khối, trạng thái mạng, tài khoản token, tài khoản chương trình, ước tính phí ưu tiên, mô phỏng và trạng thái gói Jito.

Thao tác	Mô tả
`getAccountInfo`	Lấy dữ liệu tài khoản (đơn lẻ hoặc hàng loạt)
`getProgramAccounts`	Lấy các tài khoản thuộc sở hữu của một chương trình
`getTokenAccounts`	Lấy tài khoản token theo mint hoặc chủ sở hữu
`getBlock`	Lấy thông tin chi tiết về khối theo số slot
`getNetworkStatus`	Lấy trạng thái mạng Solana, epoch và độ cao khối
`getPriorityFeeEstimate`	Lấy phí ưu tiên tối ưu cho một giao dịch
`simulateTransaction`	Mô phỏng giao dịch mà không gửi giao dịch đó
`simulateBundle`	Mô phỏng theo thứ tự một gói Jito gồm tối đa 5 giao dịch mà không gửi gói đó: liệu gói có thành công hay không, giao dịch nào thất bại và lý do, cũng như đơn vị tính toán và nhật ký của từng giao dịch. 1 tín dụng
`getBundleStatuses`	Kiểm tra xem các gói đã gửi có được đưa vào chuỗi hay không: trạng thái, slot, lỗi và chữ ký cho tối đa 5 ID gói. 1 tín dụng. Xem getBundleStatuses
`getStakeAccounts`	Lấy các tài khoản stake trình xác thực Helius của một ví
`getWithdrawableAmount`	Lấy số tiền có thể rút của một tài khoản stake

heliusStreaming

Quản lý webhook, tạo cấu hình Enhanced WebSocket và LaserStream, cùng các luồng Gatekeeper (Parsed Streams, Preconfirmations, Preprocessed Transactions).

Thao tác	Mô tả
`getAllWebhooks`	Liệt kê tất cả webhook, dù được bật hay tắt, kèm trạng thái mỗi webhook có đang nhận lượt chuyển phát hay không
`getWebhookByID`	Lấy một webhook cụ thể, bao gồm trạng thái webhook đó có được bật hay không
`createWebhook`	Tạo webhook mới
`updateWebhook`	Cập nhật webhook hiện có
`deleteWebhook`	Xóa webhook
`toggleWebhook`	Bật hoặc tắt webhook mà không xóa webhook đó, chẳng hạn để bật lại webhook đã bị Helius tự động tắt sau nhiều lần điểm cuối gặp lỗi. Webhook được bật lại sẽ không thể bị tự động tắt lần nữa trong 24 giờ. 100 tín dụng. Xem Bật/tắt webhook
`transactionSubscribe`	Tạo URL Enhanced WebSocket, yêu cầu đăng ký giao dịch, cảnh báo cấu hình và ví dụ TypeScript. Thao tác này không mở hoặc duy trì kết nối WebSocket.
`accountSubscribe`	Tạo URL Enhanced WebSocket, yêu cầu đăng ký tài khoản, cảnh báo cấu hình và ví dụ TypeScript. Thao tác này không mở hoặc duy trì kết nối WebSocket.
`laserstreamSubscribe`	Tạo điểm cuối LaserStream gRPC, cấu hình đăng ký, cảnh báo cấu hình và ví dụ TypeScript. Thao tác này không mở hoặc duy trì luồng trực tiếp; chuyển đổi dự phòng đa nút là một khả năng của sản phẩm LaserStream gRPC.
`parsedTransactionSubscribe`	Tạo đăng ký Parsed Streams cho Gatekeeper WebSocket: các giao dịch được giải mã thành lệnh, sự kiện và tài khoản có tên, đồng thời được lọc phía máy chủ theo chương trình, tên lệnh và vai trò tài khoản. Trả về yêu cầu đã xác thực và mã helius-sdk; không mở kết nối. Tất cả các gói. 1 tín dụng cho mỗi sự kiện được chuyển phát
`describeProgram`	Liệt kê chính xác tên lệnh, sự kiện và vai trò tài khoản đã giải mã của một chương trình theo cách Parsed Streams và Parsed Events đối sánh chúng, để tạo các bộ lọc có thể khớp. Dùng thao tác này trước `parsedTransactionSubscribe` hoặc `scanTransactionHistory`
`preconfSubscribe`	Tạo đăng ký Preconfirmations cho Gatekeeper WebSocket: tín hiệu sớm nhất của một giao dịch, trước khi phân mảnh. Lọc theo nguồn, trạng thái, khu vực, tài khoản, người ký, chữ ký và dữ liệu lệnh. Trả về yêu cầu đã xác thực và mã helius-sdk; không mở kết nối. Các gói trả phí
`getPreConfCoverage`	Tỷ lệ stake mainnet mà Preconfirmations bao phủ và cách tỷ lệ đó được phân bổ giữa các khu vực, giúp quyết định mức bao phủ có đủ hay không và chọn khu vực
`preprocessedSubscribe`	Tạo đăng ký Preprocessed Transactions cho Gatekeeper WebSocket: các giao dịch đã ký trước khi thực thi, được lọc theo tài khoản. Trả về yêu cầu đã xác thực và mã để giải mã thông báo nhị phân rồi kết nối lại; không mở kết nối. Bản beta công khai, các gói trả phí. 0,1 tín dụng cho mỗi thông báo

heliusKnowledge

Tài liệu, hướng dẫn, bảng giá, khắc phục sự cố, mã nguồn, bài viết blog, SIMD và thông tin chi tiết về kết nối truyền trực tuyến.

Thao tác	Mô tả
`lookupHeliusDocs`	Tìm kiếm tài liệu Helius
`listHeliusDocTopics`	Liệt kê các chủ đề tài liệu hiện có
`getHeliusCreditsInfo`	Lấy thông tin về chi phí tín dụng
`getRateLimitInfo`	Lấy thông tin chi tiết về giới hạn tốc độ
`troubleshootError`	Chẩn đoán mã lỗi
`getSenderInfo`	Lấy tài liệu Sender / Jito / SWQoS
`getWebhookGuide`	Lấy hướng dẫn thiết lập webhook
`getLatencyComparison`	So sánh độ trễ truyền trực tuyến giữa các sản phẩm
`getPumpFunGuide`	Lấy hướng dẫn tích hợp pump.fun
`recommendStack`	Lấy ngăn xếp Helius được đề xuất cho trường hợp sử dụng của bạn
`getSIMD`	Đọc một đề xuất SIMD cụ thể
`listSIMDs`	Liệt kê tất cả đề xuất SIMD
`readSolanaSourceFile`	Đọc mã nguồn Solana (Agave, Firedancer)
`searchSolanaDocs`	Tìm kiếm tài liệu Solana
`fetchHeliusBlog`	Truy xuất bài viết blog của Helius
`getEnhancedWebSocketInfo`	Lấy thông tin chi tiết về kết nối Enhanced WebSocket
`getLaserstreamInfo`	Lấy thông tin chi tiết về kết nối LaserStream

heliusWrite

Chuyển tài sản và stake — các thao tác gửi giao dịch thay mặt bạn.

Thao tác	Mô tả
`transferSol`	Gửi SOL đến ví khác (hỗ trợ `sendMax` để rút toàn bộ số dư)
`transferToken`	Gửi token SPL như USDC, BONK, v.v. (hỗ trợ `sendMax` kèm đóng ATA)
`stakeSOL`	Stake SOL cho trình xác thực Helius: tạo và ủy quyền một tài khoản stake mới
`unstakeSOL`	Hủy kích hoạt tài khoản stake để bắt đầu giai đoạn chờ trước khi rút
`withdrawStake`	Rút SOL từ tài khoản stake đã hủy kích hoạt về ví của bạn

heliusCompression

Trạng thái ZK Compression thông qua trình lập chỉ mục Light Protocol: tài khoản nén, số dư, tài khoản token, bằng chứng, chữ ký và trạng thái trình lập chỉ mục. Mỗi lệnh gọi tốn 10 tín dụng. Đối với bằng chứng Merkle của NFT nén, hãy dùng getAssetProof trên heliusAsset.

Thao tác	Mô tả
`getCompressedAccount`	Lấy một tài khoản nén theo địa chỉ hoặc hàm băm
`getCompressedAccountsByOwner`	Liệt kê các tài khoản nén thuộc sở hữu của một ví
`getMultipleCompressedAccounts`	Truy xuất hàng loạt tài khoản nén theo địa chỉ hoặc hàm băm
`getCompressedBalance`	Lấy số dư SOL nén của một tài khoản
`getCompressedBalanceByOwner`	Lấy tổng số dư SOL nén trên các tài khoản của một ví
`getCompressedMintTokenHolders`	Liệt kê chủ sở hữu của một mint token nén
`getCompressedTokenAccountBalance`	Lấy số dư token của một tài khoản token nén
`getCompressedTokenAccountsByOwner`	Liệt kê các tài khoản token nén thuộc sở hữu của một ví, có thể lọc theo mint
`getCompressedTokenAccountsByDelegate`	Liệt kê các tài khoản token nén được ủy quyền cho một địa chỉ
`getCompressedTokenBalancesByOwnerV2`	Tóm tắt số dư token nén của một ví theo từng mint
`getCompressedAccountProof`	Lấy bằng chứng Merkle cho một tài khoản nén
`getMultipleCompressedAccountProofs`	Lấy hàng loạt bằng chứng Merkle cho các tài khoản nén
`getMultipleNewAddressProofs`	Bằng chứng không bao hàm cho các địa chỉ mới, cần thiết để tạo tài khoản nén
`getValidityProof`	Tạo bằng chứng hợp lệ ZK cho các thao tác sửa đổi trạng thái nén
`getCompressionSignaturesForAccount`	Chữ ký giao dịch nén cho một tài khoản nén
`getCompressionSignaturesForAddress`	Chữ ký giao dịch nén cho một địa chỉ
`getCompressionSignaturesForOwner`	Chữ ký giao dịch nén cho chủ sở hữu ví
`getCompressionSignaturesForTokenOwner`	Chữ ký thao tác token nén cho chủ sở hữu ví
`getLatestCompressionSignatures`	Các giao dịch nén gần đây nhất trên toàn mạng
`getLatestNonVotingSignatures`	Các giao dịch nén không biểu quyết gần đây nhất
`getTransactionWithCompressionInfo`	Các tài khoản nén được mở và đóng trong một giao dịch
`getIndexerHealth`	Kiểm tra xem trình lập chỉ mục ZK Compression có hoạt động bình thường không
`getIndexerSlot`	Slot mới nhất mà trình lập chỉ mục đã xử lý, dùng để theo dõi độ trễ

​Cấu trúc lệnh gọi công cụ được định tuyến

​expandResult

​heliusAccount

​heliusWallet

​heliusAsset

​heliusTransaction

​heliusChain

​heliusStreaming

​heliusKnowledge

​heliusWrite

​heliusCompression