Monarch Connect
Monarch Connect is a cross-platform desktop application for monitoring Monolythium validator nodes remotely via SSH. Built with Tauri 2 and React 19, it provides a dashboard and AI-assisted diagnostics without requiring any ports to be opened on your servers.
Version: 0.6.0 Platforms: macOS (DMG), Linux (DEB), Windows (MSI/EXE)
Monarch Connect is a monitoring tool. It does not handle keyring passwords, transaction signing, or key management. To set up a validator or perform staking operations, install the Monarch CLI on your server.
Monarch CLI vs Monarch Connect
Monarch CLI runs on the server and handles all node operations. Monarch Connect runs on your desktop and monitors your nodes remotely.
| Operation | Monarch CLI (server) | Monarch Connect (desktop) |
|---|---|---|
| Join a network | monarch join | Not available |
| Start / stop / restart node | monarch start/stop/restart | Remote via SSH |
| Check node status | monarch status | Dashboard + CLI |
| Health audit | monarch doctor | Remote via SSH |
| View logs | monarch logs | Remote via SSH |
| Create validator | monarch validator setup | Not available |
| Register validator | monarch validator register | Not available |
| Create / recover keys | monarch keys create/recover | Not available |
| Export / import keys | monarch export-key/import-key | Not available |
| Delegate / unbond | monarch stake delegate/unbond | Not available |
| Vote on proposals | monarch gov vote | Not available |
| Claim rewards | monarch rewards claim | Not available |
| Upgrade binary | monarch upgrade | Not available |
| AI diagnostics (Claude) | Not available | Chat + MCP tools |
| Multi-server dashboard | Not available | Yes |
Installation
Pre-Built Binaries
Download the latest release from the GitHub Releases page:
| Platform | File |
|---|---|
| macOS | monarch-connect_0.5.2_aarch64.dmg or monarch-connect_0.5.2_x64.dmg |
| Linux | monarch-connect_0.5.2_amd64.deb |
| Windows | monarch-connect_0.5.2_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 |
| SSH implementation | In-process ssh2 library (v0.5.2+) -- no dependency on system SSH binary, works identically on Windows/macOS/Linux |
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