# HederaToolbox

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 628 installs
- Author: mountainmystic
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/mountainmystic/hederatoolbox
- Updated: 2026-03-19
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/hederatoolbox

## What it 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.

## Requirements
- Remote server: `https://hederatoolbox--mountainmystic.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http hederatoolbox https://hederatoolbox--mountainmystic.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add hederatoolbox --url https://hederatoolbox--mountainmystic.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "hederatoolbox": {
            "url": "https://hederatoolbox--mountainmystic.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "hederatoolbox": {
            "type": "http",
            "url": "https://hederatoolbox--mountainmystic.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http hederatoolbox https://hederatoolbox--mountainmystic.run.tools
```

## When to use it
- 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
- 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

## Similar
- [x402-payments](https://affpapa.org/en/nevibecode/skills/x402-payments.md) — skill · 591 installs
- [hiero-cli](https://affpapa.org/en/nevibecode/skills/hiero-cli.md) — skill · 593 installs
- [Starknet MCP Server](https://affpapa.org/en/nevibecode/mcp/starknet-mcp-server.md) — MCP server · 784 installs
- [x402receipts](https://affpapa.org/en/nevibecode/mcp/x402receipts.md) — MCP server · ★ 1 repo stars
- [blockchain-developer](https://affpapa.org/en/nevibecode/skills/blockchain-developer.md) — skill · 1300 installs
- [celopedia-skill](https://affpapa.org/en/nevibecode/skills/celopedia-skill.md) — skill · ★ 31 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
