Skip to main content
HashPilot provides 32 MCP tools with 130+ operations covering the complete Hedera development workflow. Here’s an overview of what you can do.

Account Management

Manage Hedera accounts with natural language:
  • Create accounts with an ECDSA key pair and a configurable initial HBAR balance
  • Query balances for HBAR and all associated tokens (free Mirror Node query, no operator needed)
  • Get account info including EVM address, key type, memo, expiration and staking (free)
  • Transfer HBAR between accounts
  • Inspect transaction history through the Mirror Node (free)

Token Operations (HTS)

Fungible token lifecycle through the Hedera Token Service:

Consensus Service (HCS)

Hedera Consensus Service for ordered messaging:
  • Create topics, public or private (submit key), with optional admin key
  • Submit messages with automatic chunking for payloads over 1 KB
  • Query messages by sequence number from the Mirror Node (free)
  • Read topic info from the Mirror Node (free)
  • Subscribe to real-time message streams

Smart Contracts

Deploy and interact with Solidity contracts:

Hardhat Integration

  • Scaffold a project with a Hedera-ready config and a sample contract
  • Compile contracts
  • Run tests with Mocha/Chai
  • Deploy with a script or Hardhat Ignition, signed with your operator key
  • Call (free) and execute contract functions

Foundry Integration

  • Scaffold a project (runs git init and installs forge-std)
  • Build with forge, run fuzz tests with gas reports
  • Deploy with forge create or a broadcast script
  • Call (free) and send transactions with cast
  • Start and stop a local Anvil node, optionally forking a network

Verification

  • Verify on Sourcify, which HashScan uses to display source code (mainnet and testnet)
  • Keep a deployment history and export it as JSON, CSV or Markdown

JSON-RPC Operations

  • Any method the JSON-RPC relay supports (eth_*, web3_*, net_*, debug_*)
  • eth_call for read operations (free)
  • Deploy and execute contracts with the operator key
  • Use a production relay via JSON_RPC_RELAY_URL

Stablecoin Studio

Enterprise-grade stablecoin management:
  • Create compliant stablecoins with role-based controls
  • Cash-in/Burn with allowance management
  • Freeze/Unfreeze individual accounts
  • KYC management for compliance
  • Pause/Unpause for emergency controls
  • Role management (CASHIN, BURN, WIPE, RESCUE, PAUSE, FREEZE, KYC, DELETE)
  • Proof-of-Reserve support
Built-in Stablecoin Studio contracts exist for testnet. Mainnet and previewnet need STABLECOIN_FACTORY_ADDRESS and STABLECOIN_RESOLVER_ADDRESS in your configuration.

Documentation and Code Generation

AI-powered knowledge base over a pre-indexed ChromaDB collection of Hedera documentation: Semantic search with filters for content type, language and code presence:

docs_ask

Ask questions and get cited answers at your expertise level:

docs_get_example

Find working, annotated code examples:

code_generate

Generate SDK code from descriptions:
Indexed Sources:
  • Official Hedera Documentation
  • SDK References (JavaScript, Java, Go, Rust, Python)
  • Hedera Improvement Proposals (HIPs)
  • Tutorials and Examples
  • Smart Contract Patterns
  • Network fees, exchange rates and staking data
These four tools require an OpenAI API key in your MCP settings. They query HashPilot’s hosted index by default; see Self-hosting to run your own.

Development Tools

Address Book

Save and manage multiple accounts:
  • Add account references
  • Import accounts with private keys for signing
  • Organize with aliases and nicknames

State Management

  • Backup server state (private keys excluded by default)
  • Restore from backups, replacing or merging
  • Export state as JSON
All persisted data lives in ~/.hedera-mcp or the directory named by HASHPILOT_DATA_DIR.

Error Explanation

Get help understanding Hedera errors, offline and free:

Health Check

health_check reports version, tool count, network and operator. With verbose it also probes the Mirror Node and the docs index and shows the JSON-RPC relay in use.

Network Switching

Switch between networks seamlessly:
  • mainnet
  • testnet
  • previewnet
  • local (for development)

Operator Key Handling

HashPilot accepts DER-encoded and raw hex private keys. Raw hex keys are assumed ECDSA unless HEDERA_OPERATOR_KEY_TYPE=ed25519 is set. On startup the key is checked against the account’s key on the Mirror Node, and the server refuses to run with a mismatched key.

Auto-Key Resolution

HashPilot automatically uses your configured operator account for all operations. No need to manually specify private keys for every deployment or transaction. Resolution order:
  1. Explicitly provided key in the request
  2. MCP operator account (default)

Next Steps

Tutorials

End-to-end walkthroughs with the prompts to use

Tool Reference

Complete API documentation for all tools

Best Practices

Keys, networks, providers and costs

Troubleshooting

Common issues and solutions