mcp-server-madeonsol 0.8.1 → 1.0.0

package/README.md

@@ -13,6 +13,8 @@ Two options (in priority order):
 | **MadeOnSol API key** (recommended) | `MADEONSOL_API_KEY` | Developers — [get a free key](https://madeonsol.com/developer) |
 | x402 micropayments | `SVM_PRIVATE_KEY` | AI agents with Solana wallets |
 
+> **v1.0 breaking change:** RapidAPI auth (`RAPIDAPI_KEY`) has been removed. The MadeOnSol RapidAPI marketplace was retired on 2026-04-19. Get a free `msk_` key at [madeonsol.com/developer](https://madeonsol.com/developer).
+
 ## Install
 
 ```bash
@@ -76,6 +78,36 @@ Add to MCP settings with the same command and env vars.
 | `madeonsol_wallet_tracker_trades` | Historical swap/transfer events for watched wallets (120-day retention) |
 | `madeonsol_wallet_tracker_summary` | Per-wallet stats: swap counts, SOL bought/sold, last event |
 
+### Alpha Wallet Intelligence
+
+Scored from 47,000+ early-buyer records (wallets seen in the first 20 buyers of Pump.fun tokens).
+
+| Tool | Tier | Description |
+|---|---|---|
+| `madeonsol_alpha_leaderboard` | BASIC+ | Top profitable early-buyer wallets. BASIC=25 (truncated), PRO=100, ULTRA=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) |
+
+### Token Quality
+
+| 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 |
+
+### Copy-Trade Rules (PRO/ULTRA)
+
+Server-side rules that fire signals when a watched source wallet trades. Delivered via webhook (HMAC-signed) and/or WebSocket.
+
+| Tool | Description |
+|---|---|
+| `madeonsol_copytrade_list` | List your rules |
+| `madeonsol_copytrade_create` | Create a rule. Returns `webhook_secret` once — store it |
+| `madeonsol_copytrade_get` | Get one rule |
+| `madeonsol_copytrade_update` | Update fields or toggle `is_active` |
+| `madeonsol_copytrade_delete` | Delete permanently |
+| `madeonsol_copytrade_signals` | Recent fired signals (up to 7 days) |
+
 ### Streaming & Webhooks
 
 | Tool | Description |

package/dist/index.js

@@ -6,7 +6,6 @@ import { z } from "zod";
 import { createServer } from "node:http";
 const BASE_URL = process.env.MADEONSOL_API_URL || "https://madeonsol.com";
 const MADEONSOL_API_KEY = process.env.MADEONSOL_API_KEY; // Native key from madeonsol.com/developer
-const RAPIDAPI_KEY = process.env.RAPIDAPI_KEY; // RapidAPI subscription key
 const PRIVATE_KEY = process.env.SVM_PRIVATE_KEY; // x402 micropayments (for AI agents)
 const PORT = parseInt(process.env.PORT || "3100", 10);
 const MODE = process.env.MCP_TRANSPORT || "stdio"; // "stdio" or "http"
@@ -16,12 +15,6 @@ function apiKeyHeaders() {
     if (authMode === "madeonsol") {
         return { Authorization: `Bearer ${MADEONSOL_API_KEY}` };
     }
-    if (authMode === "rapidapi") {
-        return {
-            "x-rapidapi-key": RAPIDAPI_KEY,
-            "x-rapidapi-host": "madeonsol-solana-kol-tracker-tools-api.p.rapidapi.com",
-        };
-    }
     return {};
 }
 async function initAuth() {
@@ -30,11 +23,6 @@ async function initAuth() {
         console.error("[madeonsol-mcp] Using MadeOnSol API key (Bearer auth)");
         return;
     }
-    if (RAPIDAPI_KEY) {
-        authMode = "rapidapi";
-        console.error("[madeonsol-mcp] Using RapidAPI key");
-        return;
-    }
     if (PRIVATE_KEY) {
         try {
             const { wrapFetchWithPayment } = await import("@x402/fetch");
@@ -54,10 +42,10 @@ async function initAuth() {
             console.error("[madeonsol-mcp] x402 setup failed:", err);
         }
     }
-    console.error("[madeonsol-mcp] No auth configured. Set MADEONSOL_API_KEY (get one free at madeonsol.com/developer), RAPIDAPI_KEY, or SVM_PRIVATE_KEY.");
+    console.error("[madeonsol-mcp] No auth configured. Set MADEONSOL_API_KEY (get one free at madeonsol.com/developer) or SVM_PRIVATE_KEY.");
 }
 async function query(path, params) {
-    // API key and RapidAPI auth use /api/v1/ endpoints; x402 uses /api/x402/
+    // API key uses /api/v1/ endpoints; x402 uses /api/x402/
     const apiPath = authMode === "x402" || authMode === "none"
         ? path
         : path.replace("/api/x402/", "/api/v1/");
@@ -80,31 +68,63 @@ async function query(path, params) {
 }
 function registerTools(server) {
     const readOnlyAnnotations = { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true };
-    server.tool("madeonsol_kol_feed", "Get real-time Solana KOL trades from 1,000+ tracked wallets.", {
+    server.tool("madeonsol_kol_feed", "Get real-time Solana KOL trades from 1,000+ tracked wallets. PRO+ adds size/age/strategy/winrate filters.", {
         limit: z.number().min(1).max(100).default(10).describe("Number of trades to return (1-100)"),
         action: z.enum(["buy", "sell"]).optional().describe("Filter by trade type: buy or sell"),
         kol: z.string().optional().describe("Filter by specific KOL wallet address (base58)"),
-    }, readOnlyAnnotations, async ({ limit, action, kol }) => {
+        min_sol: z.number().optional().describe("PRO+: minimum SOL size per trade"),
+        token_age_max_min: z.number().optional().describe("PRO+: max token age in minutes at time of trade"),
+        exclude_sells: z.boolean().optional().describe("PRO+: drop sell-side trades"),
+        min_kol_winrate: z.number().optional().describe("PRO+: minimum 7d winrate of the KOL (0-100)"),
+        strategy: z.enum(["sniper", "flipper", "swinger", "holder", "mixed"]).optional().describe("PRO+: filter by auto-tagged strategy"),
+    }, readOnlyAnnotations, async ({ limit, action, kol, min_sol, token_age_max_min, exclude_sells, min_kol_winrate, strategy }) => {
         const params = { limit };
         if (action)
             params.action = action;
         if (kol)
             params.kol = kol;
+        if (min_sol !== undefined)
+            params.min_sol = min_sol;
+        if (token_age_max_min !== undefined)
+            params.token_age_max_min = token_age_max_min;
+        if (exclude_sells)
+            params.exclude_sells = "true";
+        if (min_kol_winrate !== undefined)
+            params.min_kol_winrate = min_kol_winrate;
+        if (strategy)
+            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.", {
+    server.tool("madeonsol_kol_coordination", "Get KOL convergence signals — tokens being accumulated by multiple KOLs simultaneously. PRO+ adds cluster quality filters.", {
         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"),
-    }, readOnlyAnnotations, async ({ period, min_kols, limit }) => ({
-        content: [{ type: "text", text: await query("/api/x402/kol/coordination", { period, min_kols, limit }) }],
-    }));
-    server.tool("madeonsol_kol_leaderboard", "Get KOL performance rankings by PnL and win rate.", {
-        period: z.enum(["today", "7d", "30d"]).default("7d").describe("Time period for leaderboard: today, 7d, or 30d"),
+        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 }) => {
+        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;
+        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).", {
+        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"),
-    }, readOnlyAnnotations, async ({ period, limit }) => ({
-        content: [{ type: "text", text: await query("/api/x402/kol/leaderboard", { period, limit }) }],
-    }));
+        sort: z.enum(["pnl", "winrate", "profit_factor", "roi", "early_entry"]).optional().describe("PRO+: sort axis (default 'pnl')"),
+        strategy: z.enum(["sniper", "flipper", "swinger", "holder", "mixed"]).optional().describe("PRO+: filter by strategy tag"),
+        min_winrate: z.number().optional().describe("PRO+: minimum winrate cutoff (0-100)"),
+    }, readOnlyAnnotations, async ({ period, limit, sort, strategy, min_winrate }) => {
+        const params = { period, limit };
+        if (sort)
+            params.sort = sort;
+        if (strategy)
+            params.strategy = strategy;
+        if (min_winrate !== undefined)
+            params.min_winrate = min_winrate;
+        return { content: [{ type: "text", text: await query("/api/x402/kol/leaderboard", params) }] };
+    });
     server.tool("madeonsol_deployer_alerts", "Get real-time alerts from Pump.fun deployers with KOL buy enrichment. PRO/ULTRA subscribers can filter by deployer tier (elite/good/moderate/rising/cold).", {
         limit: z.number().min(1).max(100).default(10).describe("Number of deployer alerts to return (1-100)"),
         offset: z.number().min(0).default(0).describe("Pagination offset for deployer alerts"),
@@ -123,8 +143,7 @@ function registerTools(server) {
         wallet: z.string().describe("KOL wallet address (base58)"),
         period: z.enum(["7d", "30d"]).default("30d").describe("Time period: 7d or 30d"),
     }, readOnlyAnnotations, async ({ wallet, period }) => {
-        const hasRestAuth = authMode === "madeonsol" || authMode === "rapidapi";
-        if (hasRestAuth) {
+        if (authMode === "madeonsol") {
             const headers = { ...apiKeyHeaders() };
             const res = await fetch(`${BASE_URL}/api/v1/kol/${wallet}/timing?period=${period}`, { headers });
             if (!res.ok) {
@@ -133,13 +152,12 @@ function registerTools(server) {
             }
             return { content: [{ type: "text", text: JSON.stringify(await res.json(), null, 2) }] };
         }
-        return { content: [{ type: "text", text: "KOL timing requires API key or RapidAPI key auth." }] };
+        return { content: [{ type: "text", text: "KOL timing requires MADEONSOL_API_KEY (msk_) — get one free at madeonsol.com/developer." }] };
     });
     server.tool("madeonsol_deployer_trajectory", "Deployer skill curve — streaks, rolling bond rate, improvement trend, and deployment cadence for a Pump.fun deployer.", {
         wallet: z.string().describe("Deployer wallet address (base58)"),
     }, readOnlyAnnotations, async ({ wallet }) => {
-        const hasRestAuth = authMode === "madeonsol" || authMode === "rapidapi";
-        if (hasRestAuth) {
+        if (authMode === "madeonsol") {
             const headers = { ...apiKeyHeaders() };
             const res = await fetch(`${BASE_URL}/api/v1/deployer-hunter/${wallet}/trajectory`, { headers });
             if (!res.ok) {
@@ -148,21 +166,51 @@ function registerTools(server) {
             }
             return { content: [{ type: "text", text: JSON.stringify(await res.json(), null, 2) }] };
         }
-        return { content: [{ type: "text", text: "Deployer trajectory requires API key or RapidAPI key auth (Pro/Ultra)." }] };
+        return { content: [{ type: "text", text: "Deployer trajectory requires MADEONSOL_API_KEY (msk_, Pro/Ultra) — get one at madeonsol.com/developer." }] };
     });
-    server.tool("madeonsol_kol_hot_tokens", "KOL momentum tokens — tokens with accelerating KOL buy interest, early signals before coordination triggers.", {
+    server.tool("madeonsol_kol_hot_tokens", "KOL momentum tokens — tokens with accelerating KOL buy interest, early signals before coordination triggers. PRO+ adds buyer-quality filters.", {
         period: z.enum(["1h", "6h"]).default("6h").describe("Time period: 1h or 6h"),
         min_kols: z.number().min(1).max(20).default(1).describe("Minimum KOL buyers to include a token"),
         limit: z.number().min(1).max(50).default(20).describe("Number of hot tokens to return"),
-    }, readOnlyAnnotations, async ({ period, min_kols, limit }) => ({
-        content: [{ type: "text", text: await query("/api/x402/kol/tokens/hot", { period, min_kols, limit }) }],
+        min_avg_winrate: z.number().optional().describe("PRO+: require avg winrate_7d of buyers >= N (0-100)"),
+        unique_strategies: z.number().optional().describe("PRO+: require >= N distinct strategies among buyers"),
+    }, readOnlyAnnotations, async ({ period, min_kols, limit, min_avg_winrate, unique_strategies }) => {
+        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;
+        return { content: [{ type: "text", text: await query("/api/x402/kol/tokens/hot", params) }] };
+    });
+    server.tool("madeonsol_kol_token_entry_order", "Ranked KOL first-buyers for a specific token, ordered by entry timestamp. PRO+ adds percentile_pnl_7d per entry.", {
+        mint: z.string().describe("Token mint address (base58)"),
+        limit: z.number().min(1).max(200).default(50).describe("Max ranked entries to return"),
+    }, readOnlyAnnotations, async ({ mint, limit }) => ({
+        content: [{ type: "text", text: await query(`/api/x402/kol/tokens/${encodeURIComponent(mint)}/entry-order`, { limit }) }],
     }));
+    server.tool("madeonsol_kol_compare_wallets", "Side-by-side comparison of 2-5 KOL wallets — strategy, winrates, ROI, percentile. PRO+ adds 30d overlap tokens (bought by 2+ of the wallets).", {
+        wallets: z.array(z.string()).min(2).max(5).describe("2-5 wallet addresses. BASIC=2, PRO=4, ULTRA=5."),
+    }, readOnlyAnnotations, async ({ wallets }) => ({
+        content: [{ type: "text", text: await query("/api/x402/kol/compare", { wallets: wallets.join(",") }) }],
+    }));
+    server.tool("madeonsol_kol_alerts_recent", "Live KOL alert feed — consensus clusters, fresh-token KOL buys, and heating-up wallets in one unified stream.", {
+        window: z.enum(["5m", "15m", "1h", "6h", "24h"]).default("15m").describe("Lookback window"),
+        types: z.array(z.enum(["consensus_cluster", "fresh_token_kol_buy", "heating_up"])).optional().describe("Filter to specific alert types"),
+        min_severity: z.enum(["low", "medium", "high"]).optional().describe("Minimum severity to include"),
+        limit: z.number().min(1).max(200).default(50).describe("Max alerts to return"),
+    }, readOnlyAnnotations, async ({ window, types, min_severity, limit }) => {
+        const params = { window, limit };
+        if (types && types.length > 0)
+            params.types = types.join(",");
+        if (min_severity)
+            params.min_severity = min_severity;
+        return { content: [{ type: "text", text: await query("/api/x402/kol/alerts/recent", params) }] };
+    });
     server.tool("madeonsol_kol_pnl", "Deep per-wallet PnL breakdown — realized PnL, win rate, profit factor, max drawdown, daily equity curve, closed/open positions. BASIC: summary only. PRO: + curve + closed. ULTRA: + open positions.", {
         wallet: z.string().describe("KOL wallet address (base58)"),
         period: z.enum(["7d", "30d", "90d", "180d"]).default("30d").describe("Time period for PnL calculation"),
     }, readOnlyAnnotations, async ({ wallet, period }) => {
-        const hasRestAuth = authMode === "madeonsol" || authMode === "rapidapi";
-        if (hasRestAuth) {
+        if (authMode === "madeonsol") {
             const headers = { ...apiKeyHeaders() };
             const res = await fetch(`${BASE_URL}/api/v1/kol/${wallet}/pnl?period=${period}`, { headers });
             if (!res.ok) {
@@ -171,7 +219,7 @@ function registerTools(server) {
             }
             return { content: [{ type: "text", text: JSON.stringify(await res.json(), null, 2) }] };
         }
-        return { content: [{ type: "text", text: "KOL PnL requires API key or RapidAPI key auth." }] };
+        return { content: [{ type: "text", text: "KOL PnL requires MADEONSOL_API_KEY (msk_) — get one free at madeonsol.com/developer." }] };
     });
     server.tool("madeonsol_kol_trending_tokens", "Tokens ranked by KOL buy volume — pure capital-flow signal. Sub-hour periods (5m/15m/30m) require PRO/ULTRA.", {
         period: z.enum(["5m", "15m", "30m", "1h", "2h", "4h", "12h"]).default("1h").describe("Time window"),
@@ -187,7 +235,7 @@ function registerTools(server) {
     });
     // ── Wallet Tracker tools (REST auth only — all mutating operations) ──
     {
-        const hasRestAuth = authMode === "madeonsol" || authMode === "rapidapi";
+        const hasRestAuth = authMode === "madeonsol";
         async function walletTrackerRequest(method, path, body) {
             const headers = { "Content-Type": "application/json", ...apiKeyHeaders() };
             const res = await fetch(`${BASE_URL}/api/v1${path}`, {
@@ -257,11 +305,11 @@ function registerTools(server) {
             console.error("[madeonsol-mcp] Wallet tracker tools enabled");
         }
         else {
-            console.error("[madeonsol-mcp] Wallet tracker tools disabled (requires MADEONSOL_API_KEY or RAPIDAPI_KEY)");
+            console.error("[madeonsol-mcp] Wallet tracker tools disabled (requires MADEONSOL_API_KEY)");
         }
     }
-    // ── Webhook & Streaming tools (require API key or RapidAPI key — Pro/Ultra tier) ──
-    const hasRestAuth = authMode === "madeonsol" || authMode === "rapidapi";
+    // ── Webhook & Streaming tools (require MadeOnSol API key — Pro/Ultra tier) ──
+    const hasRestAuth = authMode === "madeonsol";
     if (hasRestAuth) {
         async function restQuery(method, path, body) {
             const headers = {
@@ -312,10 +360,99 @@ function registerTools(server) {
         server.tool("madeonsol_stream_token", "Generate a 24h WebSocket streaming token. Includes ws_url for KOL/deployer streaming (Pro/Ultra) and dex_ws_url for all-DEX trade streaming (Ultra only).", {}, { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }, async () => ({
             content: [{ type: "text", text: await restQuery("POST", "/stream/token") }],
         }));
+        // ── Alpha wallet intelligence ──
+        server.tool("madeonsol_alpha_leaderboard", "Top statistically profitable early-buyer wallets, scored from 47,000+ early-buyer records. BASIC=25 (truncated), PRO=100, ULTRA=500 + bot signals.", {
+            period: z.enum(["7d", "30d", "all"]).default("30d").describe("Time window"),
+            min_tokens: z.number().min(1).max(20).default(5).describe("Minimum tokens traded by wallet (1-20)"),
+            sort: z.enum(["win_rate", "pnl", "roi"]).default("win_rate").describe("Sort axis"),
+            exclude_bots: z.boolean().default(true).describe("Exclude wallets flagged as bots"),
+        }, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async ({ period, min_tokens, sort, exclude_bots }) => {
+            const params = { period, min_tokens, sort, exclude_bots: exclude_bots ? "true" : "false" };
+            const url = new URL(`${BASE_URL}/api/v1/alpha/leaderboard`);
+            for (const [k, v] of Object.entries(params))
+                url.searchParams.set(k, String(v));
+            const res = await fetch(url.toString(), { headers: { "Content-Type": "application/json", ...apiKeyHeaders() } });
+            const text = res.ok ? JSON.stringify(await res.json(), null, 2) : `Error ${res.status}: ${await res.text().catch(() => "")}`;
+            return { content: [{ type: "text", text }] };
+        });
+        server.tool("madeonsol_alpha_wallet", "Full alpha profile for one wallet — per-token breakdown + bot_signals array. ULTRA only.", { wallet: z.string().describe("Wallet address (base58)") }, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async ({ wallet }) => ({
+            content: [{ type: "text", text: await restQuery("GET", `/alpha/${encodeURIComponent(wallet)}`) }],
+        }));
+        server.tool("madeonsol_alpha_linked", "Wallets behaviorally linked to a target wallet (co-bought 3+ tokens within 2 seconds). ULTRA only.", { wallet: z.string().describe("Wallet address (base58)") }, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async ({ wallet }) => ({
+            content: [{ type: "text", text: await restQuery("GET", `/alpha/${encodeURIComponent(wallet)}/linked`) }],
+        }));
+        // ── Token quality ──
+        server.tool("madeonsol_token_cap_table", "First non-deployer early buyers for a token, enriched with PnL, KOL identity, and bot flags. PRO=top 10 (truncated wallets), ULTRA=top 20 (full). BASIC: 403.", { mint: z.string().describe("Token mint address (base58)") }, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async ({ mint }) => ({
+            content: [{ type: "text", text: await restQuery("GET", `/tokens/${encodeURIComponent(mint)}/cap-table`) }],
+        }));
+        server.tool("madeonsol_token_buyer_quality", "0–100 buyer-quality score for a token's first-buyer cohort. 5-min cached. BASIC: score+signal only. PRO/ULTRA: full breakdown.", { mint: z.string().describe("Token mint address (base58)") }, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async ({ mint }) => ({
+            content: [{ type: "text", text: await restQuery("GET", `/tokens/${encodeURIComponent(mint)}/buyer-quality`) }],
+        }));
+        // ── Copy-Trade rules (PRO/ULTRA) ──
+        server.tool("madeonsol_copytrade_list", "List your copy-trade rules. PRO=3 rules, ULTRA=20 rules.", {}, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async () => ({
+            content: [{ type: "text", text: await restQuery("GET", "/copytrade/subscriptions") }],
+        }));
+        server.tool("madeonsol_copytrade_create", "Create a copy-trade rule. Returns webhook_secret ONCE on creation when delivery_mode includes 'webhook' — store it to verify HMAC signatures. PRO=5 source_wallets/rule, ULTRA=50.", {
+            source_wallets: z.array(z.string()).min(1).max(50).describe("Wallets to mirror (base58)"),
+            sizing_amount: z.number().describe("Amount used by the chosen sizing_mode"),
+            name: z.string().optional().describe("Optional human label"),
+            min_trade_sol: z.number().optional().describe("Minimum source-wallet trade size to fire a signal"),
+            only_action: z.enum(["buy", "sell", "both"]).optional().describe("Filter to one side (default 'both')"),
+            sizing_mode: z.enum(["fixed", "proportional", "percent_source"]).optional().describe("How sizing_amount is interpreted"),
+            delivery_mode: z.enum(["webhook", "websocket", "both"]).optional().describe("Where to deliver fired signals"),
+            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 = { source_wallets: args.source_wallets, sizing_amount: args.sizing_amount };
+            for (const k of ["name", "min_trade_sol", "only_action", "sizing_mode", "delivery_mode", "webhook_url"]) {
+                if (args[k] !== undefined)
+                    body[k] = args[k];
+            }
+            return { content: [{ type: "text", text: await restQuery("POST", "/copytrade/subscriptions", body) }] };
+        });
+        server.tool("madeonsol_copytrade_get", "Get one copy-trade rule by id.", { id: z.number().describe("Subscription id") }, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async ({ id }) => ({
+            content: [{ type: "text", text: await restQuery("GET", `/copytrade/subscriptions/${id}`) }],
+        }));
+        server.tool("madeonsol_copytrade_update", "Update fields on a copy-trade rule, including is_active toggle.", {
+            id: z.number().describe("Subscription id"),
+            name: z.string().nullable().optional(),
+            source_wallets: z.array(z.string()).optional(),
+            min_trade_sol: z.number().optional(),
+            only_action: z.enum(["buy", "sell", "both"]).optional(),
+            sizing_mode: z.enum(["fixed", "proportional", "percent_source"]).optional(),
+            sizing_amount: z.number().optional(),
+            delivery_mode: z.enum(["webhook", "websocket", "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", `/copytrade/subscriptions/${id}`, body) }] };
+        });
+        server.tool("madeonsol_copytrade_delete", "Delete a copy-trade rule permanently.", { id: z.number().describe("Subscription id") }, { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: true }, async ({ id }) => ({
+            content: [{ type: "text", text: await restQuery("DELETE", `/copytrade/subscriptions/${id}`) }],
+        }));
+        server.tool("madeonsol_copytrade_signals", "Recent fired copy-trade signals (up to 7 days). Filter by subscription_id, since (ISO8601), and limit (1–500).", {
+            subscription_id: z.number().optional().describe("Filter to one rule"),
+            since: z.string().optional().describe("ISO8601 timestamp — only signals fired at-or-after this time"),
+            limit: z.number().min(1).max(500).default(50).describe("Max signals to return (1–500)"),
+        }, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async ({ subscription_id, since, limit }) => {
+            const url = new URL(`${BASE_URL}/api/v1/copytrade/signals`);
+            url.searchParams.set("limit", String(limit));
+            if (subscription_id !== undefined)
+                url.searchParams.set("subscription_id", String(subscription_id));
+            if (since)
+                url.searchParams.set("since", since);
+            const res = await fetch(url.toString(), { headers: { "Content-Type": "application/json", ...apiKeyHeaders() } });
+            const text = res.ok ? JSON.stringify(await res.json(), null, 2) : `Error ${res.status}: ${await res.text().catch(() => "")}`;
+            return { content: [{ type: "text", text }] };
+        });
         console.error("[madeonsol-mcp] Webhook & streaming tools enabled");
     }
     else {
-        console.error("[madeonsol-mcp] Webhook/streaming tools disabled (requires MADEONSOL_API_KEY or RAPIDAPI_KEY)");
+        console.error("[madeonsol-mcp] Webhook/streaming tools disabled (requires MADEONSOL_API_KEY)");
     }
     // Prompts — pre-built analysis templates
     server.prompt("solana_kol_analysis", "Analyze current Solana KOL trading activity — what are smart money wallets buying and selling?", { period: z.string().default("24h").describe("Time period: 1h, 6h, 24h, or 7d") }, ({ period }) => ({
@@ -355,8 +492,8 @@ async function main() {
                 res.writeHead(200, { "Content-Type": "application/json" });
                 res.end(JSON.stringify({
                     name: "madeonsol",
-                    description: "Solana KOL trading intelligence and deployer analytics. Real-time data from 1,000+ KOL wallets and 4000+ Pump.fun deployers. Supports API key, RapidAPI, or x402 micropayments.",
-                    version: "0.1.0",
+                    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",
                     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." },
@@ -368,6 +505,9 @@ async function main() {
                         { name: "madeonsol_kol_hot_tokens", description: "KOL momentum tokens — accelerating buy interest." },
                         { name: "madeonsol_kol_pnl", description: "Deep per-wallet PnL: equity curve, risk metrics, positions." },
                         { name: "madeonsol_kol_trending_tokens", description: "Tokens ranked by KOL buy volume (5m–12h windows)." },
+                        { name: "madeonsol_kol_token_entry_order", description: "Ranked KOL first-buyers for a specific token." },
+                        { name: "madeonsol_kol_compare_wallets", description: "Side-by-side comparison of 2-5 KOL wallets (overlap in PRO+)." },
+                        { name: "madeonsol_kol_alerts_recent", description: "Unified live KOL alert feed: clusters, fresh buys, heating-up." },
                         { name: "madeonsol_discovery", description: "List all available endpoints with prices. Free." },
                         { name: "madeonsol_create_webhook", description: "Register a webhook for real-time push notifications. Pro/Ultra." },
                         { name: "madeonsol_list_webhooks", description: "List your registered webhooks. Pro/Ultra." },
@@ -379,6 +519,17 @@ async function main() {
                         { name: "madeonsol_wallet_tracker_remove", description: "Remove a wallet from your watchlist." },
                         { name: "madeonsol_wallet_tracker_trades", description: "Historical swap/transfer events for watched wallets." },
                         { name: "madeonsol_wallet_tracker_summary", description: "Per-wallet stats: swap counts, SOL bought/sold." },
+                        { name: "madeonsol_alpha_leaderboard", description: "Top profitable early-buyer wallets — 47,000+ scored. BASIC=25, PRO=100, ULTRA=500." },
+                        { name: "madeonsol_alpha_wallet", description: "Full alpha profile + bot signals for one wallet. ULTRA only." },
+                        { name: "madeonsol_alpha_linked", description: "Behaviorally linked wallets (co-bought 3+ tokens within 2s). ULTRA only." },
+                        { name: "madeonsol_token_cap_table", description: "First non-deployer early buyers for a token, enriched. PRO=10, ULTRA=20." },
+                        { name: "madeonsol_token_buyer_quality", description: "0–100 buyer quality score for a token's first-buyer cohort." },
+                        { name: "madeonsol_copytrade_list", description: "List your copy-trade rules. PRO/ULTRA." },
+                        { name: "madeonsol_copytrade_create", description: "Create a copy-trade rule with webhook + WS delivery. PRO/ULTRA." },
+                        { name: "madeonsol_copytrade_get", description: "Get one copy-trade rule. PRO/ULTRA." },
+                        { 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." },
                     ],
                     homepage: "https://madeonsol.com/solana-api",
                     repository: "https://github.com/LamboPoewert/mcp-server-madeonsol",
@@ -394,7 +545,7 @@ async function main() {
                         transport = new StreamableHTTPServerTransport({
                             sessionIdGenerator: undefined,
                         });
-                        const server = new McpServer({ name: "madeonsol", version: "0.1.0" });
+                        const server = new McpServer({ name: "madeonsol", version: "1.0.0" });
                         registerTools(server);
                         await server.connect(transport);
                     }
@@ -432,7 +583,7 @@ async function main() {
     }
     else {
         // Stdio transport for local use (Claude Desktop, Cursor, Claude Code)
-        const server = new McpServer({ name: "madeonsol", version: "0.1.0" });
+        const server = new McpServer({ name: "madeonsol", version: "1.0.0" });
         registerTools(server);
         const transport = new StdioServerTransport();
         await server.connect(transport);

package/glama.json

@@ -1,54 +1,49 @@
 {
   "name": "mcp-server-madeonsol",
   "display_name": "MadeOnSol",
-  "description": "Solana KOL trading intelligence and deployer analytics. Real-time data from 950+ KOL wallets and 6,700+ Pump.fun deployers. Supports free API key, RapidAPI, or x402 micropayments.",
-  "version": "0.3.0",
+  "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, server-side copy-trade rules, and wallet tracker. Supports free MadeOnSol API key (msk_) or x402 micropayments.",
+  "version": "1.0.0",
   "homepage": "https://madeonsol.com/solana-api",
   "repository": "https://github.com/LamboPoewert/mcp-server-madeonsol",
   "license": "MIT",
   "categories": ["blockchain", "finance", "web3"],
-  "tags": ["solana", "kol", "trading", "x402", "micropayments", "defi", "api", "deployer", "pump-fun"],
+  "tags": ["solana", "kol", "trading", "x402", "micropayments", "defi", "api", "deployer", "pump-fun", "copy-trade"],
   "tools": [
-    {
-      "name": "madeonsol_kol_feed",
-      "description": "Get real-time Solana KOL trades from 950+ tracked wallets."
-    },
-    {
-      "name": "madeonsol_kol_coordination",
-      "description": "Get KOL convergence signals — tokens multiple KOLs are accumulating."
-    },
-    {
-      "name": "madeonsol_kol_leaderboard",
-      "description": "Get KOL performance rankings by PnL and win rate."
-    },
-    {
-      "name": "madeonsol_deployer_alerts",
-      "description": "Get elite Pump.fun deployer alerts with KOL enrichment."
-    },
-    {
-      "name": "madeonsol_discovery",
-      "description": "List all available endpoints with prices. Free, no auth required."
-    },
-    {
-      "name": "madeonsol_create_webhook",
-      "description": "Register a webhook for real-time push notifications. Pro/Ultra."
-    },
-    {
-      "name": "madeonsol_list_webhooks",
-      "description": "List your registered webhooks. Pro/Ultra."
-    },
-    {
-      "name": "madeonsol_delete_webhook",
-      "description": "Delete a webhook by ID. Pro/Ultra."
-    },
-    {
-      "name": "madeonsol_test_webhook",
-      "description": "Send a test payload to verify a webhook. Pro/Ultra."
-    },
-    {
-      "name": "madeonsol_stream_token",
-      "description": "Get a 24h WebSocket streaming token. Pro/Ultra."
-    }
+    { "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." },
+    { "name": "madeonsol_kol_leaderboard", "description": "Get KOL performance rankings by PnL and win rate." },
+    { "name": "madeonsol_deployer_alerts", "description": "Get Pump.fun deployer alerts with KOL enrichment." },
+    { "name": "madeonsol_kol_pairs", "description": "KOL affinity matrix — which KOLs co-trade the same tokens." },
+    { "name": "madeonsol_kol_timing", "description": "KOL entry/exit timing profile. Pro/Ultra." },
+    { "name": "madeonsol_deployer_trajectory", "description": "Deployer skill curve — streaks, trend. Pro/Ultra." },
+    { "name": "madeonsol_kol_hot_tokens", "description": "KOL momentum tokens — accelerating buy interest." },
+    { "name": "madeonsol_kol_pnl", "description": "Deep per-wallet PnL: equity curve, risk metrics, positions." },
+    { "name": "madeonsol_kol_trending_tokens", "description": "Tokens ranked by KOL buy volume (5m–12h windows)." },
+    { "name": "madeonsol_kol_token_entry_order", "description": "Ranked KOL first-buyers for a specific token." },
+    { "name": "madeonsol_kol_compare_wallets", "description": "Side-by-side comparison of 2-5 KOL wallets (overlap in PRO+)." },
+    { "name": "madeonsol_kol_alerts_recent", "description": "Unified live KOL alert feed: clusters, fresh buys, heating-up." },
+    { "name": "madeonsol_discovery", "description": "List all available endpoints with prices. Free, no auth required." },
+    { "name": "madeonsol_create_webhook", "description": "Register a webhook for real-time push notifications. Pro/Ultra." },
+    { "name": "madeonsol_list_webhooks", "description": "List your registered webhooks. Pro/Ultra." },
+    { "name": "madeonsol_delete_webhook", "description": "Delete a webhook by ID. Pro/Ultra." },
+    { "name": "madeonsol_test_webhook", "description": "Send a test payload to verify a webhook. Pro/Ultra." },
+    { "name": "madeonsol_stream_token", "description": "Get a 24h WebSocket streaming token. Pro/Ultra." },
+    { "name": "madeonsol_wallet_tracker_watchlist", "description": "List your tracked wallets and remaining capacity." },
+    { "name": "madeonsol_wallet_tracker_add", "description": "Add a wallet to your watchlist." },
+    { "name": "madeonsol_wallet_tracker_remove", "description": "Remove a wallet from your watchlist." },
+    { "name": "madeonsol_wallet_tracker_trades", "description": "Historical swap/transfer events for watched wallets." },
+    { "name": "madeonsol_wallet_tracker_summary", "description": "Per-wallet stats: swap counts, SOL bought/sold." },
+    { "name": "madeonsol_alpha_leaderboard", "description": "Top profitable early-buyer wallets — 47,000+ scored. BASIC=25, PRO=100, ULTRA=500." },
+    { "name": "madeonsol_alpha_wallet", "description": "Full alpha profile + bot signals for one wallet. ULTRA only." },
+    { "name": "madeonsol_alpha_linked", "description": "Behaviorally linked wallets (co-bought 3+ tokens within 2s). ULTRA only." },
+    { "name": "madeonsol_token_cap_table", "description": "First non-deployer early buyers for a token, enriched. PRO=10, ULTRA=20." },
+    { "name": "madeonsol_token_buyer_quality", "description": "0–100 buyer quality score for a token's first-buyer cohort." },
+    { "name": "madeonsol_copytrade_list", "description": "List your copy-trade rules. PRO/ULTRA." },
+    { "name": "madeonsol_copytrade_create", "description": "Create a copy-trade rule with webhook + WS delivery. PRO/ULTRA." },
+    { "name": "madeonsol_copytrade_get", "description": "Get one copy-trade rule. PRO/ULTRA." },
+    { "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." }
   ],
   "transports": ["stdio", "http"],
   "runtime": "node"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-server-madeonsol",
-  "version": "0.8.1",
+  "version": "1.0.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",