npm - mcp-server-madeonsol - Versions diffs - 0.5.0 → 0.7.0 - Mend

mcp-server-madeonsol 0.5.0 → 0.7.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,78 +1,64 @@
-# 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
+# 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",
+        "MADEONSOL_API_KEY": "msk_your_api_key_here"
+      }
+    }
+  }
+}
+```
+`SVM_PRIVATE_KEY` enables x402 micropayments. `MADEONSOL_API_KEY` (get one free at [madeonsol.com/developer](https://madeonsol.com/developer)) enables webhook, streaming, and alpha wallet intelligence tools.
+### 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

package/dist/index.js CHANGED Viewed

@@ -5,73 +5,41 @@ 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 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 PRIVATE_KEY = process.env.SVM_PRIVATE_KEY;
+const MADEONSOL_API_KEY = process.env.MADEONSOL_API_KEY; // For webhook/streaming/alpha features (Pro/Ultra)
 const PORT = parseInt(process.env.PORT || "3100", 10);
 const MODE = process.env.MCP_TRANSPORT || "stdio"; // "stdio" or "http"
-let authMode = "none";
 let paidFetch = fetch;
-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)");
+async function initPayment() {
+    if (!PRIVATE_KEY) {
+        console.error("[madeonsol-mcp] No SVM_PRIVATE_KEY — tools will return 402 payment info");
         return;
     }
-    if (RAPIDAPI_KEY) {
-        authMode = "rapidapi";
-        console.error("[madeonsol-mcp] Using RapidAPI key");
-        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 (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);
-        }
+    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) {
-    // 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);
+    const url = new URL(path, BASE_URL);
     if (params) {
         for (const [k, v] of Object.entries(params)) {
             if (v !== undefined)
                 url.searchParams.set(k, String(v));
         }
     }
-    const headers = apiKeyHeaders();
-    const res = authMode === "x402"
-        ? await paidFetch(url.toString())
-        : await fetch(url.toString(), { headers });
+    const res = await paidFetch(url.toString());
     if (!res.ok) {
         const body = await res.text().catch(() => "");
         return `Error ${res.status}: ${body}`;
@@ -80,7 +48,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 1,000+ tracked wallets.", {
+    server.tool("madeonsol_kol_feed", "Get real-time Solana KOL trades from 946 tracked wallets. Costs $0.005 USDC per request via x402.", {
         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)"),
@@ -92,110 +60,40 @@ 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.", {
+    server.tool("madeonsol_kol_coordination", "Get KOL convergence signals — tokens being accumulated by multiple KOLs simultaneously. Costs $0.02 USDC per request via x402.", {
         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.", {
+    server.tool("madeonsol_kol_leaderboard", "Get KOL performance rankings by PnL and win rate. Costs $0.005 USDC per request via x402.", {
         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 Pump.fun deployers with KOL buy enrichment. PRO/ULTRA subscribers can filter by deployer tier (elite/good/moderate/rising/cold).", {
+    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.", {
         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"),
-        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 }) }],
+    }, readOnlyAnnotations, async ({ limit, offset }) => ({
+        content: [{ type: "text", text: await query("/api/x402/deployer-hunter/alerts", { limit, offset }) }],
     }));
-    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 () => {
+    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 () => {
         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 API key or RapidAPI key — Pro/Ultra tier) ──
-    const hasRestAuth = authMode === "madeonsol" || authMode === "rapidapi";
-    if (hasRestAuth) {
+    // ── Webhook & Streaming tools (require MADEONSOL_API_KEY env var) ──
+    if (MADEONSOL_API_KEY) {
+        const restHeaders = {
+            "Content-Type": "application/json",
+            "Authorization": `Bearer ${MADEONSOL_API_KEY}`,
+        };
         async function restQuery(method, path, body) {
-            const headers = {
-                "Content-Type": "application/json",
-                ...apiKeyHeaders(),
-            };
             const res = await fetch(`${BASE_URL}/api/v1${path}`, {
                 method,
-                headers,
+                headers: restHeaders,
                 ...(body ? { body: JSON.stringify(body) } : {}),
             });
             if (!res.ok) {
@@ -205,7 +103,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 Pro/Ultra subscription.", {
+        server.tool("madeonsol_create_webhook", "Register a webhook URL to receive real-time push notifications for KOL trades and deployer alerts. Requires MADEONSOL_API_KEY (Pro/Ultra).", {
             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)"),
@@ -221,7 +119,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.", {}, { 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. Requires MADEONSOL_API_KEY env var.", {}, { 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.", {
@@ -234,13 +132,42 @@ 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 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 () => ({
+        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 () => ({
             content: [{ type: "text", text: await restQuery("POST", "/stream/token") }],
         }));
-        console.error("[madeonsol-mcp] Webhook & streaming tools enabled");
+        // ── 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 (MADEONSOL_API_KEY set)");
     }
     else {
-        console.error("[madeonsol-mcp] Webhook/streaming tools disabled (requires MADEONSOL_API_KEY or RAPIDAPI_KEY)");
+        console.error("[madeonsol-mcp] No MADEONSOL_API_KEY — webhook/streaming/alpha tools disabled");
     }
     // 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 }) => ({
@@ -263,7 +190,7 @@ function registerTools(server) {
     });
 }
 async function main() {
-    await initAuth();
+    await initPayment();
     if (MODE === "http") {
         // HTTP transport for hosted environments (Smithery, etc.)
         const httpServer = createServer();
@@ -280,25 +207,19 @@ 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.",
+                    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",
                     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." },
-                        { 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_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." },
-                        { 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_create_webhook", description: "Register a webhook for real-time push notifications. Requires MADEONSOL_API_KEY." },
+                        { name: "madeonsol_list_webhooks", description: "List your registered webhooks. Requires MADEONSOL_API_KEY." },
+                        { name: "madeonsol_delete_webhook", description: "Delete a webhook by ID. Requires MADEONSOL_API_KEY." },
+                        { name: "madeonsol_test_webhook", description: "Send a test payload to verify a webhook. Requires MADEONSOL_API_KEY." },
+                        { name: "madeonsol_stream_token", description: "Get a 24h WebSocket streaming token. Requires MADEONSOL_API_KEY." },
                     ],
                     homepage: "https://madeonsol.com/solana-api",
                     repository: "https://github.com/LamboPoewert/mcp-server-madeonsol",
@@ -340,14 +261,8 @@ async function main() {
             res.writeHead(404);
             res.end("Not found");
         });
-        // 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}`);
+        httpServer.listen(PORT, () => {
+            console.error(`[madeonsol-mcp] HTTP server listening on port ${PORT}`);
         });
     }
     else {

package/glama.json CHANGED Viewed

@@ -1,55 +1,35 @@
-{
-  "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"
-}
+{
+  "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"
+}

package/package.json CHANGED Viewed

@@ -1,45 +1,49 @@
-{
-  "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"
-  }
-}
+{
+  "name": "mcp-server-madeonsol",
+  "version": "0.7.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"
+  }
+}