The intelligence layer for AI agents on Hedera.
HederaToolbox
The intelligence layer for AI agents on Hedera.
20 tools. 6 modules. Pay per call in HBAR. No registration.
HederaToolbox is a production Model Context Protocol server. It gives AI agents structured, metered access to the full Hedera ecosystem — HCS topics, tokens, identity, smart contracts, governance, and compliance.
Built for agents that need to reason about Hedera, not just interact with it.
Demo
Claude Desktop — one business objective, no steps specified, agent decides everything:
Terminal agent — autonomous compliance workflow running headless:
Autonomous Agent Examples
Four production-ready agents in `examples/`. Clone the repo, fund once, run. Zero dependencies beyond Node.js 18+.
One-time setup for all agents:
git clone https://github.com/mountainmystic/hederatoolbox.git
cd hederatoolbox
# Send any HBAR to the platform wallet from your Hedera account.
# Your account ID becomes your API key automatically within 10 seconds.
# Platform wallet: 0.0.10309126
Windows users: set env vars before running:
set HEDERA_ACCOUNT_ID=0.0.YOUR_ID && set TOKEN_ID=0.0.731861 && node examples/whale-alert-agent.mjsOr edit the config constants directly at the top of each file.
🐋 Whale Alert Monitor
`examples/whale-alert-agent.mjs`
Monitors any Hedera token for unusual whale concentration on a schedule. When top-10 holders exceed your threshold, writes a tamper-proof whale_alert record to HCS and prints the Hashscan proof URL.
HEDERA_ACCOUNT_ID=0.0.YOUR_ID TOKEN_ID=0.0.731861 node examples/whale-alert-agent.mjs
| Config | Default | Description |
|---|---|---|
TOKEN_ID |
0.0.731861 |
Token to monitor |
THRESHOLD_PCT |
80 |
Alert if top-10 holders exceed this % |
CHECK_INTERVAL_MS |
3600000 |
Check every hour |
Cost: 0.2 ℏ per check · 5 ℏ only when anomaly fires
✅ Compliance Onboarding
`examples/compliance-onboarding-agent.mjs`
Screens a Hedera account before doing business with them. Runs identity resolution, sanctions screening, and optional KYC verification in sequence — then writes a tamper-proof compliance record to HCS. Returns APPROVED, REJECTED, PENDING_REVIEW, or PENDING_KYC.
HEDERA_ACCOUNT_ID=0.0.YOUR_ID SUBJECT=0.0.999999 node examples/compliance-onboarding-agent.mjs
# With KYC check for your token:
HEDERA_ACCOUNT_ID=0.0.YOUR_ID SUBJECT=0.0.999999 KYC_TOKEN_ID=0.0.731861 node examples/compliance-onboarding-agent.mjs
Cost: ~1.7 ℏ per screening · add 0.5 ℏ for KYC check
🔍 Token Due Diligence
`examples/token-due-diligence-agent.mjs`
Full investment and listing due diligence on any Hedera token in one run. Pulls price data, deep holder analysis, admin key risks, and treasury account identity — outputs a structured risk report with an overall verdict.
HEDERA_ACCOUNT_ID=0.0.YOUR_ID TOKEN_ID=0.0.731861 node examples/token-due-diligence-agent.mjs
Cost: ~1.0 ℏ per report (token_price + token_analyze + identity_resolve on treasury)
🗳️ DAO Governance Monitor
`examples/dao-monitor-agent.mjs`
Watches active governance proposals for a Hedera token on a schedule. Alerts when a proposal is closing within 24 hours. Pass --analyze with a PROPOSAL_ID for deep vote tally and outcome prediction.
# Monitor proposals
HEDERA_ACCOUNT_ID=0.0.YOUR_ID TOKEN_ID=0.0.731861 node examples/dao-monitor-agent.mjs
# Deep-analyze a specific proposal (requires HCS topic)
HEDERA_ACCOUNT_ID=0.0.YOUR_ID TOKEN_ID=0.0.731861 TOPIC_ID=0.0.999 PROPOSAL_ID=42 node examples/dao-monitor-agent.mjs --analyze
Cost: 0.2 ℏ per check · 1.0 ℏ for deep analysis · 10 ℏ covers ~12 days at 4 checks/day
Connect
MCP endpoint:
https://api.hederatoolbox.com/mcp
Claude.ai (web or mobile) Settings → Connectors → Add →
Tools (4)
token_priceRetrieves current market price data for a specific Hedera token.identity_resolveResolves Hedera account IDs to identity information.token_analyzePerforms deep holder analysis and risk assessment on a token.hcs_recordWrites a tamper-evident compliance or data record to an HCS topic.Environment Variables
HEDERA_ACCOUNT_IDrequiredYour Hedera account ID used for authentication and HBAR micropayments.TOKEN_IDThe specific Hedera token ID to monitor or analyze.THRESHOLD_PCTPercentage threshold for whale concentration alerts.Configuration
{"mcpServers": {"hederatoolbox": {"command": "npx", "args": ["-y", "@hederatoolbox/platform"], "env": {"HEDERA_ACCOUNT_ID": "0.0.YOUR_ID"}}}}