RustChain MCP Server

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

Installation

# Clone the repo
git clone https://github.com/tomisnotcat/rustchain-mcp.git
cd rustchain-mcp

# Install dependencies
pip install -e .

# Or install from PyPI (after publish)
pip install rustchain-mcp

Usage with Claude Code

Option 1: Direct run

# Run the server
uv run --with mcp rustchain_mcp/server.py

# In Claude Code, add the server:
claude mcp add rustchain python -m rustchain_mcp.server

Option 2: Configure in Claude Code settings

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "rustchain": {
      "command": "python",
      "args": ["-m", "rustchain_mcp.server"]
    }
  }
}

Available Tools

rustchain_health

Check RustChain node health and status.

rustchain_epoch

Get current epoch details including rewards pool.

rustchain_miners

List all active/enrolled miners on the network.

rustchain_balance

Check RTC balance for a miner/wallet address.

Parameters:

• miner_id: Miner ID or wallet address

Example Usage

> What is the current RustChain epoch?
→ Current Epoch: #62, Slot 90/144, 2 enrolled miners, 1.5 RTC reward pool

> Show me the top miners
→ Active Miners (2 total):
- eafc6f14... | PowerPC G4 (Vintage) | 2.5x
- g5-selena-179 | PowerPC G5 (Vintage) | 2.0x

> Check balance for tomisnotcat
→ Balance: 10.5 RTC

API Endpoints

The server connects to:

• Primary: https://rustchain.org
• Fallback support for high availability

Requirements

• Python 3.10+
• httpx
• mcp

License

MIT