HederaToolbox — Claude Code MCP server: Hedera data per HBAR
HederaToolbox — an MCP server for Claude Code that gives an agent metered access to Hedera network data: token prices, HCS records, governance, smart contracts. Every paid tool costs a small amount of HBAR.
no license 628 installs updated 2026-03-19
claude mcp add --transport http hederatoolbox https://hederatoolbox--mountainmystic.run.toolsWhat HederaToolbox does
It connects over HTTP at https://hederatoolbox--mountainmystic.run.tools and also runs in Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed and Gemini CLI.
The server exposes twenty tools. HCS covers writing a tamper-evident record with hcs_write_record — it returns a record ID plus transaction proof and fires a webhook on each write. Verification and full audit trails come from hcs_verify_record and hcs_audit_trail. Governance tools monitor open proposals and analyze voter sentiment with outcome prediction. Token tools handle price, holder distribution, and whale movement. Identity tools resolve accounts, check KYC status, and screen sanctions. Contract tools read state, call read-only functions, and analyze activity with risk scoring.
Both get_terms and confirm_terms must run before any paid tool works. They are free and need no API key. Prices run from 0.1 HBAR for a topic status to 5 HBAR for writing a compliance record. account_info shows the balance and all tariffs; an account appears automatically after sending HBAR to the platform wallet. Without accepting the terms, paid tools simply do not execute.
What it helps with
- record a compliance entry that cannot be altered later
- verify an HCS record has not been tampered with
- pull current price and market cap for a Hedera token
- screen an account for KYC and sanctions risk
- inspect contract state without submitting a transaction
Example prompts for the agent
- Check topic 0.0.54321 with hcs_verify_record and show whether the record changed since it was written
- Get the current HBAR price and 24h trading volume
- Resolve account 0.0.123456 and pull its KYC status
How to install HederaToolbox
Platform CLI: remote server
claude mcp add --transport http hederatoolbox https://hederatoolbox--mountainmystic.run.toolsPlatform CLI: remote server
codex mcp add hederatoolbox --url https://hederatoolbox--mountainmystic.run.toolsConfig file
{
"mcpServers": {
"hederatoolbox": {
"url": "https://hederatoolbox--mountainmystic.run.tools"
}
}
}Config file
{
"servers": {
"hederatoolbox": {
"type": "http",
"url": "https://hederatoolbox--mountainmystic.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http hederatoolbox https://hederatoolbox--mountainmystic.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about HederaToolbox
How do I install HederaToolbox in Claude Code?
Run claude mcp add --transport http hederatoolbox https://hederatoolbox--mountainmystic.run.tools. The server becomes available in the session after that.
How much does HederaToolbox cost?
Each tool has an HBAR price: from 0.1 for a topic status up to 5 for a compliance write. get_terms, confirm_terms and account_info are free. account_info shows the balance and all tool prices.
What has to happen before the first paid call?
The agent calls get_terms first, then confirm_terms to record consent. Paid tools refuse to run otherwise. The account is funded by sending HBAR to the platform wallet.