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, DeFi, identity, smart contracts, NFTs, governance, and compliance.

Built for agents that need to reason about Hedera, not just interact with it.

---

Connect

https://hedera-mcp-platform-production.up.railway.app/mcp

{
  "mcpServers": {
    "hederatoolbox": {
      "url": "https://hedera-mcp-platform-production.up.railway.app/mcp"
    }
  }
}

---

How It Works

HederaIntel 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.

---

Enterprise Safety — HITL Enforcement

All safety controls run server-side. They cannot be bypassed by modifying the npm package.

HITL is enforced on operation type, not balance size. HederaIntel is a read and intelligence platform — the risk surface is irreversible on-chain writes and runaway agent loops.

Trigger	Tier	Behaviour
Any tool call	Consent gate	confirm_terms required
hcs_write_record	Notify	Executes immediately — webhook notification sent to operator
Same tool >20 calls in 60s	Loop guard	Blocked — agent must wait 60s
All other tools	Auto	Executes immediately

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.05 HBAR	Topic status, message count, recent activity
hcs_query	0.05 HBAR	Natural language Q&A over topic messages, AI-ranked
hcs_understand	0.50 HBAR	Anomaly detection, trend analysis, entity extraction

---

Module 2 — Compliance and Audit Trail

Tool	Cost	Description
hcs_write_record	2.00 HBAR	Write tamper-evident record to HCS
hcs_verify_record	0.50 HBAR	Verify a record has not been altered
hcs_audit_trail	1.00 HBAR	Full chronological audit history for an entity

---

Module 3 — Governance Intelligence

Tool	Cost	Description
governance_monitor	0.10 HBAR	Active proposals, deadlines, current vote tallies
governance_analyze	0.50 HBAR	Voter sentiment, participation rate, outcome prediction

---

Module 4 — Token Intelligence

Tool	Cost	Description
token_price	0.05 HBAR	Spot price, 1h/24h/7d change, liquidity — via SaucerSwap
token_monitor	0.10 HBAR	Recent transfers, whale movements, unusual patterns
token_analyze	0.30 HBAR	Holder distribution, velocity, concentration, risk score

---

Module 5 — Identity Resolution

Tool	Cost	Description
identity_resolve	0.10 HBAR	Account profile: age, holdings, transaction history
identity_verify_kyc	0.20 HBAR	KYC grant status and verification history for a token
identity_check_sanctions	0.50 HBAR	On-chain risk screening, counterparty patterns

---

Module 6 — Smart Contract Intelligence

Tool	Cost	Description
contract_read	0.10 HBAR	Metadata, bytecode size, recent callers, gas stats
contract_call	0.50 HBAR	Read-only function call — no gas, no transaction
contract_analyze	1.00 HBAR	Activity patterns, caller distribution, risk classification

Accepts both Hedera native IDs (0.0.123456) and EVM addresses (0x...).

---

What's New in v2.9.0

• Leaner tool set — removed defi_yields and entire NFT module; 20 focused tools across 6 modules
• New operator wallet — platform wallet updated to 0.0.10309126
• contract_call return type decoding — pass return_types for precise ABI decoding of tuples, arrays, and multi-value returns
• EVM address support — all identity and contract tools accept 0x... addresses directly
• Live HBAR/USD pricing — account_info shows real-time USD cost for every tool

---

Known Limitations

• Mirror node balance endpoint occasionally returns empty for high-holder tokens. Metadata unaffected.

---

Links

npm	https://www.npmjs.com/package/@hederatoolbox/platform
MCP Registry	https://registry.modelcontextprotocol.io — search hederatoolbox
Live endpoint	https://hedera-mcp-platform-production.up.railway.app/mcp
Terms	https://hedera-mcp-platform-production.up.railway.app/terms

---

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].