npm - mcp-server-madeonsol - Versions diffs - 0.6.0 → 0.8.0 - Mend

mcp-server-madeonsol 0.6.0 → 0.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/LICENSE CHANGED Viewed

@@ -1,21 +1,21 @@
-MIT License
-Copyright (c) 2026 MadeOnSol
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+Copyright (c) 2026 MadeOnSol
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md CHANGED Viewed

@@ -1,61 +1,78 @@
-# mcp-server-madeonsol
-MCP server for [MadeOnSol](https://madeonsol.com) Solana KOL intelligence API. Use from Claude Desktop, Cursor, or any MCP-compatible client.
-## Install
-```bash
-npm install -g mcp-server-madeonsol @x402/fetch @x402/svm @x402/core @solana/kit @scure/base
-```
-## Configure
-### Claude Desktop
-Add to `claude_desktop_config.json`:
-```json
-{
-  "mcpServers": {
-    "madeonsol": {
-      "command": "mcp-server-madeonsol",
-      "env": {
-        "SVM_PRIVATE_KEY": "your_solana_private_key_base58"
-      }
-    }
-  }
-}
-```
-### Cursor
-Add to MCP settings with the same command and env vars.
-## Tools
-| Tool | Price | Description |
-|---|---|---|
-| `madeonsol_kol_feed` | $0.005 | Real-time KOL trade feed (946 wallets) |
-| `madeonsol_kol_coordination` | $0.02 | Multi-KOL convergence signals |
-| `madeonsol_kol_leaderboard` | $0.005 | KOL PnL and win rate rankings |
-| `madeonsol_deployer_alerts` | $0.01 | Elite Pump.fun deployer launches |
-| `madeonsol_discovery` | Free | List all endpoints and prices |
-## How It Works
-The server uses the x402 payment protocol. Each tool call triggers a USDC micropayment on Solana. Your wallet needs SOL (for fees) and USDC.
-Without `SVM_PRIVATE_KEY`, tools return payment requirement info instead of data.
-## 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 |
-| 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) |
-## License
-MIT
+# mcp-server-madeonsol
+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.
+## Authentication
+Three 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
+```bash
+npm install -g mcp-server-madeonsol
+```
+> x402 peer deps (`@x402/fetch @x402/svm @x402/core @solana/kit @scure/base`) are only needed when using `SVM_PRIVATE_KEY`.
+## Configure
+### Claude Desktop
+Add to `claude_desktop_config.json`:
+```json
+{
+  "mcpServers": {
+    "madeonsol": {
+      "command": "mcp-server-madeonsol",
+      "env": {
+        "MADEONSOL_API_KEY": "msk_your_api_key_here"
+      }
+    }
+  }
+}
+```
+### Cursor
+Add to MCP settings with the same command and env vars.
+## Tools
+| 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) |
+**With Pro/Ultra subscription:**
+| 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 |
+## 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 |
+| 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) |
+## License
+MIT

package/dist/index.js CHANGED Viewed

@@ -5,41 +5,73 @@ import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/
 import { z } from "zod";
 import { createServer } from "node:http";
 const BASE_URL = process.env.MADEONSOL_API_URL || "https://madeonsol.com";
-const PRIVATE_KEY = process.env.SVM_PRIVATE_KEY;
-const RAPIDAPI_KEY = process.env.RAPIDAPI_KEY; // For webhook/streaming features (Pro/Ultra)
+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"
+let authMode = "none";
 let paidFetch = fetch;
-async function initPayment() {
-    if (!PRIVATE_KEY) {
-        console.error("[madeonsol-mcp] No SVM_PRIVATE_KEY — tools will return 402 payment info");
+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() {
+    if (MADEONSOL_API_KEY) {
+        authMode = "madeonsol";
+        console.error("[madeonsol-mcp] Using MadeOnSol API key (Bearer auth)");
         return;
     }
-    try {
-        const { wrapFetchWithPayment } = await import("@x402/fetch");
-        const { x402Client } = await import("@x402/core/client");
-        const { ExactSvmScheme } = await import("@x402/svm/exact/client");
-        const { createKeyPairSignerFromBytes } = await import("@solana/kit");
-        const { base58 } = await import("@scure/base");
-        const signer = await createKeyPairSignerFromBytes(base58.decode(PRIVATE_KEY));
-        const client = new x402Client();
-        client.register("solana:*", new ExactSvmScheme(signer));
-        paidFetch = wrapFetchWithPayment(fetch, client);
-        console.error(`[madeonsol-mcp] x402 payments enabled, wallet: ${signer.address}`);
+    if (RAPIDAPI_KEY) {
+        authMode = "rapidapi";
+        console.error("[madeonsol-mcp] Using RapidAPI key");
+        return;
     }
-    catch (err) {
-        console.error("[madeonsol-mcp] x402 setup failed:", err);
+    if (PRIVATE_KEY) {
+        try {
+            const { wrapFetchWithPayment } = await import("@x402/fetch");
+            const { x402Client } = await import("@x402/core/client");
+            const { ExactSvmScheme } = await import("@x402/svm/exact/client");
+            const { createKeyPairSignerFromBytes } = await import("@solana/kit");
+            const { base58 } = await import("@scure/base");
+            const signer = await createKeyPairSignerFromBytes(base58.decode(PRIVATE_KEY));
+            const client = new x402Client();
+            client.register("solana:*", new ExactSvmScheme(signer));
+            paidFetch = wrapFetchWithPayment(fetch, client);
+            authMode = "x402";
+            console.error(`[madeonsol-mcp] x402 payments enabled, wallet: ${signer.address}`);
+            return;
+        }
+        catch (err) {
+            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.");
 }
 async function query(path, params) {
-    const url = new URL(path, BASE_URL);
+    // API key and RapidAPI auth use /api/v1/ endpoints; x402 uses /api/x402/
+    const apiPath = authMode === "x402" || authMode === "none"
+        ? path
+        : path.replace("/api/x402/", "/api/v1/");
+    const url = new URL(apiPath, BASE_URL);
     if (params) {
         for (const [k, v] of Object.entries(params)) {
             if (v !== undefined)
                 url.searchParams.set(k, String(v));
         }
     }
-    const res = await paidFetch(url.toString());
+    const headers = apiKeyHeaders();
+    const res = authMode === "x402"
+        ? await paidFetch(url.toString())
+        : await fetch(url.toString(), { headers });
     if (!res.ok) {
         const body = await res.text().catch(() => "");
         return `Error ${res.status}: ${body}`;
@@ -48,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. Costs $0.005 USDC per request via x402.", {
+    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)"),
@@ -60,41 +92,185 @@ function registerTools(server) {
             params.kol = kol;
         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. Costs $0.02 USDC per request via x402.", {
+    server.tool("madeonsol_kol_coordination", "Get KOL convergence signals — tokens being accumulated by multiple KOLs simultaneously.", {
         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. Costs $0.005 USDC per request via x402.", {
+    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"),
         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 }) }],
     }));
-    server.tool("madeonsol_deployer_alerts", "Get real-time alerts from elite Pump.fun deployers with KOL buy enrichment. Costs $0.01 USDC per request via x402.", {
+    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"),
+        min_shared: z.number().min(1).max(20).default(3).describe("Minimum number of shared tokens to qualify as a pair"),
+        limit: z.number().min(1).max(50).default(20).describe("Number of KOL pairs to return"),
+    }, readOnlyAnnotations, async ({ period, min_shared, limit }) => ({
+        content: [{ type: "text", text: await query("/api/x402/kol/pairs", { period, min_shared, limit }) }],
+    }));
+    server.tool("madeonsol_kol_timing", "KOL entry/exit timing profile — hold duration, exit speed, and activity patterns for a specific KOL.", {
+        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) {
+            const headers = { ...apiKeyHeaders() };
+            const res = await fetch(`${BASE_URL}/api/v1/kol/${wallet}/timing?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 timing requires API key or RapidAPI key auth." }] };
+    });
+    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) {
+            const headers = { ...apiKeyHeaders() };
+            const res = await fetch(`${BASE_URL}/api/v1/deployer-hunter/${wallet}/trajectory`, { 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: "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.", {
+        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 }) }],
+    }));
+    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 x402 API endpoints with prices and parameter docs. Free, no payment required.", {}, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }, async () => {
+    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();
         return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
     });
-    // ── Webhook & Streaming tools (require RAPIDAPI_KEY env var) ──
-    if (RAPIDAPI_KEY) {
-        const restHeaders = {
-            "Content-Type": "application/json",
-            "x-rapidapi-key": RAPIDAPI_KEY,
-            "x-rapidapi-host": "madeonsol-solana-kol-tracker-tools-api.p.rapidapi.com",
-        };
+    // ── Wallet Tracker tools (REST auth only — all mutating operations) ──
+    {
+        const hasRestAuth = authMode === "madeonsol" || authMode === "rapidapi";
+        async function walletTrackerRequest(method, path, body) {
+            const headers = { "Content-Type": "application/json", ...apiKeyHeaders() };
+            const res = await fetch(`${BASE_URL}/api/v1${path}`, {
+                method,
+                headers,
+                ...(body ? { body: JSON.stringify(body) } : {}),
+            });
+            if (!res.ok) {
+                const text = await res.text().catch(() => "");
+                return `Error ${res.status}: ${text}`;
+            }
+            return JSON.stringify(await res.json(), null, 2);
+        }
+        if (hasRestAuth) {
+            server.tool("madeonsol_wallet_tracker_watchlist", "List your tracked wallets with labels and remaining watchlist capacity. BASIC=10, PRO=50, ULTRA=100.", {}, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async () => ({
+                content: [{ type: "text", text: await walletTrackerRequest("GET", "/wallet-tracker/watchlist") }],
+            }));
+            server.tool("madeonsol_wallet_tracker_add", "Add a Solana wallet to your watchlist. Returns 409 if already tracked or limit reached.", {
+                wallet_address: z.string().describe("Solana wallet address (base58) to track"),
+                label: z.string().optional().describe("Optional human-readable label for this wallet"),
+            }, { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }, async ({ wallet_address, label }) => {
+                const body = { wallet_address };
+                if (label)
+                    body.label = label;
+                return { content: [{ type: "text", text: await walletTrackerRequest("POST", "/wallet-tracker/watchlist", body) }] };
+            });
+            server.tool("madeonsol_wallet_tracker_remove", "Remove a wallet from your watchlist.", {
+                wallet_address: z.string().describe("Solana wallet address to remove from watchlist"),
+            }, { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: true }, async ({ wallet_address }) => ({
+                content: [{ type: "text", text: await walletTrackerRequest("DELETE", `/wallet-tracker/watchlist/${encodeURIComponent(wallet_address)}`) }],
+            }));
+            server.tool("madeonsol_wallet_tracker_trades", "Historical swap and transfer events for all your watched wallets. BASIC: truncated wallets, no tx_signature.", {
+                wallet: z.string().optional().describe("Filter to a specific wallet address"),
+                action: z.enum(["buy", "sell", "transfer_in", "transfer_out"]).optional().describe("Filter by action type"),
+                event_type: z.enum(["swap", "transfer"]).optional().describe("Filter by event type: swap (token trade) or transfer (SOL moved)"),
+                limit: z.number().min(1).max(200).default(50).describe("Max results (1–200)"),
+                before: z.number().optional().describe("Pagination cursor: block_time of the last event from previous page"),
+            }, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async ({ wallet, action, event_type, limit, before }) => {
+                const params = { limit };
+                if (wallet)
+                    params.wallet = wallet;
+                if (action)
+                    params.action = action;
+                if (event_type)
+                    params.event_type = event_type;
+                if (before !== undefined)
+                    params.before = before;
+                const url = new URL(`${BASE_URL}/api/v1/wallet-tracker/trades`);
+                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_wallet_tracker_summary", "Per-wallet stats: swap counts, SOL bought/sold, and last activity time across your watchlist.", {
+                period: z.enum(["24h", "7d", "30d"]).default("7d").describe("Time window for stats"),
+                wallet: z.string().optional().describe("Filter to a specific wallet address"),
+            }, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async ({ period, wallet }) => {
+                const url = new URL(`${BASE_URL}/api/v1/wallet-tracker/summary`);
+                url.searchParams.set("period", period);
+                if (wallet)
+                    url.searchParams.set("wallet", wallet);
+                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] Wallet tracker tools enabled");
+        }
+        else {
+            console.error("[madeonsol-mcp] Wallet tracker tools disabled (requires MADEONSOL_API_KEY or RAPIDAPI_KEY)");
+        }
+    }
+    // ── Webhook & Streaming tools (require API key or RapidAPI key — Pro/Ultra tier) ──
+    const hasRestAuth = authMode === "madeonsol" || authMode === "rapidapi";
+    if (hasRestAuth) {
         async function restQuery(method, path, body) {
+            const headers = {
+                "Content-Type": "application/json",
+                ...apiKeyHeaders(),
+            };
             const res = await fetch(`${BASE_URL}/api/v1${path}`, {
                 method,
-                headers: restHeaders,
+                headers,
                 ...(body ? { body: JSON.stringify(body) } : {}),
             });
             if (!res.ok) {
@@ -104,7 +280,7 @@ function registerTools(server) {
             return JSON.stringify(await res.json(), null, 2);
         }
         const webhookAnnotations = { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true };
-        server.tool("madeonsol_create_webhook", "Register a webhook URL to receive real-time push notifications for KOL trades and deployer alerts. Requires RapidAPI Pro/Ultra.", {
+        server.tool("madeonsol_create_webhook", "Register a webhook URL to receive real-time push notifications for KOL trades and deployer alerts. Requires Pro/Ultra subscription.", {
             url: z.string().url().describe("HTTPS webhook URL to receive events"),
             events: z.array(z.enum(["kol:trade", "kol:coordination", "deployer:alert", "deployer:bond"])).min(1).describe("Event types to subscribe to"),
             min_sol: z.number().optional().describe("Optional: minimum SOL amount filter (for kol:trade)"),
@@ -120,7 +296,7 @@ function registerTools(server) {
                 filters.deployer_tier = deployer_tier;
             return { content: [{ type: "text", text: await restQuery("POST", "/webhooks", { url, events, filters }) }] };
         });
-        server.tool("madeonsol_list_webhooks", "List all your registered webhooks with delivery status and failure counts. Requires RAPIDAPI_KEY env var.", {}, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async () => ({
+        server.tool("madeonsol_list_webhooks", "List all your registered webhooks with delivery status and failure counts.", {}, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async () => ({
             content: [{ type: "text", text: await restQuery("GET", "/webhooks") }],
         }));
         server.tool("madeonsol_delete_webhook", "Delete a webhook by ID. Permanently removes the webhook and its delivery history.", {
@@ -133,42 +309,13 @@ function registerTools(server) {
         }, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async ({ webhook_id }) => ({
             content: [{ type: "text", text: await restQuery("POST", "/webhooks/test", { webhook_id }) }],
         }));
-        server.tool("madeonsol_stream_token", "Generate a 24-hour WebSocket streaming token for real-time event streaming. Connect to wss://madeonsol.com/ws/v1/stream?token=TOKEN", {}, { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }, async () => ({
+        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 tools ──
-        server.tool("madeonsol_alpha_leaderboard", "Get a leaderboard of statistically profitable Solana wallets ranked by win rate, PnL, or ROI. Scored from 47,000+ early buyers tracked across Pump.fun tokens. BASIC: 25 results. PRO: 100. ULTRA: 500 + behavioral signals.", {
-            period: z.enum(["7d", "30d", "all"]).default("all").describe("Time period: 7d, 30d, or all"),
-            min_tokens: z.number().min(1).max(20).default(5).describe("Minimum tokens traded to qualify (1-20)"),
-            sort: z.enum(["win_rate", "pnl", "roi"]).default("win_rate").describe("Sort by win_rate, pnl, or roi"),
-            exclude_bots: z.enum(["true", "false"]).default("true").describe("Exclude medium/high bot-confidence wallets"),
-        }, readOnlyAnnotations, async ({ period, min_tokens, sort, exclude_bots }) => ({
-            content: [{ type: "text", text: await restQuery("GET", `/alpha/leaderboard?period=${period}&min_tokens=${min_tokens}&sort=${sort}&exclude_bots=${exclude_bots}`) }],
-        }));
-        server.tool("madeonsol_alpha_wallet", "Full alpha profile for a single wallet — per-token trade history, win rate, realized PnL, and bot_signals array explaining the confidence rating. ULTRA only.", {
-            wallet: z.string().describe("Solana wallet address (base58)"),
-        }, readOnlyAnnotations, async ({ wallet }) => ({
-            content: [{ type: "text", text: await restQuery("GET", `/alpha/${encodeURIComponent(wallet)}`) }],
-        }));
-        server.tool("madeonsol_alpha_linked", "Find wallets behaviorally linked to a target wallet — co-bought 3+ of the same tokens within a 2-second window (likely same actor or coordinated group). Returns similarity scores. ULTRA only.", {
-            wallet: z.string().describe("Solana wallet address to find linked wallets for"),
-        }, readOnlyAnnotations, async ({ wallet }) => ({
-            content: [{ type: "text", text: await restQuery("GET", `/alpha/${encodeURIComponent(wallet)}/linked`) }],
-        }));
-        server.tool("madeonsol_token_cap_table", "Get the first 10-20 non-deployer early buyers for a token mint, enriched with historical win rates, PnL, KOL identity, and bundle flags. Includes a buyer quality summary. BASIC: 403. PRO: top 10. ULTRA: top 20.", {
-            mint: z.string().describe("Token mint address (base58)"),
-        }, readOnlyAnnotations, async ({ mint }) => ({
-            content: [{ type: "text", text: await restQuery("GET", `/tokens/${encodeURIComponent(mint)}/cap-table`) }],
-        }));
-        server.tool("madeonsol_token_buyer_quality", "Get a 0-100 buyer quality score for a token's early-buyer cohort. Signal: positive (>60), neutral (40-60), negative (<40). BASIC: score + signal only. PRO/ULTRA: + full breakdown. Cached 5 minutes per mint.", {
-            mint: z.string().describe("Token mint address (base58)"),
-        }, readOnlyAnnotations, async ({ mint }) => ({
-            content: [{ type: "text", text: await restQuery("GET", `/tokens/${encodeURIComponent(mint)}/buyer-quality`) }],
-        }));
-        console.error("[madeonsol-mcp] Webhook, streaming & alpha tools enabled (RAPIDAPI_KEY set)");
+        console.error("[madeonsol-mcp] Webhook & streaming tools enabled");
     }
     else {
-        console.error("[madeonsol-mcp] No RAPIDAPI_KEY — webhook/streaming/alpha tools disabled");
+        console.error("[madeonsol-mcp] Webhook/streaming tools disabled (requires MADEONSOL_API_KEY or RAPIDAPI_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 }) => ({
@@ -191,7 +338,7 @@ function registerTools(server) {
     });
 }
 async function main() {
-    await initPayment();
+    await initAuth();
     if (MODE === "http") {
         // HTTP transport for hosted environments (Smithery, etc.)
         const httpServer = createServer();
@@ -208,19 +355,30 @@ async function main() {
                 res.writeHead(200, { "Content-Type": "application/json" });
                 res.end(JSON.stringify({
                     name: "madeonsol",
-                    description: "Solana KOL trading intelligence and deployer analytics via x402 micropayments. Real-time data from 946 KOL wallets and 4000+ Pump.fun deployers.",
+                    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. $0.005 USDC/req." },
-                        { name: "madeonsol_kol_coordination", description: "Get KOL convergence signals — tokens multiple KOLs are accumulating. $0.02 USDC/req." },
-                        { name: "madeonsol_kol_leaderboard", description: "Get KOL performance rankings by PnL and win rate. $0.005 USDC/req." },
-                        { name: "madeonsol_deployer_alerts", description: "Get elite Pump.fun deployer alerts with KOL enrichment. $0.01 USDC/req." },
+                        { 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." },
+                        { 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_discovery", description: "List all available endpoints with prices. Free." },
-                        { name: "madeonsol_create_webhook", description: "Register a webhook for real-time push notifications. Requires RAPIDAPI_KEY." },
-                        { name: "madeonsol_list_webhooks", description: "List your registered webhooks. Requires RAPIDAPI_KEY." },
-                        { name: "madeonsol_delete_webhook", description: "Delete a webhook by ID. Requires RAPIDAPI_KEY." },
-                        { name: "madeonsol_test_webhook", description: "Send a test payload to verify a webhook. Requires RAPIDAPI_KEY." },
-                        { name: "madeonsol_stream_token", description: "Get a 24h WebSocket streaming token. Requires RAPIDAPI_KEY." },
+                        { 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." },
                     ],
                     homepage: "https://madeonsol.com/solana-api",
                     repository: "https://github.com/LamboPoewert/mcp-server-madeonsol",
@@ -262,8 +420,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/glama.json CHANGED Viewed

@@ -1,35 +1,55 @@
-{
-  "name": "mcp-server-madeonsol",
-  "display_name": "MadeOnSol",
-  "description": "Solana KOL trading intelligence and deployer analytics via x402 micropayments. Real-time data from 946 KOL wallets and 4000+ Pump.fun deployers.",
-  "version": "0.1.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"],
-  "tools": [
-    {
-      "name": "madeonsol_kol_feed",
-      "description": "Get real-time Solana KOL trades from 946 tracked wallets. $0.005 USDC/req."
-    },
-    {
-      "name": "madeonsol_kol_coordination",
-      "description": "Get KOL convergence signals — tokens multiple KOLs are accumulating. $0.02 USDC/req."
-    },
-    {
-      "name": "madeonsol_kol_leaderboard",
-      "description": "Get KOL performance rankings by PnL and win rate. $0.005 USDC/req."
-    },
-    {
-      "name": "madeonsol_deployer_alerts",
-      "description": "Get elite Pump.fun deployer alerts with KOL enrichment. $0.01 USDC/req."
-    },
-    {
-      "name": "madeonsol_discovery",
-      "description": "List all available endpoints with prices. Free."
-    }
-  ],
-  "transports": ["stdio", "http"],
-  "runtime": "node"
-}
+{
+  "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",
+  "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"],
+  "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."
+    }
+  ],
+  "transports": ["stdio", "http"],
+  "runtime": "node"
+}

package/package.json CHANGED Viewed

@@ -1,49 +1,45 @@
-{
-  "name": "mcp-server-madeonsol",
-  "version": "0.6.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",
-  "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": {
-    "@scure/base": ">=1.0.0",
-    "@solana/kit": ">=2.0.0",
-    "@x402/core": ">=0.1.0",
-    "@x402/fetch": ">=0.1.0",
-    "@x402/svm": ">=0.1.0"
-  },
-  "devDependencies": {
-    "@types/node": "^25.6.0",
-    "typescript": "^5.9.3"
-  }
-}
+{
+  "name": "mcp-server-madeonsol",
+  "version": "0.8.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"
+  }
+}