mcp-server-madeonsol 1.4.0 → 1.6.0

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 (3) hide show
  1. package/README.md +60 -13
  2. package/dist/index.js +1 -1
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -4,6 +4,22 @@ MCP server for [MadeOnSol](https://madeonsol.com) Solana KOL intelligence API. U
4
4
 
5
5
  > Real-time Solana trading intelligence: track 1,000+ KOL wallets with <3s latency, score 6,700+ Pump.fun deployers by reputation, detect multi-KOL coordination signals, monitor any Solana wallet for swaps and transfers, and stream every DEX trade. Free tier: 200 requests/day at [madeonsol.com/developer](https://madeonsol.com/developer) — no credit card required.
6
6
 
7
+ > **New in 1.6.0** *(2026-05-09)* — **Market-cap filtering everywhere.** `madeonsol_kol_feed`, `madeonsol_kol_coordination`, `madeonsol_kol_first_touches`, and `madeonsol_copytrade_signals` all accept `min_mc_usd` / `max_mc_usd` so the assistant can ask "show me sub-$50K KOL trades" without post-filtering. Tool descriptions updated. Deprecated `avg_entry_mc_usd` removed from leaderboards.
8
+
9
+ ## Quick start (10 seconds)
10
+
11
+ ```bash
12
+ npm install -g mcp-server-madeonsol
13
+ ```
14
+
15
+ Add to `claude_desktop_config.json` or Cursor MCP settings (free key: https://madeonsol.com/developer):
16
+
17
+ ```json
18
+ { "mcpServers": { "madeonsol": { "command": "mcp-server-madeonsol", "env": { "MADEONSOL_API_KEY": "msk_..." } } } }
19
+ ```
20
+
21
+ Restart Claude Desktop and ask: *"What are KOLs buying right now?"*
22
+
7
23
  ## Authentication
8
24
 
9
25
  Two options (in priority order):
@@ -53,26 +69,27 @@ Add to MCP settings with the same command and env vars.
53
69
  | Tool | Description |
54
70
  |---|---|
55
71
  | `madeonsol_kol_feed` | Real-time KOL trade feed (1,000+ wallets) |
56
- | `madeonsol_kol_coordination` | Multi-KOL convergence signals — tokens multiple KOLs are accumulating |
72
+ | `madeonsol_kol_coordination` | Multi-KOL convergence signals (v1.1) — peak-density window, exit detection, 0-100 score |
73
+ | `madeonsol_kol_first_touches` | First-KOL-touch events — backtested scout signal. Filter by scout tier, winrate, token age, mint suffix |
57
74
  | `madeonsol_kol_leaderboard` | KOL PnL and win rate rankings (180 days of history; periods: today, 7d, 30d, 90d, 180d) |
58
75
  | `madeonsol_kol_pairs` | KOL affinity matrix — which KOLs co-trade the same tokens |
59
76
  | `madeonsol_kol_hot_tokens` | KOL momentum tokens — accelerating buy interest |
60
- | `madeonsol_kol_trending_tokens` | Tokens ranked by KOL buy volume (5m–12h windows). Sub-hour periods PRO/ULTRA only. |
61
- | `madeonsol_kol_pnl` | Deep per-wallet PnL: equity curve, risk metrics, closed + open positions. BASIC=summary, PRO=+curve+closed, ULTRA=+open. |
62
- | `madeonsol_kol_timing` | KOL entry/exit timing profile — PRO/ULTRA |
77
+ | `madeonsol_kol_trending_tokens` | Tokens ranked by KOL buy volume (5m–12h windows). ULTRA adds full KOL wallet addresses. |
78
+ | `madeonsol_kol_pnl` | Deep per-wallet PnL: equity curve, risk metrics, closed positions. ULTRA adds open positions (tokens bought but not yet sold). |
79
+ | `madeonsol_kol_timing` | KOL entry/exit timing profile — available on all tiers |
63
80
 
64
81
  ### Deployer Hunter
65
82
 
66
83
  | Tool | Description |
67
84
  |---|---|
68
- | `madeonsol_deployer_alerts` | Pump.fun deployer launches with KOL enrichment. PRO/ULTRA: filter by tier (elite/good/moderate/rising/cold). |
69
- | `madeonsol_deployer_trajectory` | Deployer skill curve — streaks, rolling bond rate, trend — PRO/ULTRA |
85
+ | `madeonsol_deployer_alerts` | Pump.fun deployer launches with KOL enrichment. Filter by tier (elite/good/moderate/rising/cold). ULTRA unlocks full pagination. |
86
+ | `madeonsol_deployer_trajectory` | Deployer skill curve — streaks, rolling bond rate, trend — available on all tiers |
70
87
 
71
88
  ### Wallet Tracker
72
89
 
73
90
  | Tool | Description |
74
91
  |---|---|
75
- | `madeonsol_wallet_tracker_watchlist` | List your tracked wallets and remaining capacity (BASIC: 10, PRO: 50, ULTRA: 100) |
92
+ | `madeonsol_wallet_tracker_watchlist` | List your tracked wallets and remaining capacity (Free: 10, Pro: 50, Ultra: 100) |
76
93
  | `madeonsol_wallet_tracker_add` | Add a wallet to your watchlist |
77
94
  | `madeonsol_wallet_tracker_remove` | Remove a wallet from your watchlist |
78
95
  | `madeonsol_wallet_tracker_trades` | Historical swap/transfer events for watched wallets (120-day retention) |
@@ -84,7 +101,7 @@ Scored from 47,000+ early-buyer records (wallets seen in the first 20 buyers of
84
101
 
85
102
  | Tool | Tier | Description |
86
103
  |---|---|---|
87
- | `madeonsol_alpha_leaderboard` | BASIC+ | Top profitable early-buyer wallets. BASIC=25 (truncated), PRO=100, ULTRA=500 + bot signals |
104
+ | `madeonsol_alpha_leaderboard` | All | Top profitable early-buyer wallets. Up to 100 on Free/Pro; ULTRA unlocks 500 + bot signals |
88
105
  | `madeonsol_alpha_wallet` | ULTRA | Full per-token breakdown + bot_signals array |
89
106
  | `madeonsol_alpha_linked` | ULTRA | Wallets behaviorally linked (co-bought 3+ tokens within 2s) |
90
107
 
@@ -93,7 +110,7 @@ Scored from 47,000+ early-buyer records (wallets seen in the first 20 buyers of
93
110
  | Tool | Tier | Description |
94
111
  |---|---|---|
95
112
  | `madeonsol_token_cap_table` | PRO+ | First non-deployer early buyers, enriched with PnL/KOL/bot flags. PRO=10, ULTRA=20 |
96
- | `madeonsol_token_buyer_quality` | BASIC+ | 0–100 buyer-quality score (5-min cached). BASIC=score+signal only |
113
+ | `madeonsol_token_buyer_quality` | All | 0–100 buyer-quality score + full breakdown (5-min cached) |
97
114
 
98
115
  ### Copy-Trade Rules (PRO/ULTRA)
99
116
 
@@ -108,6 +125,35 @@ Server-side rules that fire signals when a watched source wallet trades. Deliver
108
125
  | `madeonsol_copytrade_delete` | Delete permanently |
109
126
  | `madeonsol_copytrade_signals` | Recent fired signals (up to 7 days) |
110
127
 
128
+ ### KOL Coordination Alerts (PRO/ULTRA — v1.1 push signals)
129
+
130
+ Real-time push alerts when a KOL cluster co-buys the same token. Fires within ~1s (pg_notify push). Delivered via WebSocket (`kol:coordination` channel, user-scoped) and/or HMAC-signed webhook.
131
+
132
+ | Tool | Description |
133
+ |---|---|
134
+ | `madeonsol_coordination_alerts_list` | List your rules (PRO=5, ULTRA=20) |
135
+ | `madeonsol_coordination_alerts_create` | Create a rule. Returns `webhook_secret` once — store it |
136
+ | `madeonsol_coordination_alerts_get` | Get one rule |
137
+ | `madeonsol_coordination_alerts_update` | Update fields or toggle `is_active` |
138
+ | `madeonsol_coordination_alerts_delete` | Delete permanently |
139
+
140
+ ### KOL Scout Signal — first KOL touches *(new in 1.3)*
141
+
142
+ Every "first KOL buy on a token mint" event. Filterable by **scout tier** (S/A/B/C from `mv_kol_scout_score`), KOL winrate, token age, mint suffix.
143
+
144
+ **Backtest:** S-tier scouts attract ≥3 follow-on KOLs within 4h ~50% of the time vs ~14% baseline (38d / 491k buys / 72,549 events). Public leaderboard at [madeonsol.com/kol/scouts](https://madeonsol.com/kol/scouts).
145
+
146
+ | Tool | Description |
147
+ |---|---|
148
+ | `madeonsol_kol_first_touches` | Recent first-KOL-touch events. Filters: `min_scout_tier`, `min_kol_winrate_7d`, `token_age_max_min`, `mint_suffix`, `preset`, etc. |
149
+ | `madeonsol_first_touch_subscriptions_list` | List your first-touch webhook subscriptions — ULTRA |
150
+ | `madeonsol_first_touch_subscriptions_create` | Create a webhook rule (HMAC-signed). Returns `webhook_secret` once — store it. Up to 10/user — ULTRA |
151
+ | `madeonsol_first_touch_subscriptions_get` | Get one subscription — ULTRA |
152
+ | `madeonsol_first_touch_subscriptions_update` | Update fields or toggle `is_active` — ULTRA |
153
+ | `madeonsol_first_touch_subscriptions_delete` | Delete permanently — ULTRA |
154
+
155
+ > **Don't poll — push.** Median lead time before the second KOL is 12 seconds. WebSocket channel: `kol:first_touches` (PRO+).
156
+
111
157
  ### Streaming & Webhooks
112
158
 
113
159
  | Tool | Description |
@@ -128,17 +174,18 @@ Server-side rules that fire signals when a watched source wallet trades. Deliver
128
174
 
129
175
  | Tier | Price | Wallets tracked | Requests/day |
130
176
  |------|-------|-----------------|--------------|
131
- | BASIC | Free | 10 | 200 |
132
- | PRO | $49/mo | 50 | 10,000 |
133
- | ULTRA | $149/mo | 100 + WS events | 100,000 |
177
+ | Free | $0 | 10 | 200 |
178
+ | Pro | $49/mo | 50 | 10,000 |
179
+ | Ultra | $149/mo | 100 + WS events | 100,000 |
134
180
 
135
- Get a key at [madeonsol.com/developer](https://madeonsol.com/developer).
181
+ Free tier returns the full REST response shape on every endpoint — real wallets, TX signatures, full precision. Paid tiers unlock webhooks, WebSockets, rule engines, and ULTRA-only data depth. Get a key at [madeonsol.com/developer](https://madeonsol.com/developer).
136
182
 
137
183
  ## Also Available
138
184
 
139
185
  | Platform | Package |
140
186
  |---|---|
141
187
  | TypeScript SDK | [`madeonsol`](https://www.npmjs.com/package/madeonsol) on npm |
188
+ | Rust SDK | [`madeonsol`](https://crates.io/crates/madeonsol) on crates.io |
142
189
  | Python (LangChain, CrewAI) | [`madeonsol-x402`](https://pypi.org/project/madeonsol-x402/) on PyPI |
143
190
  | ElizaOS | [`@madeonsol/plugin-madeonsol`](https://www.npmjs.com/package/@madeonsol/plugin-madeonsol) |
144
191
  | Solana Agent Kit | [`solana-agent-kit-plugin-madeonsol`](https://www.npmjs.com/package/solana-agent-kit-plugin-madeonsol) |
package/dist/index.js CHANGED
@@ -100,7 +100,7 @@ function registerTools(server) {
100
100
  params.strategy = strategy;
101
101
  return { content: [{ type: "text", text: await query("/api/x402/kol/feed", params) }] };
102
102
  });
103
- server.tool("madeonsol_kol_coordination", "KOL convergence signals (v1.1) — tokens being accumulated by multiple KOLs. Response includes peak_kols/peak_buys (busiest window slice), exited_count (net-flow-negative wallets), and a 0-100 coordination_score. Blacklist filters WIF/BONK/stables by default.", {
103
+ server.tool("madeonsol_kol_coordination", "KOL convergence signals (v1.2) — tokens being accumulated by multiple KOLs. Response includes peak_kols/peak_buys (busiest window slice), exited_count (net-flow-negative wallets), 0-100 coordination_score, and (v1.2 / 2026-05-06) market_cap_usd_at_first_buy + market_cap_usd + last_price_usd so you can see whether the cluster formed at micro-cap or after the chart was already running. Blacklist filters WIF/BONK/stables by default.", {
104
104
  period: z.enum(["1h", "6h", "24h", "7d"]).default("24h").describe("Time period for coordination analysis"),
105
105
  min_kols: z.number().min(2).max(50).default(3).describe("Minimum number of KOLs converging on the same token"),
106
106
  limit: z.number().min(1).max(50).default(20).describe("Number of coordination signals to return"),
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "mcp-server-madeonsol",
3
- "version": "1.4.0",
3
+ "version": "1.6.0",
4
4
  "mcpName": "io.github.lambopoewert/madeonsol",
5
5
  "description": "MCP server for MadeOnSol Solana KOL intelligence API — use from Claude, Cursor, or any MCP client",
6
6
  "type": "module",