Monarch Connect
Monarch Connect is a cross-platform desktop application for managing Monolythium validator nodes remotely via SSH. Built with Tauri 2 and React 19, it provides a full GUI for node operations without requiring any ports to be opened on your servers.
Version: 0.5.1 Platforms: macOS (DMG), Linux (DEB), Windows (MSI)
Installation
Pre-Built Binaries
Download the latest release from the GitHub Releases page:
| Platform | File |
|---|---|
| macOS | monarch-connect_0.5.1_aarch64.dmg or monarch-connect_0.5.1_x64.dmg |
| Linux | monarch-connect_0.5.1_amd64.deb |
| Windows | monarch-connect_0.5.1_x64_en-US.msi |
Build from Source
Prerequisites: Node.js 18+, pnpm, Rust toolchain, Tauri CLI.
git clone https://github.com/monolythium/monarch-connect.git
cd monarch-connect
pnpm install
pnpm tauri build
Adding a Server
Click Add Server to create a server profile.
| Field | Description |
|---|---|
| Label | Display name for this server |
| Host | IP address or hostname |
| Port | SSH port (default: 22) |
| Username | SSH user |
| SSH Key Path | Path to your private key file |
| Auth Mode | Key-based (recommended) or password |
| Network | Testnet or Mainnet |
| Tags | Optional labels for organization |
Key-based SSH authentication is strongly recommended. Monarch Connect stores only the path to your key file, never the key itself. Passphrases are handled through your system keyring.
Multi-Server Dashboard
The main dashboard shows all configured servers as status cards. Each card displays:
- Connection status (connected, disconnected, error)
- Current block height and sync progress
- Validator status (jailed, active, missed blocks)
- Process info (running, stopped, crashed)
- Disk usage percentage
Click any server card to open the detailed per-server view.
Per-Server Tabs
Each server has 7 tabs providing full management capabilities.
1. Dashboard
Real-time overview of the server and node:
- Process status -- running, stopped, or crashed with uptime
- Chain info -- block height, sync status, chain ID
- Validator info -- rank, tokens, commission, jailed status
- Keys -- configured keys and addresses
- Versions -- monod, monarch, and OxidePM versions
Quick action buttons: Start, Stop, Restart.
2. Health
Runs monarch doctor on the remote server and displays results across 13+ categories:
- System, directories, binaries, genesis, config drift
- P2P, ports, sync, process, disk
- Network, security, validator
Each category shows a pass, warn, or fail indicator with details. Click Repair to run monarch repair for fixable issues.
3. Logs
Real-time log viewer with:
- Grep filtering -- search for specific patterns in logs
- Configurable line count -- control how many lines to load
- Auto-scroll -- follows new log entries as they appear
4. Setup
Tool detection and installation:
- Detects whether Monarch CLI and OxidePM are installed
- Install buttons to set up missing tools remotely
- Join wizard -- select network and node role, then join with a single click
5. Validator
Full validator lifecycle management:
- Setup -- guided validator setup wizard
- Register -- on-chain registration with form fields for moniker, amount, commission
- Edit -- modify validator info (moniker, commission, website, details)
- Unjail -- unjail after downtime with missed block check
- Status -- detailed validator information
- Key management -- export and import validator keys with AES-256-GCM encryption
6. Node
Node lifecycle and configuration:
- Start/Stop/Restart -- process controls
- Role configuration -- switch between validator, sentry, seed, archive
- Firewall -- view and apply recommended UFW rules
- Peer management -- update peers, validate connectivity
- Key operations -- create, list, and manage account keys
7. Metrics
Time-series charts powered by Recharts:
- Block height over time
- Peer count trends
- CPU and memory usage
- Disk usage with capacity warnings
- Validator rank changes
- Token balance tracking
- Missed blocks over time
Additional features:
- Event detection -- highlights jailing events, rank changes, disk warnings
- Time range filters -- 1h, 6h, 24h, 7d, 30d
- Event timeline -- chronological view of detected events
Right Panel
The right panel provides two tabs available alongside any server view.
Terminal Tab
Interactive shell connected to the remote server:
- Full terminal emulation via SSH
- Command log with timestamps, source badges, and exit codes
- Commands executed through the GUI are logged here for audit
Claude AI Tab
Chat interface with full server context:
- Understands which server you are viewing and its current state
- Uses MCP tools to run diagnostics and answer questions
- Can suggest fixes based on node health data
- Does not execute commands without explicit approval
MCP Integration
Monarch Connect includes a built-in MCP server using stdio transport. It exposes tools that allow MCP clients (Claude Desktop, Claude Code) to interact with your managed nodes.
Read-Only Tools (9)
| Tool | Description |
|---|---|
node_status | Current node sync status, height, and peers |
cosmos_status | Cosmos-specific chain info |
node_logs | Recent log entries |
health_check | Run monarch doctor and return results |
node_info | Node configuration and version info |
server_ping | Check server reachability |
rpc_query | Query whitelisted RPC endpoints |
node_metrics | Collected time-series metrics |
node_events | Detected events (jailing, rank changes, etc.) |
Read-Write Tools (3)
| Tool | Description |
|---|---|
node_start | Start the node process |
node_stop | Stop the node process |
node_restart | Restart the node process |
Authorization
- Each server must be individually authorized for MCP access
- Read-write tools require explicit per-server opt-in
- RPC queries are limited to a whitelist of safe endpoints
Using with Claude Desktop
Add the Monarch Connect MCP server to your Claude Desktop configuration:
{
"mcpServers": {
"monarch-connect": {
"command": "/path/to/monarch-connect",
"args": ["--mcp"],
"transport": "stdio"
}
}
}
Security Model
Monarch Connect is designed with security as a priority:
| Aspect | Implementation |
|---|---|
| SSH key storage | Only key file paths are stored, never the key contents |
| Passphrases | Handled through the system keyring (macOS Keychain, Linux Secret Service, Windows Credential Manager) |
| Command injection | All user input is sanitized before shell execution |
| RPC access | Whitelisted endpoints only -- no arbitrary RPC calls |
| CSP | Content Security Policy locked down -- no external resource loading |
| MCP transport | Stdio only -- no network ports opened for MCP |
| Network exposure | Zero ports opened on managed servers -- everything runs over SSH |
Never paste private keys, mnemonics, or passwords into the Claude AI chat tab. Use monarch commands for all key operations.
Settings
| Setting | Options | Default |
|---|---|---|
| Theme | Dark, Light | Dark |
| Accent Color | Blue, Green, Purple | Blue |
| Poll Interval | 1--30 seconds | 5 seconds |
The poll interval controls how frequently Monarch Connect refreshes node status from remote servers.
Related
- Monarch CLI -- Command-line reference
- Node Metrics -- Metrics deep dive
- Security Guide -- Security best practices
- Validator Operations -- Full validator lifecycle