Skip to main content
You don’t need to memorize these tools! Simply describe what you want to do in natural language, and your AI assistant will automatically select and use the right tools. This reference is here to show you the full power of HashPilot’s integration capabilities.
HashPilot provides 31 MCP tools that expose 100+ operations for Hedera development. Tools use a composite pattern where related operations are grouped together.

Tool Summary

CategoryToolsOperationsDescription
Core44Account create, balance, info, transfer
Network22Network info and switching
Tokens (HTS)112Full token lifecycle management
Consensus (HCS)25Topic and message operations
Address Book15Account organization
JSON-RPC44EVM compatibility (55+ RPC methods)
RAG/Docs33Documentation search and code generation
Deployment44Contract deploy, verify, history
Hardhat215Project and contract operations
Foundry217Forge, cast, and anvil operations
Stablecoin118Enterprise stablecoin management
Utilities511+Health check, state, errors
Total: 31 tools, 100+ operations

Account Management (4 tools)

health_check

Check server health and status.
  • verbose (boolean): Include detailed status

account_create

Create new Hedera account with ECDSA key pair.
  • initialBalance (number): Initial HBAR (default: 1)
  • publicKey (string): Existing key to use
  • memo (string): Account memo

account_balance

Query HBAR and token balances. FREE via Mirror Node.
  • accountId (string, required): Account ID

account_info

Get comprehensive account information.
  • accountId (string, required): Account ID

transfer_hbar

Transfer HBAR between accounts.
  • from (string): Source (defaults to operator)
  • to (string, required): Destination
  • amount (number, required): HBAR amount

Network Management (2 tools)

network_info

Get current network configuration. No parameters.

network_switch

Switch between networks.
  • network (string, required): mainnet, testnet, previewnet, local

Token Operations - HTS (1 tool, 12 operations)

token_manage

Unified token management covering the complete HTS lifecycle. Operations:
OperationDescriptionKey Parameters
createCreate fungible/NFT tokenname, symbol, decimals, initialSupply, treasuryAccountId, supplyKey, adminKey, freezeKey, kycKey, pauseKey, wipeKey, customFees
associateAssociate token with accounttokenId, accountId
dissociateDissociate token from accounttokenId, accountId
transferTransfer tokenstokenId, from, to, amount
mintMint additional tokenstokenId, amount, metadata (for NFTs)
burnBurn tokens from treasurytokenId, amount, serialNumbers (for NFTs)
freezeFreeze account for tokentokenId, accountId
unfreezeUnfreeze accounttokenId, accountId
kyc_grantGrant KYC to accounttokenId, accountId
kyc_revokeRevoke KYC from accounttokenId, accountId
pausePause all token operationstokenId
unpauseResume token operationstokenId
wipeWipe tokens from accounttokenId, accountId, amount

Consensus Service - HCS (2 tools, 5 operations)

hcs_topic

Topic management for Hedera Consensus Service.
OperationDescriptionKey Parameters
createCreate new topicmemo, adminKey, submitKey, autoRenewPeriod
updateUpdate topic propertiestopicId, memo, adminKey, submitKey
deleteDelete topictopicId

hcs_message

Message operations for HCS topics.
OperationDescriptionKey Parameters
submitSubmit message (auto-chunks >1KB)topicId, message, submitKey
queryQuery message history (FREE)topicId, limit, order, sequenceNumber

Address Book (1 tool, 5 operations)

addressbook_manage

Account reference and organization.
OperationDescriptionKey Parameters
addAdd account reference (no key)accountId, alias, nickname
importImport account WITH private keyaccountId, alias, privateKey
listList all saved accounts-
updateUpdate account nicknamealias, nickname
removeRemove from address bookalias

JSON-RPC Operations (4 tools)

rpc_call

Execute ANY of 55+ JSON-RPC methods on Hedera’s relay.
  • method (string, required): eth_blockNumber, eth_getBalance, eth_call, eth_getLogs, etc.
  • params (array): Method parameters
  • network (string): Target network
Supported methods include: eth_blockNumber, eth_getBalance, eth_getTransactionCount, eth_getCode, eth_call, eth_estimateGas, eth_sendRawTransaction, eth_getTransactionByHash, eth_getTransactionReceipt, eth_getLogs, eth_getBlockByNumber, eth_getBlockByHash, eth_chainId, eth_gasPrice, eth_feeHistory, web3_clientVersion, net_version, and 40+ more.

rpc_call_contract

Call read-only contract function. FREE - no gas cost.
  • contractAddress (string, required): 0x address
  • abi (array, required): Contract ABI
  • functionName (string, required): Function to call
  • args (array): Function arguments

rpc_deploy_contract

Deploy contract via JSON-RPC.
  • bytecode (string, required): Contract bytecode
  • abi (array, required): Contract ABI
  • constructorArgs (array): Constructor arguments
  • gasLimit (number): Gas limit
  • privateKey (string): Deployer key (auto-uses operator)

rpc_execute_contract

Execute state-changing contract function.
  • contractAddress (string, required): Contract address
  • abi (array, required): Contract ABI
  • functionName (string, required): Function name
  • args (array): Function arguments
  • value (string): HBAR to send
  • privateKey (string): Caller key (auto-uses operator)

RAG & Code Generation (3 tools)

Semantic search across 10,000+ indexed Hedera documents.
  • query (string, required): Search query
  • limit (number): Results (1-20, default: 5)
  • contentType (string): tutorial, api, concept, example, guide, reference
  • language (string): Filter by language
  • hasCode (boolean): Filter for code examples

docs_ask

Answer questions with RAG and citations.
  • question (string, required): Your question
  • expertiseLevel (string): beginner, intermediate, advanced
  • includeCodeExamples (boolean): Include code
  • language (string): Preferred code language

code_generate

Generate SDK code from natural language.
  • description (string, required): What to generate
  • language (string): js, ts, java, python, go, rust, solidity
  • style (string): minimal, complete, production
  • includeImports (boolean): Include imports
  • includeErrorHandling (boolean): Include try/catch

Smart Contract Deployment (4 tools)

deploy_contract

Unified contract deployment.
  • contractName (string, required): Contract name
  • network (string, required): mainnet, testnet, previewnet
  • constructorArgs (array): Constructor arguments
  • framework (string): hardhat, foundry, direct
  • verify (boolean): Auto-verify after deploy
  • gasLimit (number): Gas limit
  • privateKey (string): Deployer key (auto-uses operator)

verify_contract

Verify contract on HashScan.
  • address (string, required): Contract address
  • network (string, required): Network
  • contractName (string, required): Contract name
  • filePath (string): Source file path
  • creatorTxHash (string): Creation transaction hash

deployment_history

View deployment history.
  • network (string): Filter by network
  • contractName (string): Filter by contract
  • limit (number): Max results
  • exportFormat (string): json, csv, markdown

mirror_query_account

Query account from Mirror Node. FREE.
  • accountId (string, required): Account ID
  • includeTransactions (boolean): Include transactions
  • transactionLimit (number): Transaction limit

Hardhat Integration (2 tools, 15 operations)

hardhat_project

Project-level Hardhat operations.
OperationDescription
initInitialize new Hardhat project with Hedera config
compileCompile Solidity contracts
testRun Mocha/Chai tests with filtering
cleanClean artifacts and cache
flattenFlatten contracts for verification
get_artifactsGet compiled ABI and bytecode
get_accountsList accounts with balances
config_networkGenerate network config snippet
run_taskExecute custom Hardhat task
list_tasksList all available tasks

hardhat_contract

Contract-level Hardhat operations.
OperationDescription
deployDeploy via deployment script
deploy_ignitionDeploy using Hardhat Ignition
verifyGet verification metadata
callCall read-only function (FREE)
executeExecute state-changing transaction

Foundry Integration (2 tools, 17 operations)

foundry_project

Project-level Foundry operations.
OperationDescription
initInitialize new Foundry project
installInstall git dependency (e.g., forge-std)
updateUpdate all dependencies
removeRemove a dependency
cleanClean build artifacts
buildCompile with optimization options
fmtFormat Solidity code
inspectInspect contract (ABI, bytecode, storage)
get_artifactsGet compiled artifacts
snapshotCreate gas usage snapshot

foundry_contract

Contract-level Foundry operations.
OperationDescription
testRun tests with fuzzing and gas reports
createDeploy via forge create
scriptExecute Solidity deployment script
callCall read-only function via cast (FREE)
sendSend transaction via cast
anvil_startStart local Anvil node (can fork)
anvil_stopStop Anvil node

Stablecoin Studio (1 tool, 18 operations)

stablecoin_manage

Enterprise-grade stablecoin management via Hedera Stablecoin Studio.
OperationDescription
createCreate compliant stablecoin with role-based controls
infoGet stablecoin details
balanceCheck account balance
cashinMint tokens (requires CASHIN role)
burnBurn tokens (requires BURN role)
wipeRemove tokens from account (requires WIPE role)
rescueRescue tokens from proxy treasury
rescue_hbarRescue HBAR from proxy
freezeFreeze account
unfreezeUnfreeze account
pausePause all operations globally
unpauseResume operations
kyc_grantGrant KYC status
kyc_revokeRevoke KYC status
role_grantGrant role to account
role_revokeRevoke role from account
role_checkCheck account’s roles
deletePermanently delete stablecoin
Available roles: CASHIN, BURN, WIPE, RESCUE, PAUSE, FREEZE, KYC, DELETE

Utility Tools (4 tools)

error_explain

Explain Hedera error codes with debugging guidance.
  • errorCode (string): Error code (e.g., INSUFFICIENT_PAYER_BALANCE)
  • errorMessage (string): Full error message
  • category (string): account, token, contract, consensus, network, transaction, key, file
  • search (string): Search by keyword

state_manage

Server state persistence and backup.
OperationDescription
backupCreate timestamped backup
restoreRestore from backup (merge or replace)
exportExport state to JSON

Auto-Key Resolution

All deployment and transaction tools automatically use your configured operator account. You don’t need to specify private keys unless you want to use a different account. Resolution order:
  1. Explicitly provided privateKey parameter
  2. Address book entry (if fromAlias specified)
  3. MCP operator account (default from config)

Remember: You don’t need to call these tools directly. Just tell your AI assistant what you want to do, like “Create a token called MyToken” or “Deploy my contract to testnet”, and HashPilot handles the rest.