@moly-mcp/lido 1.2.1 → 1.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +103 -0
  2. package/package.json +2 -2
package/README.md ADDED
@@ -0,0 +1,103 @@
1
+ # @moly-mcp/lido
2
+
3
+ Terminal assistant for managing Lido staking positions. Stake ETH, manage stETH/wstETH, track withdrawals, vote on governance, bridge from L2, and monitor your position with alerts.
4
+
5
+ ## Install
6
+
7
+ ```
8
+ npm i -g @moly-mcp/lido
9
+ ```
10
+
11
+ Or run directly:
12
+
13
+ ```
14
+ npx @moly-mcp/lido
15
+ ```
16
+
17
+ ## Setup
18
+
19
+ First run launches an interactive wizard that configures your wallet, network, and RPC.
20
+
21
+ ```
22
+ moly setup # re-run wizard
23
+ moly config # view current config (keys redacted)
24
+ moly reset # wipe config and start fresh
25
+ ```
26
+
27
+ Config is saved to `~/.moly/config.json` (chmod 600).
28
+
29
+ ## Commands
30
+
31
+ ### Position
32
+
33
+ ```
34
+ moly position # cross-chain summary (ETH + Base + Arbitrum)
35
+ moly position 0xAddress # specific address
36
+ ```
37
+
38
+ ### Bounds (Policy Limits)
39
+
40
+ Human-set guardrails enforced before any write operation.
41
+
42
+ ```
43
+ moly bounds # show current bounds
44
+ moly bounds set --max-stake-per-tx 1.0 --max-daily-stake 10 --min-eth-reserve 0.5
45
+ moly bounds reset # restore defaults
46
+ ```
47
+
48
+ Defaults: max 10 ETH/tx, 50 ETH/day, 0.5 ETH reserve, auto-vote off.
49
+
50
+ ### Alerts
51
+
52
+ ```
53
+ moly alert add balance_below 1.0
54
+ moly alert add withdrawal_ready
55
+ moly alert add reward_rate_below 0.01
56
+ moly alert add proposal_new
57
+ moly alert add balance_below 5.0 --channel webhook
58
+ moly alert list
59
+ moly alert remove <id>
60
+ moly alert channels --telegram-token <token> --telegram-chat <chat-id>
61
+ moly alert channels --webhook-url https://example.com/hook
62
+ ```
63
+
64
+ Alert types: `balance_below`, `balance_above`, `reward_rate_below`, `reward_rate_above`, `withdrawal_ready`, `proposal_new`, `conversion_rate_above`, `conversion_rate_below`, `reward_delta`, `governance_expiring`.
65
+
66
+ ### Monitor
67
+
68
+ Background daemon that checks alert conditions every 30s.
69
+
70
+ ```
71
+ moly monitor start
72
+ moly monitor status
73
+ moly monitor stop
74
+ ```
75
+
76
+ ### Ledger (Activity Log)
77
+
78
+ ```
79
+ moly ledger list # recent entries
80
+ moly ledger list --tool stake_eth --limit 10
81
+ moly ledger list --since 2025-01-01
82
+ moly ledger stats
83
+ moly ledger export --format json
84
+ moly ledger export --format csv
85
+ ```
86
+
87
+ ## MCP Server
88
+
89
+ Moly also runs as an MCP server exposing 28 tools for staking, withdrawals, wrapping, governance, bridging, alerts, and position tracking.
90
+
91
+ ```
92
+ moly --server
93
+ ```
94
+
95
+ All write operations support `dry_run` and are gated by your configured bounds.
96
+
97
+ ## Requirements
98
+
99
+ Node.js >= 18
100
+
101
+ ## License
102
+
103
+ MIT
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@moly-mcp/lido",
3
- "version": "1.2.1",
4
- "description": "Lido MCP Server — stake, unstake, wrap, govern. Works with Claude Desktop, Cursor, Windsurf, and any MCP client.",
3
+ "version": "1.2.2",
4
+ "description": "Terminal assistant for Lido staking — stake, unstake, wrap, govern, bridge, and monitor positions.",
5
5
  "license": "MIT",
6
6
  "type": "module",
7
7
  "bin": {