HashPilot

HashPilot is an MCP server that augments Hedera blockchain development with AI-powered tooling. It connects with AI assistants to provide a complete workflow from account and token operations to smart contracts, JSON-RPC interactions, and documentation-assisted code generation.

How to use

Configure your MCP client to point to the local HashPilot server, then start HashPilot from your editor or run it through your preferred CLI workflow. Once running, you can ask your AI assistant to create accounts, manage tokens, deploy contracts, run JSON-RPC calls, and generate code or queries based on Hedera documentation.

How to install

Prerequisites you need to have installed on your machine:

• Node.js 18.0.0 or higher (for running the MCP server and tooling)

• A Hedera testnet account (Account ID and Private Key) for development purposes

• An OpenAI API key if you plan to use RAG features for documentation search and code generation

Install HashPilot globally or use it directly via npx to start the MCP server.

# Install HashPilot globally
npm install -g hashpilot

# Or run directly with npx (no install required)
npx hashpilot

Configuration and usage notes

HashPilot is configured through editor-specific MCP configurations. Each configuration sets the command to run the server, the arguments, and the environment needed for Hedera and AI access.

Environment variables you will typically provide:

• HEDERA_NETWORK: testnet, mainnet, or previewnet

• HEDERA_OPERATOR_ID: your Hedera account ID (e.g., 0.0.12345)

• HEDERA_OPERATOR_KEY: your private key in hex form

• OPENAI_API_KEY: your OpenAI key (required for RAG features)

Examples of editor configurations

{
  "mcpServers": {
    "hashpilot": {
      "command": "npx",
      "args": ["-y", "hashpilot"],
      "env": {
        "HEDERA_NETWORK": "testnet",
        "HEDERA_OPERATOR_ID": "0.0.YOUR_ACCOUNT_ID",
        "HEDERA_OPERATOR_KEY": "YOUR_PRIVATE_KEY_HEX",
        "OPENAI_API_KEY": "sk-YOUR_OPENAI_KEY"
      }
    }
  }
}

Security and best practices

Keep your Hedera operator keys confidential. Use separate credentials for development and production. Do not share your OpenAI API key in public configurations. Rotate keys as part of your security hygiene.

Troubleshooting

If AI responses are slow or failing to access Hedera services, verify that your environment variables are correctly set and that your Hedera testnet account is active. Check that your Node.js version meets the minimum requirement and that your API keys are valid.

Notes

HashPilot integrates directly with editor environments to provide an end-to-end Hedera development experience powered by AI. It supports a broad set of tools across accounts, tokens, consensus topics, smart contracts, and JSON-RPC interactions, along with RAG-assisted documentation and code generation.

Available tools

Account Management

Create new accounts, query balances, transfer HBAR, and retrieve detailed account information.

Token Operations

Create fungible and non-fungible tokens, mint, burn, transfer, and manage KYC and custom fees.

Consensus Service

Create topics, publish messages with optional auto-chunking, query history, and subscribe to updates.

Smart Contracts

Deploy and verify contracts, read-only calls, execute state-changing transactions, and track deployment history.

JSON-RPC (EVM)

Access 55+ JSON-RPC methods for EVM compatibility, including contract deployment and interaction.

Stablecoin Studio

Create compliant stablecoins with role-based access control and KYC/AML features.

Development Tools

Hardhat and Foundry integrations, error code explanations, address book, and state backup/restore.