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.
operation parameter, so the 32 tools cover more than 100 operations. Every tool name, operation and parameter on this page is taken from the server’s tool schema; health_check reports the live tool count.
Tool Summary
Total: 32 tools. Tools marked FREE do not submit a transaction and cost no HBAR. See Cost awareness for the full breakdown.
Health (1 tool)
health_check
Check server health and status. FREE.- verbose (boolean): Also probe external services
status, version, toolCount, network, operatorConfigured and operatorId. With verbose: true it adds:
services.mirrorNode: URL and reachabilityservices.jsonRpcRelay: URL in use (yourJSON_RPC_RELAY_URLor the Hashio default)services.chromadb: URL, reachability of the docs index, andragEnabled(true whenOPENAI_API_KEYis set)system: Node.js version, platform and architecture
Account Management (4 tools)
account_create
Create a new Hedera account with an auto-generated ECDSA key pair, funded from the operator account.- initialBalance (number): Initial HBAR (default: 1)
- memo (string): Account memo (max 100 chars)
- publicKey (string): Use an existing public key instead of generating one
account_balance
Query HBAR and token balances for any account. FREE via Mirror Node, no operator needed.- accountId (string, required): Account ID (
0.0.xxxxx)
account_info
Get account details: balance, EVM address, public key and key type, memo, auto-renew period, expiration and staking info. FREE via Mirror Node, no operator needed.- accountId (string, required): Account ID
transfer_hbar
Transfer HBAR between accounts. Signed by the operator, so the operator must be the source or have signing authority over it.- from (string, required): Source account ID
- to (string, required): Destination account ID
- amount (number, required): HBAR amount
Network Management (2 tools)
network_info
Return the active network, its Mirror Node URL and its JSON-RPC relay endpoint. FREE. No parameters.network_switch
Switch the active network. The choice is saved in the data directory and survives restarts.- network (string, required):
mainnet,testnet,previewnetorlocal
JSON_RPC_RELAY_URL and MIRROR_NODE_URL only apply to the network named in HEDERA_NETWORK.
After switching to another network HashPilot uses the public Hedera endpoints for it.Token Operations - HTS (1 tool, 12 operations)
token_manage
Unified fungible token management. Amounts and supplies are in the token’s smallest unit (withdecimals: 2, an amount of 100 is 1.00).
The key flags (
adminKey, supplyKey, freezeKey, kycKey, wipeKey, pauseKey) are booleans. When enabled, the operator key is set as that key, and the operator account is the treasury.
Custom fees (customFees, array, create only): each entry has feeType (fixed, fractional or royalty) and feeCollectorAccountId, plus amount (fixed amount, or the numerator for fractional fees), denominator, min, max, denominatingTokenId (fixed fees paid in another token) and fallbackFee (royalty fees).
Consensus Service - HCS (2 tools, 6 operations)
hcs_topic
Topic management.hcs_message
Message operations.topicId is required for both operations.
Address Book (1 tool, 5 operations)
addressbook_manage
Aliases for accounts you work with often. Imported private keys are stored unencrypted in the data directory.State Management (1 tool, 3 operations)
state_manage
Backup, restore and export of the address book and network state. Files live under the data directory (~/.hedera-mcp or HASHPILOT_DATA_DIR).
JSON-RPC Operations (4 tools)
These tools talk to the JSON-RPC relay for the active network (Hashio by default, or yourJSON_RPC_RELAY_URL). Chain IDs are 295 (mainnet), 296 (testnet), 297 (previewnet) and 298 (local).
rpc_call
Execute any method the relay supports (eth_*, web3_*, net_*, debug_*). Read methods are FREE.
- method (string, required): e.g.
eth_blockNumber,eth_getBalance,eth_call,eth_getLogs,eth_sendRawTransaction - params (array): Method parameters
- network (string):
mainnet,testnet,previewnetorlocal(default: active network)
rpc_call_contract
Call a view or pure function viaeth_call. FREE, no gas.
- contractAddress (string, required):
0xaddress - abi (array, required): Contract ABI
- functionName (string, required): Function to call
- args (array): Function arguments
rpc_deploy_contract
Deploy bytecode via the relay. Handles constructor encoding, gas estimation and receipt polling.- bytecode (string, required): Contract bytecode (
0x...) - abi (array): Contract ABI (needed to encode constructor arguments)
- constructorArgs (array): Constructor arguments
- privateKey (string): Deployer key (optional, defaults to the operator key)
rpc_execute_contract
Send a state-changing transaction viaeth_sendRawTransaction.
- contractAddress (string, required): Contract address
- abi (array, required): Contract ABI
- functionName (string, required): Function name
- args (array): Function arguments
- value (string): Value to send, in wei
- privateKey (string): Sender key (optional, defaults to the operator key)
EVM operations sign with an ECDSA key. If your operator account uses an ED25519 key, pass an ECDSA
privateKey for these tools, or use the native SDK tools instead.Documentation and Code Generation (4 tools)
WithOPENAI_API_KEY set, all four query the ChromaDB index at CHROMA_URL (HashPilot’s hosted index by default), which covers docs.hedera.com, HIPs, HCS standards, protobuf definitions, SDK examples in five languages and the Solo, CLI, Mirror Node, Agent Kit and smart-contract repositories. They cost OpenAI tokens, never HBAR.
Without a key, or when the index cannot be reached, they answer from Hedera’s official documentation search at docs.hedera.com/mcp instead: free and keyless, but limited to docs.hedera.com and hips.hedera.com. docs_ask then returns the relevant documentation rather than a written answer, and code_generate returns the documentation to write the code from. Every fallback response says so and why.
docs_search
Semantic search across the indexed Hedera documentation, SDK references, tutorials and HIPs.- query (string, required): Natural-language search query
- limit (number): Max results (default 5, max 20)
- contentType (string):
tutorial,api,concept,example,guideorreference - language (string):
javascript,typescript,java,python,goorsolidity - hasCode (boolean): Only return chunks that contain code
docs_ask
Answer a question with retrieval-augmented generation and source citations.- question (string, required): Your question
- expertiseLevel (string):
beginner,intermediateoradvanced - includeCodeExamples (boolean): Include code in the answer
- language (string): Preferred language for examples (same list as
docs_search)
docs_get_example
Find working code examples with explanations and source references.- description (string, required): What the code should do
- language (string):
javascript,typescript,java,python,go,rustorsolidity - complexity (string):
simple,intermediateoradvanced - limit (number): Max examples (default 5)
code_generate
Generate runnable SDK code from a description, grounded in indexed examples.- description (string, required): What to generate
- language (string):
javascript(default),typescript,java,python,goorsolidity - style (string):
minimal,complete(default) orproduction - includeImports (boolean): Include imports (default true)
- includeErrorHandling (boolean): Include try/catch (default true)
Smart Contract Deployment (4 tools)
deploy_contract
Unified deployment. Detects a Hardhat or Foundry project in the current directory, or falls back to direct RPC deployment, and records the result in the deployment history.- contractName (string, required): Contract name
- network (string, required):
mainnet,testnetorpreviewnet - constructorArgs (array): Constructor arguments
- framework (string):
hardhat,foundryordirect(auto-detected if omitted) - verify (boolean): Attempt verification after deployment
verify_contract
Submit source code for verification. HashScan reads verification status from Sourcify, which supports Hedera mainnet (chain 295) and testnet (chain 296) only.- address (string, required): Contract address (
0x...) - network (string, required):
mainnetortestnet(previewnetis accepted by the schema but cannot be verified) - contractName (string, required): Contract name
- filePath (string, required): Path to the
.solfile or a directory of.solfiles
deployment_history
List past deployments. FREE.- network (string):
mainnet,testnetorpreviewnet - contractName (string): Filter by name
- limit (number): Max results (default 20)
- exportFormat (string):
json,csvormarkdown
deployments.json in the data directory.
mirror_query_account
Query an account from the Mirror Node REST API, optionally with recent transactions. FREE.- accountId (string, required): Account ID
- includeTransactions (boolean): Include recent transactions
- transactionLimit (number): Transaction count (default 20)
mirror_query
Every other read-only Mirror Node query, selected by resource. FREE, no operator needed. Each resource takes the parameters shown; the tool reports any required one that is missing.graphql
Query indexed Hedera Mirror Node data with GraphQL, through Hgraph. Hedera’s public Mirror Nodes offer only REST; Hgraph serves the same data over GraphQL for mainnet and testnet. NeedsHGRAPH_API_KEY (a free key is available at app.hgraph.com); set GRAPHQL_ENDPOINT to use a different endpoint. Read-only: mutations and subscriptions are refused.
Filters use Hasura syntax, for example
where: {"type": {"_eq": "NON_FUNGIBLE_UNIQUE"}} and orderBy: {"consensus_timestamp": "desc"}. The schema is cached per network in the data directory for a day. Large results are trimmed to fit a response, with a note saying how many rows were left out. The free Hgraph plan allows one request per second.
Hardhat Integration (2 tools, 15 operations)
Both tools take directory (string): the absolute path of the Hardhat project. It is required for every operation exceptinit, which creates the directory.
hardhat_project
hardhat_contract
Deployment uses the operator key automatically; you do not need to setTESTNET_PRIVATE_KEY yourself.
Foundry Integration (2 tools, 17 operations)
Requiresforge, cast and anvil on your PATH (HashPilot also looks in ~/.foundry/bin). Both tools take directory (string), required for every operation except init.
foundry_project
foundry_contract
rpcUrl and privateKey are optional everywhere: they default to the active network’s relay and the operator key.
Stablecoin Studio (1 tool, 18 operations)
stablecoin_manage
Compliant stablecoins through the Hedera Stablecoin Studio SDK. Built-in factory and resolver contracts exist for testnet only; mainnet and previewnet needSTABLECOIN_FACTORY_ADDRESS and STABLECOIN_RESOLVER_ADDRESS (and optionally STABLECOIN_CONFIG_ID / STABLECOIN_CONFIG_VERSION) in the environment.
Parameters:
stablecoinId (most operations), targetAccount, amount (string, for exact decimals), role (CASHIN, BURN, WIPE, RESCUE, PAUSE, FREEZE, KYC, DELETE), network.
Create parameters: name, symbol, decimals (default 6), initialSupply, maxSupply, supplyType (INFINITE or FINITE), memo, freezeDefault, role accounts (cashInRoleAccount, burnRoleAccount, wipeRoleAccount, rescueRoleAccount, pauseRoleAccount, freezeRoleAccount, kycRoleAccount, deleteRoleAccount; each defaults to the operator), cashInAllowance, createReserve, reserveInitialAmount, reserveAddress, proxyAdminOwnerAccount.
Error Analysis (1 tool)
error_explain
Look up Hedera error codes with cause, solution and related errors. FREE, works offline, no OpenAI key needed. Call it with any one of:- errorCode (string): e.g.
INSUFFICIENT_PAYER_BALANCE - errorMessage (string): A full error message; the code is extracted automatically
- category (string): List all errors in
account,token,contract,consensus,network,transaction,keyorfile - search (string): Search by keyword
Environment Variables
Auto-Key Resolution
Transaction tools sign with the operator key unless told otherwise:- An explicit
privateKeyparameter (RPC, Hardhatexecute, Foundrycreate/script/send) - The operator account from your MCP configuration
<NETWORK>_PRIVATE_KEY variable the generated config expects. Foundry tools fill in rpcUrl from the active network as well.
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. The Tutorials show complete workflows.