rustchain-mcp

MCP server for querying and interacting with the RustChain blockchain from Claude Code or any MCP-compatible client.

Install

git clone https://github.com/ApextheBoss/rustchain-mcp.git
cd rustchain-mcp
npm install
npm run build

Register with Claude Code

claude mcp add rustchain-mcp node /path/to/rustchain-mcp/dist/index.js

Or add to your MCP config manually:

{
  "mcpServers": {
    "rustchain-mcp": {
      "command": "node",
      "args": ["/path/to/rustchain-mcp/dist/index.js"]
    }
  }
}

Tools

Required

Tool	Description
rustchain_balance	Get RTC balance of a wallet address
rustchain_miners	List active miners on the network
rustchain_epoch	Get current epoch info
rustchain_health	Check node health status
rustchain_transfer	Transfer RTC between wallets

Bonus

Tool	Description
rustchain_ledger	Get recent transactions with pagination
rustchain_register_wallet	Register a new wallet
rustchain_bounties	List open bounties from GitHub

Node Failover

The server connects to the primary RustChain node (50.28.86.131). If the primary is unreachable, it automatically tries fallback nodes. All requests have a 10-second timeout.

Auth

No authentication is required for read-only tools. The rustchain_transfer tool accepts an optional private_key parameter if the node requires signing.

Example Usage

Once registered, in Claude Code:

> What's the current RustChain epoch?
[calls rustchain_epoch]

> Check the balance of wallet 0xabc123...
[calls rustchain_balance with address "0xabc123..."]

> Show me active miners
[calls rustchain_miners]

License

MIT