# HederaToolbox
# Machine-readable platform information for AI agents
# https://hederatoolbox.com/llms.txt

## What this is

HederaToolbox is a production MCP (Model Context Protocol) server that gives AI agents structured, metered access to the Hedera blockchain. 20 tools across 6 modules. Pay per call in HBAR. No registration required.

## MCP endpoint

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

## npm package

@hederatoolbox/platform
npx -y @hederatoolbox/platform

## Version

3.0.0

## How to connect (Claude Desktop)

Add to claude_desktop_config.json under mcpServers:

{
  "hederatoolbox": {
    "command": "npx",
    "args": ["-y", "@hederatoolbox/platform"]
  }
}

## How authentication works

No registration. No API key form. No dashboard.

1. Send any amount of HBAR to the platform wallet: 0.0.10309126
2. Within 10 seconds, the sending Hedera account ID becomes the API key
3. Pass that account ID as the api_key parameter in any paid tool call
4. Balance is deducted per call. Top up any time by sending more HBAR.

The platform wallet memo: "HederaToolbox deposit — your sending account ID becomes your API key"

Balances are persistent. Unused credit carries over indefinitely. No minimum deposit.

## Free tools (no balance required)

- account_info — Returns platform wallet address, full pricing, and caller balance if api_key provided
- get_terms — Returns machine-readable terms of service
- confirm_terms — Records consent. Must be called before any paid tool will execute.

## Paid tools and costs

### HCS module
- hcs_monitor — Topic status, message count, recent activity — 0.05 HBAR
- hcs_query — Natural language search over HCS messages with AI ranking — 0.05 HBAR
- hcs_understand — Anomaly detection, trend analysis, entity extraction, risk assessment — 0.50 HBAR

### Compliance module
- hcs_write_record — Write tamper-evident audit record to HCS with transaction proof — 2.00 HBAR
- hcs_verify_record — Verify a record exists on-chain and has not been tampered with — 0.50 HBAR
- hcs_audit_trail — Full chronological audit trail for any entity ID — 1.00 HBAR

### Identity module
- identity_resolve — Account profile, token holdings, transaction history — 0.10 HBAR
- identity_verify_kyc — KYC grant status for a Hedera account and token — 0.20 HBAR
- identity_check_sanctions — On-chain risk signals and counterparty screening — 0.50 HBAR

### Token module
- token_price — Live price, market cap, 24h trading volume — 0.05 HBAR
- token_monitor — Whale movements and unusual trading patterns — 0.10 HBAR
- token_analyze — Holder distribution, transfer velocity, risk scoring — 0.30 HBAR

### Governance module
- governance_monitor — Open proposals, voting deadlines, current tallies — 0.10 HBAR
- governance_analyze — Voter sentiment, participation rate, outcome prediction — 0.50 HBAR

### Contract module
- contract_read — Contract info, bytecode size, storage details — 0.10 HBAR
- contract_call — Read-only function call, no gas cost — 0.50 HBAR
- contract_analyze — Activity patterns, caller distribution, risk assessment — 1.00 HBAR

## Autonomous agent onboarding sequence

An agent can onboard and begin calling paid tools with no human involvement:

1. Call account_info (free) — retrieve wallet address and pricing
2. Send HBAR to platform wallet 0.0.10309126 from agent's Hedera account
3. Wait up to 10 seconds for deposit to be detected
4. Call get_terms (free) — retrieve current terms version
5. Call confirm_terms (free) — record consent using terms version from step 4
6. Call any paid tool with api_key set to the agent's Hedera account ID

## HCS compliance topic

0.0.10305125

## Links

- Website: https://hederatoolbox.com
- GitHub: https://github.com/mountainmystic/hederatoolbox
- npm: https://www.npmjs.com/package/@hederatoolbox/platform
- MCP Registry: https://registry.modelcontextprotocol.io (search: hederatoolbox)
- MCP endpoint: https://hedera-mcp-platform-production.up.railway.app/mcp

## Contact

Telegram: @HederaToolboxBot