Production · v3.0.0 · MCP Server

Hedera blockchain tools
for AI agents

HederaToolbox is an MCP server that gives AI agents structured, metered access to the Hedera network. No registration. No API key form. Send HBAR — your account ID becomes your key within 10 seconds.

20
Tools across 6 modules
0.05 ℏ
Minimum call cost
<10s
Deposit-to-active
0
Forms to fill in
The Problem

AI agents can't natively access blockchains

Connecting an agent to Hedera means building the integration yourself — querying mirror nodes, parsing raw data, writing tool schemas, handling auth. Most teams skip it entirely.

No native tool interface

Hedera exposes REST and gRPC APIs, not MCP tools. Agents can't call them directly without a translation layer.

🗂

Raw data isn't agent-ready

Mirror node responses are verbose and unstructured. They require domain knowledge to interpret correctly before an agent can act on them.

🔑

Auth creates deployment friction

API key forms, account setup, and monthly invoices slow down agent deployments — especially autonomous ones that need to self-onboard.

📋

Compliance needs proof

Writing an auditable on-chain record and verifying it later requires HCS expertise most engineering teams don't have on hand.

Platform

20 tools across 6 modules

Every tool returns a clean, structured response. No mirror node parsing. No schema work. Your agent calls the tool and gets back something it can act on.

HCS
Compliance
Identity
Token
Governance
Contracts

Read, query, and write to Hedera Consensus Service topics. Includes AI-powered natural language querying and anomaly detection.

hcs_monitorTopic status, message count, and recent activity0.05 ℏ
hcs_queryNatural language search over HCS messages with AI ranking0.05 ℏ
hcs_understandAnomaly detection, trend analysis, entity extraction, risk assessment0.50 ℏ

Write tamper-evident audit records to the Hedera blockchain, verify them, and retrieve full chronological trails for any entity.

hcs_write_recordWrite a tamper-evident compliance record with transaction proof2.00 ℏ
hcs_verify_recordVerify a record exists on-chain and has not been tampered with0.50 ℏ
hcs_audit_trailFull chronological audit trail for any entity ID1.00 ℏ

Resolve Hedera accounts to their on-chain identity profile, verify KYC status, and screen for sanctions risk.

identity_resolveAccount profile, token holdings, transaction history0.10 ℏ
identity_verify_kycKYC grant status for a Hedera account and token0.20 ℏ
identity_check_sanctionsOn-chain risk signals and counterparty screening0.50 ℏ

Live token pricing, transfer activity monitoring, and deep holder distribution analysis.

token_priceLive price, market cap, and 24h trading volume0.05 ℏ
token_monitorWhale movements and unusual trading patterns0.10 ℏ
token_analyzeHolder distribution, transfer velocity, risk scoring0.30 ℏ

Monitor active governance proposals for Hedera DAOs and tokens. Analyze voter sentiment and predict outcomes.

governance_monitorOpen proposals, voting deadlines, current tallies0.10 ℏ
governance_analyzeVoter sentiment, participation rate, outcome prediction0.50 ℏ

Read contract state, execute read-only function calls, and perform deep activity analysis on Hedera smart contracts.

contract_readContract info, bytecode size, storage details0.10 ℏ
contract_callRead-only function call — no gas cost0.50 ℏ
contract_analyzeActivity patterns, caller distribution, risk assessment1.00 ℏ
Quickstart

Connect in three steps

Works with Claude Desktop, Cursor, or any MCP-compatible agent. No server setup required.

STEP 01

Add the MCP server to your config

One JSON block. npx pulls the latest version automatically — no manual install or update needed.

STEP 02

Send HBAR to the platform wallet

Send any amount from your Hedera account. No form, no registration. The deposit watcher checks every 10 seconds.

STEP 03

Your account ID is your API key

Pass it as api_key in any tool call. Balance deducted per call. Top up any time.

claude_desktop_config.json — Add to mcpServers
{
  "mcpServers": {
    "hederatoolbox": {
      "command": "npx",
      "args": ["-y", "@hederatoolbox/platform"]
    }
  }
}
Platform wallet 0.0.10309126
🤖

Agent-readable endpoint

If your agent needs to self-discover the platform without parsing this page, use the machine-readable file at hederatoolbox.com/llms.txt

Pricing

Pay per call in HBAR

No tiers, no seats, no monthly invoice. Balance is deducted per tool call. Top up any time by sending HBAR to the platform wallet.

Tool Module Description Cost
account_infoPlatformWallet address, pricing, your current balanceFree
get_termsPlatformMachine-readable terms of serviceFree
confirm_termsPlatformRecord consent before paid callsFree
hcs_monitorHCSTopic status and recent activity0.05 ℏ
hcs_queryHCSNatural language search over HCS messages0.05 ℏ
hcs_understandHCSAnomaly detection, trend analysis, risk assessment0.50 ℏ
hcs_write_recordComplianceWrite tamper-evident audit record to HCS2.00 ℏ
hcs_verify_recordComplianceVerify a record has not been tampered with0.50 ℏ
hcs_audit_trailComplianceFull chronological audit trail for an entity1.00 ℏ
identity_resolveIdentityAccount profile, token holdings, transaction history0.10 ℏ
identity_verify_kycIdentityKYC grant status for a Hedera account0.20 ℏ
identity_check_sanctionsIdentityOn-chain risk signals and counterparty screening0.50 ℏ
token_priceTokenLive price, market cap, 24h trading volume0.05 ℏ
token_monitorTokenWhale movements and unusual trading patterns0.10 ℏ
token_analyzeTokenHolder distribution, transfer velocity, risk score0.30 ℏ
governance_monitorGovernanceOpen proposals, deadlines, current vote tallies0.10 ℏ
governance_analyzeGovernanceVoter sentiment, participation rate, outcome prediction0.50 ℏ
contract_readContractContract info, bytecode size, storage details0.10 ℏ
contract_callContractRead-only function call, no gas cost0.50 ℏ
contract_analyzeContractActivity patterns, caller distribution, risk assessment1.00 ℏ
Use Cases

Two problems it solves well

Enterprise teams that need compliance tooling without custom builds, and developers who need Hedera data without writing mirror node integrations from scratch.

🏢

Enterprise teams on Hedera

Council members and regulated businesses running on-chain activity. You hold HBAR, have compliance requirements, and need monitoring and audit tooling without custom integration work.

  • Tamper-evident audit trails written directly to HCS
  • Counterparty sanctions screening before settlement
  • KYC status verification for regulated token operations
  • On-chain anomaly detection for compliance monitoring
⚙️

Developers building AI agents

You're building agents that need Hedera data. You don't want to write and maintain a mirror node integration. You want to call a tool and get a usable answer.

  • Live token pricing and transfer monitoring
  • Smart contract state reads and function calls
  • Governance proposal tracking and analysis
  • Account identity resolution and risk scoring
Support

Questions? Ask the bot.

The HederaToolbox Telegram bot can answer questions about the platform, walk you through getting connected, and flag anything that needs the team's attention directly.

🤖

Claude-powered assistant

Ask in plain English. The bot knows the full tool list, pricing, connection config, and authentication mechanics. It answers immediately and escalates anything it can't handle to the team.

  • How does authentication work?
  • Which tools do I need for compliance auditing?
  • How do I connect from Cursor or Claude Desktop?
  • My deposit isn't showing — what should I check?
💬

Enterprise enquiries

If you're evaluating HederaToolbox for a team or enterprise deployment — volume pricing, dedicated support, custom integration — the bot will take your details and route them directly to the team.

Typical response time: same day for enterprise enquiries, immediate for platform questions.
Open @HederaToolboxBot