# rustchain-mcp

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

## Install

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

## Register with Claude Code

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

Or add to your MCP config manually:

```json
{
  "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