Hedera Toolbox

What is Hedera Toolbox?

Hedera Toolbox is a production Model Context Protocol (MCP) server that gives AI agents structured, metered access to the Hedera ecosystem—HCS topics, tokens, identity, smart contracts, governance, compliance, and Fixatum DID registration. It provides 23 tools across 7 modules, with pay-per-call billing in HBAR and no registration or OAuth required.

How to use Hedera Toolbox?

For Claude Desktop, install the npm package globally (npm install -g @hederatoolbox/platform) and add it to claude_desktop_config.json under mcpServers. For Claude.ai (web/mobile), paste the MCP endpoint URL (https://api.hederatoolbox.com/mcp) into Settings → Connectors. For other clients, use the endpoint directly. Authentication is automatic: send HBAR to platform wallet 0.0.10309126; your Hedera account ID becomes your API key within 10 seconds.

Key features of Hedera Toolbox

• 23 tools across 7 intelligence modules
• Pay per call in HBAR, no registration or OAuth
• Consent gate and atomic balance deduction for safety
• Loop guard – blocks 20+ same-tool calls in 60 seconds
• No private keys – authenticate with public Hedera account ID
• Tamper-proof records written to your own HCS topic
• Natural language Q&A over HCS messages
• Plug-and-play via MCP endpoint or npm package

Use cases of Hedera Toolbox

• Autonomous agent reputation monitoring using Fixatum scores and HCS alerts
• Compliance and KYA onboarding with on-chain risk screening and trust scores
• Whale alert monitoring for unusual token holder concentration
• Token due diligence – price, holder analysis, admin key risks, treasury identity
• DAO governance monitoring – proposal deadlines, vote tallies, and deep analysis

FAQ from Hedera Toolbox

What does Hedera Toolbox do that alternatives don't?

It provides a unified, agent-native MCP interface to multiple Hedera services (HCS, tokens, identity, governance, compliance) with pay-per-call billing in HBAR, no registration, and built-in safety controls such as a consent gate and loop guard.

What runtime dependencies are needed?

For the MCP endpoint, nothing local is required. To run the provided autonomous agent examples locally, you need Node.js 18+ and an internet connection. The npm package is used for Claude Desktop integration.

Where does data live?

All on-chain data lives on Hedera mainnet. Audit records, compliance reports, and alerts are written to your own HCS topic. Sensitive processing (e.g., sanctions screening) uses on-chain behavioural analysis of Hedera transaction patterns, not external watchlists.

What are the known usage limits?

The loop guard blocks any single tool from being called more than 20 times in 60 seconds by the same API key. Credits are persistent and carry over indefinitely. No other rate limits are documented.

What transport and authentication are supported?

Transport is the MCP protocol over HTTP (endpoint URL) or via stdin in the npm package. Authentication uses your Hedera account ID as the API key after sending a one-time HBAR deposit to the platform wallet. No OAuth, API keys, or credentials are required.