rustchain-mcp

# RustChain MCP Server Query the RustChain network directly from Claude Code or any MCP-compatible client. ## Install ```bash pip install mcp httpx ``` ## Register with Claude Code ```bash claude mcp add rustchain -- python3 /path/to/server.py ``` Or with `mcp` CLI: ```bash mcp install server.py --name rustchain ``` ## Available Tools | Tool | Description | |------|-------------| | `rustchain_health` | Node health check: epoch, miners, supply | | `rustchain_epoch` | Current epoch info: number, slot, pot | | `rustchain_miners` | List active miners with hardware and scores | | `rustchain_balance` | RTC balance for a wallet address | | `rustchain_transfer` | Submit a signed RTC transfer | | `rustchain_ledger` | Fee pool and ledger entries | | `rustchain_register_wallet` | Register or resolve a wallet address | | `rustchain_bounties` | List open RustChain bounties | | `rustchain_nodes` | Known network node topology | ## Node Topology - **Primary:** `https://rustchain.org` (`50.28.86.131`) - **Fallback:** `https://50.28.86.153` All tools automatically fall back to the secondary node if the primary is unreachable. ## Example Usage (Claude Code) ``` > What's the current RustChain epoch? [calls rustchain_epoch] { "blocks_per_epoch": 144, "enrolled_miners": 23, "epoch": 96, "epoch_pot": 1.5, "slot": 13951, "total_supply_rtc": 8388608 } ``` ## Auth & Wallet Notes - `rustchain_balance` requires a valid `RTC1...` address - `rustchain_transfer` requires a **pre-signed transaction**; the MCP server never holds private keys - No API key required for read-only tools ## Quick Test ```bash python3 -c "import httpx; print(httpx.get('https://rustchain.org/epoch').json())" ```