mcp-server-madeonsol 0.3.3 → 0.5.0

package/README.md

@@ -51,8 +51,8 @@ Add to MCP settings with the same command and env vars.
 |---|---|
 | `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 |
-| `madeonsol_deployer_alerts` | Elite Pump.fun deployer launches |
+| `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) |

package/dist/index.js

@@ -80,7 +80,7 @@ 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 946 tracked wallets.", {
+    server.tool("madeonsol_kol_feed", "Get real-time Solana KOL trades from 1,000+ tracked wallets.", {
         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)"),
@@ -105,11 +105,12 @@ function registerTools(server) {
     }, readOnlyAnnotations, async ({ period, limit }) => ({
         content: [{ type: "text", text: await query("/api/x402/kol/leaderboard", { period, limit }) }],
     }));
-    server.tool("madeonsol_deployer_alerts", "Get real-time alerts from elite Pump.fun deployers with KOL buy enrichment.", {
+    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"),
-    }, readOnlyAnnotations, async ({ limit, offset }) => ({
-        content: [{ type: "text", text: await query("/api/x402/deployer-hunter/alerts", { limit, offset }) }],
+        tier: z.enum(["elite", "good", "moderate", "rising", "cold"]).optional().describe("Filter by deployer tier. PRO/ULTRA only — BASIC callers receive HTTP 403."),
+    }, readOnlyAnnotations, async ({ limit, offset, tier }) => ({
+        content: [{ type: "text", text: await query("/api/x402/deployer-hunter/alerts", { limit, offset, ...(tier ? { tier } : {}) }) }],
     }));
     server.tool("madeonsol_kol_pairs", "KOL affinity matrix — discover which KOLs frequently co-trade the same tokens within a time window.", {
         period: z.enum(["7d", "30d"]).default("7d").describe("Time period: 7d or 30d"),
@@ -156,6 +157,29 @@ function registerTools(server) {
     }, readOnlyAnnotations, async ({ period, min_kols, limit }) => ({
         content: [{ type: "text", text: await query("/api/x402/kol/tokens/hot", { period, min_kols, limit }) }],
     }));
+    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) {
+            const headers = { ...apiKeyHeaders() };
+            const res = await fetch(`${BASE_URL}/api/v1/kol/${wallet}/pnl?period=${period}`, { headers });
+            if (!res.ok) {
+                const body = await res.text().catch(() => "");
+                return { content: [{ type: "text", text: `Error ${res.status}: ${body}` }] };
+            }
+            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." }] };
+    });
+    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"),
+        min_kols: z.number().min(1).max(20).default(1).describe("Minimum KOL buyers"),
+        limit: z.number().min(1).max(50).default(20).describe("Number of trending tokens to return"),
+    }, readOnlyAnnotations, async ({ period, min_kols, limit }) => ({
+        content: [{ type: "text", text: await query("/api/x402/kol/tokens/trending", { period, min_kols, limit }) }],
+    }));
     server.tool("madeonsol_discovery", "List all available MadeOnSol API endpoints with prices and parameter docs. Free, no auth required.", {}, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }, async () => {
         const res = await fetch(new URL("/api/x402", BASE_URL).toString());
         const data = await res.json();
@@ -256,10 +280,10 @@ 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 946 KOL wallets and 4000+ Pump.fun deployers. Supports API key, RapidAPI, or x402 micropayments.",
+                    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",
                     tools: [
-                        { name: "madeonsol_kol_feed", description: "Get real-time Solana KOL trades from 946 tracked wallets." },
+                        { 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 elite Pump.fun deployer alerts with KOL enrichment." },
@@ -267,6 +291,8 @@ async function main() {
                         { 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_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." },
@@ -314,8 +340,14 @@ async function main() {
             res.writeHead(404);
             res.end("Not found");
         });
-        httpServer.listen(PORT, () => {
-            console.error(`[madeonsol-mcp] HTTP server listening on port ${PORT}`);
+        // Bind to 127.0.0.1 only — defense in depth. UFW already blocks the port
+        // externally, but binding to all interfaces would expose the server to any
+        // misconfigured firewall rule. Override with HOST=0.0.0.0 if you ever need
+        // to expose it directly (e.g. for hosted environments behind a separate
+        // reverse proxy).
+        const HOST = process.env.HOST || "127.0.0.1";
+        httpServer.listen(PORT, HOST, () => {
+            console.error(`[madeonsol-mcp] HTTP server listening on ${HOST}:${PORT}`);
         });
     }
     else {

package/package.json

@@ -1,45 +1,45 @@
-{
-  "name": "mcp-server-madeonsol",
-  "version": "0.3.3",
-  "mcpName": "io.github.lambopoewert/madeonsol",
-  "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"
-  },
-  "main": "dist/index.js",
-  "files": [
-    "dist",
-    "README.md",
-    "LICENSE",
-    "glama.json"
-  ],
-  "scripts": {
-    "build": "tsc",
-    "prepublishOnly": ""
-  },
-  "keywords": [
-    "mcp",
-    "solana",
-    "x402",
-    "kol",
-    "trading",
-    "claude",
-    "cursor"
-  ],
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/LamboPoewert/mcp-server-madeonsol"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.12.1"
-  },
-  "peerDependencies": {
-    "@x402/fetch": ">=0.1.0",
-    "@x402/core": ">=0.1.0",
-    "@x402/svm": ">=0.1.0",
-    "@solana/kit": ">=2.0.0",
-    "@scure/base": ">=1.0.0"
-  }
-}
+{
+  "name": "mcp-server-madeonsol",
+  "version": "0.5.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",
+  "type": "module",
+  "bin": {
+    "mcp-server-madeonsol": "dist/index.js"
+  },
+  "main": "dist/index.js",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "glama.json"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": ""
+  },
+  "keywords": [
+    "mcp",
+    "solana",
+    "x402",
+    "kol",
+    "trading",
+    "claude",
+    "cursor"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/LamboPoewert/mcp-server-madeonsol"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1"
+  },
+  "peerDependencies": {
+    "@x402/fetch": ">=0.1.0",
+    "@x402/core": ">=0.1.0",
+    "@x402/svm": ">=0.1.0",
+    "@solana/kit": ">=2.0.0",
+    "@scure/base": ">=1.0.0"
+  }
+}