HashPilot is an AI-powered MCP server providing comprehensive Hedera blockchain development tools through AI assistants like Claude Desktop, Cursor, and VS Code.
Core Hedera Services:
Account Management: Create accounts, transfer HBAR, and query balances
Token Operations (HTS): Create fungible/non-fungible tokens, mint/burn/transfer tokens, manage KYC/freeze status, and configure custom fees
Consensus Service (HCS): Create/manage topics, submit messages with auto-chunking, query message history, and real-time subscriptions
Smart Contracts & EVM Compatibility:
Deploy and verify contracts via Hardhat/Foundry integration
Execute transactions and call read-only functions
Access 55+ JSON-RPC methods including
eth_call,eth_sendRawTransaction, andeth_getLogsSupport for both EVM-style addresses (0x...) and native Hedera account IDs
Blockchain Queries:
Retrieve transaction receipts and block information
Get network metadata (chain ID, gas prices, current block number)
Estimate gas costs for transactions
Multi-network support (mainnet, testnet, previewnet)
AI/RAG Features:
Semantic search across 10,000+ Hedera documents
Get cited answers to complex questions
Generate SDK code from natural language requests
Development Tools:
Stablecoin Studio: Create compliant stablecoins with role-based access, KYC/AML features, and proof-of-reserve support
Address book management and state backup/restore
Hedera error code explanations
Enables real-time interaction with the Hedera blockchain, allowing querying account balances, retrieving block information, estimating gas fees, checking network status, and accessing transaction receipts.
HashPilot
AI-powered MCP server for Hedera blockchain development
HashPilot is a Model Context Protocol (MCP) server that integrates with AI assistants like Claude Desktop, Cursor, Windsurf, and VS Code to provide a complete toolkit for Hedera blockchain development.
Quick Start
Install via npm
Or use with npx (no install required)
Related MCP server: Flow MCP Server
Editor Configuration
HashPilot works with any MCP-compatible editor. Configure your editor to use HashPilot:
Claude Desktop
Config file location:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.jsonLinux:
~/.config/Claude/claude_desktop_config.json
Configuration:
Cursor
Config file location:
macOS:
~/.cursor/mcp.jsonWindows:
%USERPROFILE%\.cursor\mcp.jsonLinux:
~/.cursor/mcp.json
Configuration:
Windsurf
Config file location:
macOS:
~/.codeium/windsurf/mcp_config.jsonWindows:
%USERPROFILE%\.codeium\windsurf\mcp_config.jsonLinux:
~/.codeium/windsurf/mcp_config.json
Configuration:
VS Code (with MCP extension)
Install the MCP extension and add to your settings.json:
Environment Variables
Variable | Required | Description |
| Yes | Network to use:
,
, or
|
| Yes | Your Hedera account ID (e.g.,
) |
| Yes | Your private key in hex format |
| For RAG | Required for documentation search and code generation |
Features
HashPilot provides 30+ MCP tools covering the complete Hedera development workflow:
Account Management
Create new accounts with ECDSA keys
Query balances (HBAR and tokens)
Transfer HBAR between accounts
Get detailed account information
Token Operations (HTS)
Create fungible and non-fungible tokens
Mint, burn, and transfer tokens
Freeze/unfreeze accounts
Manage KYC compliance
Configure custom fees
Consensus Service (HCS)
Create and manage topics
Submit messages (auto-chunking for large messages)
Query message history
Real-time subscriptions
Smart Contracts
Deploy contracts via Hardhat or Foundry
Verify contracts on HashScan
Call read-only functions (free)
Execute state-changing transactions
Full deployment history tracking
JSON-RPC (EVM Compatibility)
55+ JSON-RPC methods supported
eth_call,eth_sendRawTransaction,eth_getLogsContract deployment and interaction
Full EVM tooling compatibility
Stablecoin Studio
Create compliant stablecoins
Role-based access control
KYC/AML compliance features
Proof-of-Reserve support
Cash-in allowances
Development Tools
Hardhat integration (compile, test, deploy)
Foundry integration (forge, cast, anvil)
Error code explanations
Address book management
State backup/restore
RAG-Powered Documentation
HashPilot includes a powerful RAG (Retrieval-Augmented Generation) system with 10,000+ pre-indexed documents from the Hedera ecosystem:
docs_search
Semantic search across all Hedera documentation:
docs_ask
Ask any question and get cited answers:
code_generate
Generate SDK code from natural language:
Indexed Sources:
Official Hedera Documentation
SDK References (JavaScript, Java, Go, Rust, Python)
Hedera Improvement Proposals (HIPs)
Tutorials and Examples
Smart Contract Patterns
Note: RAG features require an OpenAI API key for embeddings and completions.
Requirements
Node.js 18.0.0 or higher
Hedera Account - Get a free testnet account at portal.hedera.com
OpenAI API Key - Required for RAG features (documentation search, code generation)
Getting a Hedera Testnet Account
Visit portal.hedera.com
Create a free account
Navigate to "Testnet" tab
Copy your Account ID and Private Key (DER encoded)
Convert DER to hex if needed, or use the raw hex key
Example Usage
Once configured, ask your AI assistant:
"Create a new Hedera account with 10 HBAR initial balance"
"Deploy this Solidity contract to testnet using Hardhat"
"Search the docs for HCS message chunking"
"Generate code to create a fungible token with 2 decimals"
"Explain the INSUFFICIENT_PAYER_BALANCE error"
Links
License
Apache-2.0
Contributing
Contributions are welcome! Please see our GitHub repository for guidelines.