RustChain MCP Server

Query the RustChain network directly from Claude Code or any MCP-compatible client.

Install

pip install mcp httpx

Register with Claude Code

claude mcp add rustchain -- python3 /path/to/server.py

Or with mcp CLI:

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

python3 -c "import httpx; print(httpx.get('https://rustchain.org/epoch').json())"