Installation

This guide covers installing HashPilot and configuring it with your preferred AI editor.

Install HashPilot

Option 1: Global Installation (Recommended)

npm install -g hashpilot

Option 2: Use with npx (No Installation)

You can run HashPilot directly with npx - no global installation required:

npx hashpilot

When using npx in your MCP configuration, use npx -y hashpilot to auto-confirm the install prompt.

Environment Variables

HashPilot requires these environment variables in your MCP configuration:

Variable	Required	Description
`HEDERA_NETWORK`	Yes	Network to use: `testnet`, `mainnet`, or `previewnet`
`HEDERA_OPERATOR_ID`	Yes	Your Hedera account ID (e.g., `0.0.12345`)
`HEDERA_OPERATOR_KEY`	Yes	Your private key in hex format
`OPENAI_API_KEY`	For RAG	Required for documentation search and code generation

Getting a Hedera Account

Visit portal.hedera.com
Create a free account
Navigate to the Testnet tab
Copy your Account ID (e.g., 0.0.12345)
Copy your Private Key (DER encoded hex string)

Never share your private key. Keep it secure and only use testnet keys for development.

Editor Configuration

Choose your AI editor below for specific setup instructions.

Claude Desktop
Cursor
Windsurf
VS Code

Claude Desktop

Config file location:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

Configuration:

{
  "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"
      }
    }
  }
}

Steps:

Create or edit the config file at the location above
Add the configuration with your credentials
Restart Claude Desktop
Test by asking: “Use the health_check tool”

Cursor

Config file location:

macOS: ~/.cursor/mcp.json
Windows: %USERPROFILE%\.cursor\mcp.json
Linux: ~/.cursor/mcp.json

Configuration:

{
  "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"
      }
    }
  }
}

Steps:

Create the .cursor directory if it doesn’t exist
Create mcp.json with the configuration above
Restart Cursor
Open the MCP panel to verify HashPilot is connected

Windsurf

Config file location:

macOS: ~/.codeium/windsurf/mcp_config.json
Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json
Linux: ~/.codeium/windsurf/mcp_config.json

Configuration:

{
  "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"
      }
    }
  }
}

Steps:

Create the directory path if it doesn’t exist
Create mcp_config.json with the configuration above
Restart Windsurf
Test the connection with a simple query

VS Code (with MCP Extension)

First, install the MCP extension from the VS Code marketplace.Add to settings.json:

{
  "mcp.servers": {
    "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"
      }
    }
  }
}

Steps:

Install the MCP extension
Open Settings (Cmd/Ctrl + ,)
Click “Open Settings (JSON)” in the top right
Add the configuration above
Reload VS Code

Using Global Installation

If you installed HashPilot globally, you can use hashpilot directly instead of npx:

{
  "mcpServers": {
    "hashpilot": {
      "command": "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"
      }
    }
  }
}

Verify Installation

After configuring your editor, test that HashPilot is working:

Ask your AI assistant: “Run the health_check tool”
You should see a response with HashPilot version and status

{
  "success": true,
  "data": {
    "status": "healthy",
    "version": "0.1.0",
    "network": "testnet",
    "operatorId": "0.0.12345"
  }
}

Documentation

Install HashPilot

Option 1: Global Installation (Recommended)

Option 2: Use with npx (No Installation)

Environment Variables

Getting a Hedera Account

Editor Configuration

Claude Desktop

Cursor

Windsurf

VS Code (with MCP Extension)

Using Global Installation

Verify Installation

Next Steps

Features

Tool Reference

​Install HashPilot

​Option 1: Global Installation (Recommended)

​Option 2: Use with npx (No Installation)

​Environment Variables

​Getting a Hedera Account

​Editor Configuration

​Claude Desktop

​Cursor

​Windsurf

​VS Code (with MCP Extension)

​Using Global Installation

​Verify Installation

​Next Steps

Features

Tool Reference

Install HashPilot

Option 1: Global Installation (Recommended)

Option 2: Use with npx (No Installation)

Environment Variables

Getting a Hedera Account

Editor Configuration

Claude Desktop

Cursor

Windsurf

VS Code (with MCP Extension)

Using Global Installation

Verify Installation

Next Steps