mcp-server-madeonsol 1.4.0 → 1.5.0

package/README.md

@@ -4,6 +4,20 @@ MCP server for [MadeOnSol](https://madeonsol.com) Solana KOL intelligence API. U
 
 > 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.
 
+## Quick start (10 seconds)
+
+```bash
+npm install -g mcp-server-madeonsol
+```
+
+Add to `claude_desktop_config.json` or Cursor MCP settings (free key: https://madeonsol.com/developer):
+
+```json
+{ "mcpServers": { "madeonsol": { "command": "mcp-server-madeonsol", "env": { "MADEONSOL_API_KEY": "msk_..." } } } }
+```
+
+Restart Claude Desktop and ask: *"What are KOLs buying right now?"*
+
 ## Authentication
 
 Two options (in priority order):
@@ -53,26 +67,27 @@ Add to MCP settings with the same command and env vars.
 | Tool | Description |
 |---|---|
 | `madeonsol_kol_feed` | Real-time KOL trade feed (1,000+ wallets) |
-| `madeonsol_kol_coordination` | Multi-KOL convergence signals — tokens multiple KOLs are accumulating |
+| `madeonsol_kol_coordination` | Multi-KOL convergence signals (v1.1) — peak-density window, exit detection, 0-100 score |
+| `madeonsol_kol_first_touches` | First-KOL-touch events — backtested scout signal. Filter by scout tier, winrate, token age, mint suffix |
 | `madeonsol_kol_leaderboard` | KOL PnL and win rate rankings (180 days of history; periods: today, 7d, 30d, 90d, 180d) |
 | `madeonsol_kol_pairs` | KOL affinity matrix — which KOLs co-trade the same tokens |
 | `madeonsol_kol_hot_tokens` | KOL momentum tokens — accelerating buy interest |
-| `madeonsol_kol_trending_tokens` | Tokens ranked by KOL buy volume (5m–12h windows). Sub-hour periods PRO/ULTRA only. |
-| `madeonsol_kol_pnl` | Deep per-wallet PnL: equity curve, risk metrics, closed + open positions. BASIC=summary, PRO=+curve+closed, ULTRA=+open. |
-| `madeonsol_kol_timing` | KOL entry/exit timing profile — PRO/ULTRA |
+| `madeonsol_kol_trending_tokens` | Tokens ranked by KOL buy volume (5m–12h windows). ULTRA adds full KOL wallet addresses. |
+| `madeonsol_kol_pnl` | Deep per-wallet PnL: equity curve, risk metrics, closed positions. ULTRA adds open positions (tokens bought but not yet sold). |
+| `madeonsol_kol_timing` | KOL entry/exit timing profile — available on all tiers |
 
 ### Deployer Hunter
 
 | Tool | Description |
 |---|---|
-| `madeonsol_deployer_alerts` | Pump.fun deployer launches with KOL enrichment. PRO/ULTRA: filter by tier (elite/good/moderate/rising/cold). |
-| `madeonsol_deployer_trajectory` | Deployer skill curve — streaks, rolling bond rate, trend — PRO/ULTRA |
+| `madeonsol_deployer_alerts` | Pump.fun deployer launches with KOL enrichment. Filter by tier (elite/good/moderate/rising/cold). ULTRA unlocks full pagination. |
+| `madeonsol_deployer_trajectory` | Deployer skill curve — streaks, rolling bond rate, trend — available on all tiers |
 
 ### Wallet Tracker
 
 | Tool | Description |
 |---|---|
-| `madeonsol_wallet_tracker_watchlist` | List your tracked wallets and remaining capacity (BASIC: 10, PRO: 50, ULTRA: 100) |
+| `madeonsol_wallet_tracker_watchlist` | List your tracked wallets and remaining capacity (Free: 10, Pro: 50, Ultra: 100) |
 | `madeonsol_wallet_tracker_add` | Add a wallet to your watchlist |
 | `madeonsol_wallet_tracker_remove` | Remove a wallet from your watchlist |
 | `madeonsol_wallet_tracker_trades` | Historical swap/transfer events for watched wallets (120-day retention) |
@@ -84,7 +99,7 @@ Scored from 47,000+ early-buyer records (wallets seen in the first 20 buyers of
 
 | Tool | Tier | Description |
 |---|---|---|
-| `madeonsol_alpha_leaderboard` | BASIC+ | Top profitable early-buyer wallets. BASIC=25 (truncated), PRO=100, ULTRA=500 + bot signals |
+| `madeonsol_alpha_leaderboard` | All | Top profitable early-buyer wallets. Up to 100 on Free/Pro; ULTRA unlocks 500 + bot signals |
 | `madeonsol_alpha_wallet` | ULTRA | Full per-token breakdown + bot_signals array |
 | `madeonsol_alpha_linked` | ULTRA | Wallets behaviorally linked (co-bought 3+ tokens within 2s) |
 
@@ -93,7 +108,7 @@ Scored from 47,000+ early-buyer records (wallets seen in the first 20 buyers of
 | Tool | Tier | Description |
 |---|---|---|
 | `madeonsol_token_cap_table` | PRO+ | First non-deployer early buyers, enriched with PnL/KOL/bot flags. PRO=10, ULTRA=20 |
-| `madeonsol_token_buyer_quality` | BASIC+ | 0–100 buyer-quality score (5-min cached). BASIC=score+signal only |
+| `madeonsol_token_buyer_quality` | All | 0–100 buyer-quality score + full breakdown (5-min cached) |
 
 ### Copy-Trade Rules (PRO/ULTRA)
 
@@ -108,6 +123,35 @@ Server-side rules that fire signals when a watched source wallet trades. Deliver
 | `madeonsol_copytrade_delete` | Delete permanently |
 | `madeonsol_copytrade_signals` | Recent fired signals (up to 7 days) |
 
+### KOL Coordination Alerts (PRO/ULTRA — v1.1 push signals)
+
+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.
+
+| Tool | Description |
+|---|---|
+| `madeonsol_coordination_alerts_list` | List your rules (PRO=5, ULTRA=20) |
+| `madeonsol_coordination_alerts_create` | Create a rule. Returns `webhook_secret` once — store it |
+| `madeonsol_coordination_alerts_get` | Get one rule |
+| `madeonsol_coordination_alerts_update` | Update fields or toggle `is_active` |
+| `madeonsol_coordination_alerts_delete` | Delete permanently |
+
+### KOL Scout Signal — first KOL touches *(new in 1.3)*
+
+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.
+
+**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).
+
+| Tool | Description |
+|---|---|
+| `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. |
+| `madeonsol_first_touch_subscriptions_list` | List your first-touch webhook subscriptions — ULTRA |
+| `madeonsol_first_touch_subscriptions_create` | Create a webhook rule (HMAC-signed). Returns `webhook_secret` once — store it. Up to 10/user — ULTRA |
+| `madeonsol_first_touch_subscriptions_get` | Get one subscription — ULTRA |
+| `madeonsol_first_touch_subscriptions_update` | Update fields or toggle `is_active` — ULTRA |
+| `madeonsol_first_touch_subscriptions_delete` | Delete permanently — ULTRA |
+
+> **Don't poll — push.** Median lead time before the second KOL is 12 seconds. WebSocket channel: `kol:first_touches` (PRO+).
+
 ### Streaming & Webhooks
 
 | Tool | Description |
@@ -128,17 +172,18 @@ Server-side rules that fire signals when a watched source wallet trades. Deliver
 
 | Tier | Price | Wallets tracked | Requests/day |
 |------|-------|-----------------|--------------|
-| BASIC | Free | 10 | 200 |
-| PRO | $49/mo | 50 | 10,000 |
-| ULTRA | $149/mo | 100 + WS events | 100,000 |
+| Free | $0 | 10 | 200 |
+| Pro | $49/mo | 50 | 10,000 |
+| Ultra | $149/mo | 100 + WS events | 100,000 |
 
-Get a key at [madeonsol.com/developer](https://madeonsol.com/developer).
+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).
 
 ## Also Available
 
 | Platform | Package |
 |---|---|
 | TypeScript SDK | [`madeonsol`](https://www.npmjs.com/package/madeonsol) on npm |
+| Rust SDK | [`madeonsol`](https://crates.io/crates/madeonsol) on crates.io |
 | Python (LangChain, CrewAI) | [`madeonsol-x402`](https://pypi.org/project/madeonsol-x402/) on PyPI |
 | ElizaOS | [`@madeonsol/plugin-madeonsol`](https://www.npmjs.com/package/@madeonsol/plugin-madeonsol) |
 | Solana Agent Kit | [`solana-agent-kit-plugin-madeonsol`](https://www.npmjs.com/package/solana-agent-kit-plugin-madeonsol) |

package/dist/index.js

@@ -100,7 +100,7 @@ function registerTools(server) {
             params.strategy = strategy;
         return { content: [{ type: "text", text: await query("/api/x402/kol/feed", params) }] };
     });
-    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.", {
+    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.", {
         period: z.enum(["1h", "6h", "24h", "7d"]).default("24h").describe("Time period for coordination analysis"),
         min_kols: z.number().min(2).max(50).default(3).describe("Minimum number of KOLs converging on the same token"),
         limit: z.number().min(1).max(50).default(20).describe("Number of coordination signals to return"),
@@ -123,7 +123,7 @@ function registerTools(server) {
             params.min_score = min_score;
         return { content: [{ type: "text", text: await query("/api/x402/kol/coordination", params) }] };
     });
-    server.tool("madeonsol_kol_leaderboard", "Get KOL performance rankings by PnL and win rate. PRO+ can sort by alternative axes (winrate/roi/profit_factor/early_entry).", {
+    server.tool("madeonsol_kol_leaderboard", "Get KOL performance rankings by PnL and win rate. Each row includes avg_entry_mc_usd + entry_mc_samples (added 2026-05-06) — average market cap at the moment of each buy in the period, surfacing micro-cap vs mid-cap trader profile. PRO+ can sort by alternative axes (winrate/roi/profit_factor/early_entry).", {
         period: z.enum(["today", "7d", "30d", "90d", "180d"]).default("7d").describe("Time period (trade retention is 180d)"),
         limit: z.number().min(1).max(50).default(20).describe("Number of KOLs to return in ranking"),
         sort: z.enum(["pnl", "winrate", "profit_factor", "roi", "early_entry"]).optional().describe("PRO+: sort axis (default 'pnl')"),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-server-madeonsol",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "mcpName": "io.github.lambopoewert/madeonsol",
   "description": "MCP server for MadeOnSol Solana KOL intelligence API — use from Claude, Cursor, or any MCP client",
   "type": "module",