moonpay-owl

Infrastructure extensions for MoonPay OWS. Provides a CLI, TUI dashboard, and MCP server with tools for wallet management, alerts, tunnels, ledger tracking, reports, and transaction simulation.

Install

npm install -g moonpay-owl

CLI Commands

owl mcp

Start the MCP server over stdio. Proxies mp MCP tools and registers all owl tools.

owl terminal

Launch an interactive TUI dashboard for portfolio monitoring.

owl terminal -w <wallet>

owl tunnel

Wallet sharing via encrypted tunnels with proposal/approval workflows.

| Command | Description | |---|---| | owl tunnel create -w <wallet> -n <name> [-p port] | Create a tunnel (host side) | | owl tunnel connect <uri> -w <wallet> | Connect to a tunnel (peer side) | | owl tunnel list | List active tunnels |

owl alert

Cross-device price alerts with Telegram and webhook support.

| Command | Description | |---|---| | owl alert add -t <token> -c <chain> --condition <cond> --channel <ch> | Add a price alert | | owl alert list | List active alerts | | owl alert remove <id> | Remove an alert | | owl alert daemon | Start alert monitoring daemon | | owl alert channels [--telegram-token ...] [--webhook-url ...] | Configure notification channels |

owl ledger

Activity ledger for tracking all agent operations.

| Command | Description | |---|---| | owl ledger list [-n limit] [-t tool] [-w wallet] [-c chain] [-s since] [--status ok\|error] | Show recent entries | | owl ledger stats [-s since] | Show summary statistics | | owl ledger export -f json\|csv [-n limit] [-s since] | Export ledger data | | owl ledger clear [--before date] | Clear entries |

owl report

Spending reports and portfolio snapshots.

| Command | Description | |---|---| | owl report daily [-w wallet] | Today's activity report | | owl report weekly [-w wallet] | Last 7 days report | | owl report monthly [-w wallet] | Last 30 days report | | owl report portfolio | Unified view across all wallets and chains |

owl dryrun

Simulate transactions without broadcasting.

| Command | Description | |---|---| | owl dryrun swap -w <wallet> -c <chain> --from <token> --amount <n> --to <token> | Simulate a swap | | owl dryrun transfer -w <wallet> -c <chain> --token <token> --amount <n> --to <addr> | Simulate a transfer | | owl dryrun bridge -w <wallet> --from-chain <ch> --from-token <tk> --amount <n> --to-chain <ch> --to-token <tk> | Simulate a bridge |

owl web

Start a local read-only dashboard on port 3131 (configurable with -p).

owl reset

Delete owl agent credentials and channel config. Use --all to remove everything including alerts, ledger, tunnels, and state.

MCP Tools

When running owl mcp, the following tools are available to connected agents:

| Tool | Description | |---|---| | owl_alert_add | Add a price alert rule with cross-device notifications | | owl_alert_list | List all active price alerts | | owl_alert_remove | Remove a price alert by ID | | owl_alert_channels_set | Configure notification channels (Telegram, webhook) | | owl_alert_history | View past triggered alerts | | owl_tunnel_create | Create a tunnel to share wallet access | | owl_tunnel_connect | Connect to an existing tunnel as a peer | | owl_tunnel_list | List all active tunnels and connected peers | | owl_tunnel_propose | Propose a transaction through a tunnel | | owl_tunnel_approve | Approve a pending transaction proposal | | owl_tunnel_reject | Reject a pending transaction proposal | | owl_tunnel_policy_set | Set tunnel policies (spending limits, token whitelist, auto-approve) | | owl_tunnel_policy_get | Get current tunnel policies for a peer | | owl_terminal_start | Start the interactive TUI terminal | | owl_terminal_status | Get current terminal session status | | owl_ledger_query | Query the activity ledger | | owl_ledger_stats | Get ledger summary statistics | | owl_ledger_export | Export the ledger as JSON or CSV | | owl_ledger_clear | Clear ledger entries | | owl_report_generate | Generate a spending report (daily, weekly, monthly) | | owl_portfolio_all | Unified portfolio view across all wallets and chains | | owl_dryrun | Simulate a transaction without broadcasting |

License

CC0-1.0