mcp-server-madeonsol 1.0.1 → 1.1.1

package/README.md

@@ -67,26 +67,26 @@ 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_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) |
@@ -98,7 +98,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) |
 
@@ -107,7 +107,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)
 
@@ -122,6 +122,18 @@ 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 |
+
 ### Streaming & Webhooks
 
 | Tool | Description |
@@ -142,11 +154,11 @@ 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
 

package/dist/index.js

@@ -97,18 +97,27 @@ function registerTools(server) {
             params.strategy = strategy;
         return { content: [{ type: "text", text: await query("/api/x402/kol/feed", params) }] };
     });
-    server.tool("madeonsol_kol_coordination", "Get KOL convergence signals — tokens being accumulated by multiple KOLs simultaneously. PRO+ adds cluster quality filters.", {
+    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.", {
         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"),
         min_avg_winrate: z.number().optional().describe("PRO+: require cluster avg winrate_7d >= N (0-100)"),
         unique_strategies: z.number().optional().describe("PRO+: require >= N distinct strategies in cluster"),
-    }, readOnlyAnnotations, async ({ period, min_kols, limit, min_avg_winrate, unique_strategies }) => {
+        include_majors: z.boolean().optional().describe("v1.1: include major memecoins (WIF/BONK/POPCAT). Default false."),
+        window_minutes: z.number().min(1).max(60).optional().describe("v1.1: peak-density window (1-60). Default 15."),
+        min_score: z.number().min(0).max(100).optional().describe("v1.1: minimum composite coordination_score (0-100)."),
+    }, readOnlyAnnotations, async ({ period, min_kols, limit, min_avg_winrate, unique_strategies, include_majors, window_minutes, min_score }) => {
         const params = { period, min_kols, limit };
         if (min_avg_winrate !== undefined)
             params.min_avg_winrate = min_avg_winrate;
         if (unique_strategies !== undefined)
             params.unique_strategies = unique_strategies;
+        if (include_majors !== undefined)
+            params.include_majors = include_majors ? "true" : "false";
+        if (window_minutes !== undefined)
+            params.window_minutes = window_minutes;
+        if (min_score !== undefined)
+            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).", {
@@ -451,6 +460,52 @@ function registerTools(server) {
             const text = res.ok ? JSON.stringify(await res.json(), null, 2) : `Error ${res.status}: ${await res.text().catch(() => "")}`;
             return { content: [{ type: "text", text }] };
         });
+        // ── Coordination alerts (PRO/ULTRA, v1.1) ──
+        server.tool("madeonsol_coordination_alerts_list", "List your coordination alert rules. PRO=5 rules, ULTRA=20.", {}, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async () => ({
+            content: [{ type: "text", text: await restQuery("GET", "/kol/coordination/alerts") }],
+        }));
+        server.tool("madeonsol_coordination_alerts_create", "Create a coordination alert rule. Fires within ~1s when a KOL cluster meets thresholds (peak-density scored). Delivered via WebSocket (kol:coordination channel) and/or HMAC-signed webhook. Returns webhook_secret ONCE when delivery_mode includes 'webhook' — store it.", {
+            name: z.string().optional().describe("Optional label"),
+            min_kols: z.number().min(2).max(50).optional().describe("Minimum distinct KOLs in the window (default 3)"),
+            window_minutes: z.number().min(1).max(60).optional().describe("Peak-density window size in minutes (default 15)"),
+            min_score: z.number().min(0).max(100).optional().describe("Minimum composite score 0-100 (default 60)"),
+            include_majors: z.boolean().optional().describe("Include WIF/BONK/POPCAT etc. Default false."),
+            cooldown_min: z.number().min(1).optional().describe("Silence per (rule, token) in minutes (default 60)"),
+            score_jump_break: z.number().min(1).max(100).optional().describe("Re-fire early when score jumps by N points vs last fire (default 10)"),
+            delivery_mode: z.enum(["websocket", "webhook", "both"]).optional().describe("Where to deliver fires"),
+            webhook_url: z.string().url().optional().describe("Required when delivery_mode includes 'webhook'"),
+        }, { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }, async (args) => {
+            const body = {};
+            for (const [k, v] of Object.entries(args))
+                if (v !== undefined)
+                    body[k] = v;
+            return { content: [{ type: "text", text: await restQuery("POST", "/kol/coordination/alerts", body) }] };
+        });
+        server.tool("madeonsol_coordination_alerts_get", "Get one coordination alert rule by id.", { id: z.string().describe("Rule UUID") }, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async ({ id }) => ({
+            content: [{ type: "text", text: await restQuery("GET", `/kol/coordination/alerts/${encodeURIComponent(id)}`) }],
+        }));
+        server.tool("madeonsol_coordination_alerts_update", "Update fields on a coordination alert rule, including is_active toggle.", {
+            id: z.string().describe("Rule UUID"),
+            name: z.string().nullable().optional(),
+            min_kols: z.number().min(2).max(50).optional(),
+            window_minutes: z.number().min(1).max(60).optional(),
+            min_score: z.number().min(0).max(100).optional(),
+            include_majors: z.boolean().optional(),
+            cooldown_min: z.number().min(1).optional(),
+            score_jump_break: z.number().min(1).max(100).optional(),
+            delivery_mode: z.enum(["websocket", "webhook", "both"]).optional(),
+            webhook_url: z.string().url().nullable().optional(),
+            is_active: z.boolean().optional(),
+        }, { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }, async ({ id, ...patch }) => {
+            const body = {};
+            for (const [k, v] of Object.entries(patch))
+                if (v !== undefined)
+                    body[k] = v;
+            return { content: [{ type: "text", text: await restQuery("PATCH", `/kol/coordination/alerts/${encodeURIComponent(id)}`, body) }] };
+        });
+        server.tool("madeonsol_coordination_alerts_delete", "Delete a coordination alert rule permanently.", { id: z.string().describe("Rule UUID") }, { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: true }, async ({ id }) => ({
+            content: [{ type: "text", text: await restQuery("DELETE", `/kol/coordination/alerts/${encodeURIComponent(id)}`) }],
+        }));
         console.error("[madeonsol-mcp] Webhook & streaming tools enabled");
     }
     else {
@@ -495,7 +550,7 @@ async function main() {
                 res.end(JSON.stringify({
                     name: "madeonsol",
                     description: "Solana KOL trading intelligence and deployer analytics. Real-time data from 1,000+ KOL wallets, 6,700+ Pump.fun deployers, 47,000+ scored alpha wallets, copy-trade rules, and wallet tracker. Supports MadeOnSol API key (msk_) or x402 micropayments.",
-                    version: "1.0.0",
+                    version: "1.1.0",
                     tools: [
                         { name: "madeonsol_kol_feed", description: "Get real-time Solana KOL trades from 1,000+ tracked wallets." },
                         { name: "madeonsol_kol_coordination", description: "Get KOL convergence signals — tokens multiple KOLs are accumulating." },
@@ -532,6 +587,11 @@ async function main() {
                         { name: "madeonsol_copytrade_update", description: "Update a copy-trade rule. PRO/ULTRA." },
                         { name: "madeonsol_copytrade_delete", description: "Delete a copy-trade rule. PRO/ULTRA." },
                         { name: "madeonsol_copytrade_signals", description: "Recent fired copy-trade signals (up to 7 days). PRO/ULTRA." },
+                        { name: "madeonsol_coordination_alerts_list", description: "List your KOL coordination alert rules. PRO/ULTRA." },
+                        { name: "madeonsol_coordination_alerts_create", description: "Create a coordination alert rule (push via WS + webhook, <1s latency). PRO/ULTRA." },
+                        { name: "madeonsol_coordination_alerts_get", description: "Get one coordination alert rule. PRO/ULTRA." },
+                        { name: "madeonsol_coordination_alerts_update", description: "Update fields on a coordination alert rule. PRO/ULTRA." },
+                        { name: "madeonsol_coordination_alerts_delete", description: "Delete a coordination alert rule. PRO/ULTRA." },
                     ],
                     homepage: "https://madeonsol.com/solana-api",
                     repository: "https://github.com/LamboPoewert/mcp-server-madeonsol",
@@ -547,7 +607,7 @@ async function main() {
                         transport = new StreamableHTTPServerTransport({
                             sessionIdGenerator: undefined,
                         });
-                        const server = new McpServer({ name: "madeonsol", version: "1.0.0" });
+                        const server = new McpServer({ name: "madeonsol", version: "1.1.0" });
                         registerTools(server);
                         await server.connect(transport);
                     }
@@ -585,7 +645,7 @@ async function main() {
     }
     else {
         // Stdio transport for local use (Claude Desktop, Cursor, Claude Code)
-        const server = new McpServer({ name: "madeonsol", version: "1.0.0" });
+        const server = new McpServer({ name: "madeonsol", version: "1.1.0" });
         registerTools(server);
         const transport = new StdioServerTransport();
         await server.connect(transport);

package/package.json

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