mcp-server-madeonsol 0.8.0 → 0.9.0

package/README.md

@@ -2,16 +2,15 @@
 
 MCP server for [MadeOnSol](https://madeonsol.com) Solana KOL intelligence API. Use from Claude Desktop, Cursor, or any MCP-compatible client.
 
-> 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, and stream every DEX trade. Free tier: 200 requests/day at [madeonsol.com/developer](https://madeonsol.com/developer) — no credit card required.
+> 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.
 
 ## Authentication
 
-Three options (in priority order):
+Two options (in priority order):
 
 | Method | Env var | Best for |
 |---|---|---|
 | **MadeOnSol API key** (recommended) | `MADEONSOL_API_KEY` | Developers — [get a free key](https://madeonsol.com/developer) |
-| RapidAPI key | `RAPIDAPI_KEY` | RapidAPI subscribers |
 | x402 micropayments | `SVM_PRIVATE_KEY` | AI agents with Solana wallets |
 
 ## Install
@@ -47,29 +46,68 @@ Add to MCP settings with the same command and env vars.
 
 ## Tools
 
+### KOL Intelligence
+
 | Tool | Description |
 |---|---|
 | `madeonsol_kol_feed` | Real-time KOL trade feed (1,000+ wallets) |
-| `madeonsol_kol_coordination` | Multi-KOL convergence signals |
-| `madeonsol_kol_leaderboard` | KOL PnL and win rate rankings (180 days of trade history; periods: today, 7d, 30d, 90d, 180d) |
-| `madeonsol_deployer_alerts` | Pump.fun deployer launches. PRO/ULTRA: filter by deployer tier (elite/good/moderate/rising/cold). |
-| `madeonsol_token_info` | Token intelligence — price, market cap, volume, deployer, KOL activity |
-| `madeonsol_api_status` | System health — service status and uptime (no auth required) |
-| `madeonsol_discovery` | List all endpoints and prices (free) |
+| `madeonsol_kol_coordination` | Multi-KOL convergence signals — tokens multiple KOLs are accumulating |
+| `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 |
+
+### 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 |
+
+### Wallet Tracker
+
+| Tool | Description |
+|---|---|
+| `madeonsol_wallet_tracker_watchlist` | List your tracked wallets and remaining capacity (BASIC: 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) |
+| `madeonsol_wallet_tracker_summary` | Per-wallet stats: swap counts, SOL bought/sold, last event |
+
+### Streaming & Webhooks
+
+| Tool | Description |
+|---|---|
+| `madeonsol_stream_token` | Get a 24h WebSocket token for KOL/deployer streaming and DEX trade stream — PRO/ULTRA |
+| `madeonsol_create_webhook` | Register a webhook for real-time push notifications — PRO/ULTRA |
+| `madeonsol_list_webhooks` | List your registered webhooks — PRO/ULTRA |
+| `madeonsol_delete_webhook` | Delete a webhook by ID — PRO/ULTRA |
+| `madeonsol_test_webhook` | Send a test payload to verify a webhook — PRO/ULTRA |
 
-**With Pro/Ultra subscription:**
+### General
 
 | Tool | Description |
 |---|---|
-| `madeonsol_stream_token` | Get 24h WebSocket token for KOL/deployer streaming and DEX trade stream |
-| Webhook CRUD tools | Create, list, update, delete, test webhooks |
+| `madeonsol_discovery` | List all endpoints and prices (free, no auth) |
+
+## Tiers
+
+| Tier | Price | Wallets tracked | Requests/day |
+|------|-------|-----------------|--------------|
+| BASIC | Free | 10 | 200 |
+| PRO | $49/mo | 50 | 10,000 |
+| ULTRA | $199/mo | 100 + WS events | 100,000 |
+
+Get a key at [madeonsol.com/developer](https://madeonsol.com/developer).
 
 ## Also Available
 
 | Platform | Package |
 |---|---|
-| TypeScript SDK | [`madeonsol-x402`](https://www.npmjs.com/package/madeonsol-x402) |
-| Python (LangChain, CrewAI) | [`madeonsol-x402`](https://github.com/LamboPoewert/madeonsol-python) on PyPI |
+| TypeScript SDK | [`madeonsol`](https://www.npmjs.com/package/madeonsol) on npm |
+| 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

@@ -80,31 +80,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"),
@@ -150,13 +182,44 @@ function registerTools(server) {
         }
         return { content: [{ type: "text", text: "Deployer trajectory requires API key or RapidAPI key auth (Pro/Ultra)." }] };
     });
-    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"),
@@ -368,6 +431,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." },

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "mcp-server-madeonsol",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "mcpName": "io.github.lambopoewert/madeonsol",
-  "description": "MCP server for MadeOnSol Solana KOL intelligence API \u00e2\u20ac\u201d use from Claude, Cursor, or any MCP client",
+  "description": "MCP server for MadeOnSol Solana KOL intelligence API — use from Claude, Cursor, or any MCP client",
   "type": "module",
   "bin": {
     "mcp-server-madeonsol": "dist/index.js"