Hedera Toolbox
Production MCP server giving AI agents metered access to live Hedera blockchain data. Query token prices, screen identities, monitor governance, write tamper-evident HCS compliance records, and analyze smart contracts — all paid in HBAR micropayments per call.
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 → paste the endpoint URL above.
Claude Desktop app
Step 1 — install the package globally (required, do this once):
npm install -g @hederatoolbox/platform
Step 2 — add to claude_desktop_config.json under mcpServers:
{
"mcpServers": {
"hederatoolbox": {
"command": "npx",
"args": ["-y", "@hederatoolbox/platform"]
}
}
}
Restart Claude Desktop after saving the config.
Windows users: if you see
npm error could not determine executable to run, your npm global directory may not exist yet. Run these first:mkdir %APPDATA%\npm npm config set prefix %APPDATA%\npm npm install -g @hederatoolbox/platform
OpenClaw / ClawHub
Install the HederaToolbox skill directly from ClawHub:
clawhub install mountainmystic/hederatoolbox
Then add your Hedera account ID to your OpenClaw environment:
HEDERA_ACCOUNT_ID=0.0.YOUR_ACCOUNT_ID
Skill listing: clawhub.ai/mountainmystic/hederatoolbox
Cursor / other MCP-compatible clients Use the endpoint URL directly in your MCP server config.
How It Works
HederaToolbox uses agent-native HBAR payments. No accounts, no OAuth, no email.
1. get_terms -> read the Terms of Service (free)
2. confirm_terms -> record consent (free)
3. account_info -> get platform wallet + pricing (free)
4. send HBAR -> your account ID becomes your key (auto-provisioned)
5. call any tool -> pass your Hedera account ID as api_key
Platform wallet: 0.0.10309126 (mainnet)
Credits are persistent. Unused balance carries over indefinitely.
Safety Architecture
All safety controls run server-side and cannot be bypassed by modifying the npm package.
- Consent gate —
confirm_termsrequired before any paid tool executes - Atomic balance deduction — balance check and deduct are a single SQL operation, race-condition proof
- Loop guard — same tool called >20 times in 60s by the same key is blocked automatically
- No private keys — we never see your private key and never ask for it. You authenticate with your Hedera account ID — a public identifier, like a username. Your key stays in your wallet.
Terms of Service: get_terms tool or /public/terms.json
Tools
Free — Onboarding and Legal
| Tool | Description |
|---|---|
get_terms | Machine-readable Terms of Service. Call before anything else. |
confirm_terms | Record consent. Required before any paid tool. |
account_info | Platform wallet address, full pricing table, your balance. |
Module 1 — HCS Topic Intelligence
| Tool | Cost | Description |
|---|---|---|
hcs_monitor | 0.10 HBAR | Topic status, message count, recent activity |
hcs_query | 0.10 HBAR | Natural language Q&A over topic messages, AI-ranked |
hcs_understand | 1.00 HBAR | Anomaly detection, trend analysis, entity extraction |
Module 2 — Compliance and Audit Trail
| Tool | Cost | Description |
|---|---|---|
hcs_write_record | 5.00 HBAR | Write tamper-evident record to HCS |
hcs_verify_record | 1.00 HBAR | Verify a record has not been altered |
hcs_audit_trail | 2.00 HBAR | Full chronological audit history for an entity |
Module 3 — Governance Intelligence
| Tool | Cost | Description |
|---|---|---|
governance_monitor | 0.20 HBAR | Active proposals, deadlines, current vote tallies |
governance_analyze | 1.00 HBAR | Voter sentiment, participation rate, outcome prediction |
Module 4 — Token Intelligence
| Tool | Cost | Description |
|---|---|---|
token_price | 0.10 HBAR | Spot price, 1h/24h/7d change, liquidity — via SaucerSwap |
token_monitor | 0.20 HBAR | Recent transfers, whale movements, unusual patterns |
token_analyze | 0.60 HBAR | Holder distribution, velocity, concentration, risk score |
Module 5 — Identity Resolution
| Tool | Cost | Description |
|---|---|---|
identity_resolve | 0.20 HBAR | Account profile: age, holdings, transaction history |
identity_verify_kyc | 0.50 HBAR | KYC grant status and verification history for a token |
identity_check_sanctions | 1.00 HBAR | On-chain risk screening, counterparty patterns |
Module 6 — Smart Contract Intelligence
| Tool | Cost | Description |
|---|---|---|
contract_read | 0.20 HBAR | Metadata, bytecode size, recent callers, gas stats |
contract_call | 1.00 HBAR | Read-only function call — no gas, no transaction |
contract_analyze | 1.50 HBAR | Activity patterns, caller distribution, risk classification |
Accepts both Hedera native IDs (0.0.123456) and EVM addresses (0x...).
Changelog
v3.4.5 — Agent examples improved (whale cooldown, compliance verify step, due diligence --save flag), xagent persona rewrite, npm README updated
v3.4.2 — X agent (Telegram-gated autonomous tweet drafting), agent examples added to repo
v3.4.0 — Repriced all tools across all 6 modules
v3.3.1 — Full security audit: SQLite-backed rate limiting, API key validation, 1MB body cap, separate BACKUP_SECRET, 90-day PII purge, HITL removed, legal pages deployed
Known Limitations
- Mirror node balance endpoint occasionally returns empty for high-holder tokens. Metadata unaffected.
Links
Note: The old package
@hederaintel/platformis deprecated. Update your config to use@hederatoolbox/platform.
License
npm package — provided for integration use only.
Remote server and all backend logic — Proprietary. See LICENSE.md.
Enterprise licensing and SLA inquiries: open an issue titled [Enterprise].
Website
On-Chain Identity
HederaToolbox has a permanent platform identity record written to Hedera mainnet.
| Field | Value |
|---|---|
| HCS Topic | 0.0.10353855 |
| Record ID | c420c3b9-408e-4f87-a9e1-1dcbb54facfa |
| Transaction | [email protected] |
| Written | 16 March 2026 |
| Verify | hashscan.io/mainnet/topic/0.0.10353855 |
相關伺服器
TinyTasks MCP Server
A hybrid MCP server compatible with Claude Desktop and Web, supporting both local and web deployment modes for task management.
esa
An MCP server for interacting with the esa.io knowledge-sharing platform.
MCP Kanban Memory
Manage complex AI agent workflows with a Kanban-based task management system.
Rememberizer MCP Server for Common Knowledge
Access personal or team knowledge from internal repositories like documents and Slack discussions.
Trello
Integrates with Trello to manage projects, boards, and cards, using Nango for authentication.
Jira
Interact with Jira to manage issues, projects, and workflows using the Jira Cloud Platform REST API.
Anki MCP
A Model Context Protocol (MCP) server that provides seamless integration with Anki, enabling AI assistants to interact with your flashcard collection. Create, read, update, and manage Anki cards programmatically through a standardized interface.
Coda
Interact with the Coda API to manage documents and pages, including creating, reading, updating, and deleting.
Odoo-MCP
Integrate with Odoo ERP systems to manage business data and operations. Requires external configuration for connection parameters.
n8n MCP Server
Manage n8n workflows, executions, and credentials through the Model Context Protocol.