# HederaToolbox

Production MCP server giving AI agents metered access to live Hedera blockchain data. Query token prices, screen identities, monitor governance, write tamper-evident HCS compliance records, and analy…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add mountainmystic/hederatoolbox

# Browse available tools
npx -y @smithery/cli@latest tool list mountainmystic/hederatoolbox

# Get full schema for a tool
npx -y @smithery/cli@latest tool get mountainmystic/hederatoolbox get_terms

# Call a tool
npx -y @smithery/cli@latest tool call mountainmystic/hederatoolbox get_terms '{}'
```

## Direct MCP Connection

Endpoint: `https://hederatoolbox--mountainmystic.run.tools`

## Tools (20)

- `get_terms` — Retrieve the machine-readable Terms of Service for the HederaIntel MCP Platform. FREE to call — no API key required. Al…
- `confirm_terms` — Confirm acceptance of the HederaIntel Terms of Service. Must be called before any paid tool will execute. Records a tim…
- `account_info` — Get platform wallet address, pricing for all 20 tools in HBAR and USD, and your current balance. FREE to call — no API …
- `hcs_monitor` — Get current status and metadata of any HCS topic - message count, creation time, memo, and recent activity. Defaults to…
- `hcs_query` — Query an HCS topic with a natural language question. Returns AI-ranked relevant messages and a plain English summary. C…
- `hcs_understand` — Deep pattern analysis of an HCS topic - anomaly detection, trend analysis, entity extraction, or risk assessment. Costs…
- `hcs_write_record` — Write a tamper-evident compliance record to the Hedera blockchain. Returns a record ID and transaction proof. If no top…
- `hcs_verify_record` — Verify a compliance record exists on the Hedera blockchain and has not been tampered with. Costs 1.0 HBAR.
- `hcs_audit_trail` — Retrieve the full chronological audit trail for an entity from the Hedera blockchain. Costs 2.0 HBAR.
- `governance_monitor` — Monitor active governance proposals for a Hedera token or DAO. Returns open proposals, voting deadlines, and current vo…
- `governance_analyze` — Deep analysis of a governance proposal including voter sentiment, participation rate, token concentration, and outcome …
- `token_price` — Get the current price, market cap, and 24h trading volume for a Hedera token. Costs 0.1 HBAR.
- `token_analyze` — Deep analysis of a Hedera token including holder distribution, transfer velocity, liquidity, and risk scoring. Costs 0.…
- `token_monitor` — Monitor recent token transfer activity, whale movements, and unusual trading patterns for a Hedera token. Costs 0.2 HBA…
- `identity_resolve` — Resolve a Hedera account ID or EVM address to its on-chain identity profile including account age, token holdings, tran…
- `identity_verify_kyc` — Check the KYC status of a Hedera account for one or more tokens. Returns KYC grant status and verification history. Acc…
- `identity_check_sanctions` — Screen a Hedera account against on-chain risk signals including transaction patterns, counterparty risk, and known flag…
- `contract_read` — Read state from a Hedera smart contract - get contract info, bytecode size, recent activity, and storage details withou…
- `contract_call` — Execute a read-only call to a Hedera smart contract function and return the result. Does not submit a transaction or co…
- `contract_analyze` — Deep analysis of a Hedera smart contract including activity patterns, caller distribution, gas usage, risk assessment, …

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get mountainmystic/hederatoolbox <tool-name>
```