mcp-server-madeonsol 1.1.2 → 1.2.1

package/README.md

@@ -165,6 +165,7 @@ Free tier returns the full REST response shape on every endpoint — real wallet
 | Platform | Package |
 |---|---|
 | TypeScript SDK | [`madeonsol`](https://www.npmjs.com/package/madeonsol) on npm |
+| Rust SDK | [`madeonsol`](https://crates.io/crates/madeonsol) on crates.io |
 | Python (LangChain, CrewAI) | [`madeonsol-x402`](https://pypi.org/project/madeonsol-x402/) on PyPI |
 | ElizaOS | [`@madeonsol/plugin-madeonsol`](https://www.npmjs.com/package/@madeonsol/plugin-madeonsol) |
 | Solana Agent Kit | [`solana-agent-kit-plugin-madeonsol`](https://www.npmjs.com/package/solana-agent-kit-plugin-madeonsol) |

package/dist/index.js

@@ -72,15 +72,18 @@ 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. PRO+ adds size/age/strategy/winrate filters.", {
         limit: z.number().min(1).max(100).default(10).describe("Number of trades to return (1-100)"),
+        before: z.string().optional().describe("Cursor — ISO 8601 timestamp; returns trades strictly older than this. Pass next_before from the previous response for polling."),
         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)"),
         min_sol: z.number().optional().describe("PRO+: minimum SOL size per trade"),
         token_age_max_min: z.number().optional().describe("PRO+: max token age in minutes at time of trade"),
         exclude_sells: z.boolean().optional().describe("PRO+: drop sell-side trades"),
         min_kol_winrate: z.number().optional().describe("PRO+: minimum 7d winrate of the KOL (0-100)"),
-        strategy: z.enum(["sniper", "flipper", "swinger", "holder", "mixed"]).optional().describe("PRO+: filter by auto-tagged strategy"),
-    }, readOnlyAnnotations, async ({ limit, action, kol, min_sol, token_age_max_min, exclude_sells, min_kol_winrate, strategy }) => {
+        strategy: z.enum(["scalper", "day_trader", "swing_trader", "hodler", "mixed"]).optional().describe("PRO+: filter by auto-tagged strategy"),
+    }, readOnlyAnnotations, async ({ limit, before, action, kol, min_sol, token_age_max_min, exclude_sells, min_kol_winrate, strategy }) => {
         const params = { limit };
+        if (before)
+            params.before = before;
         if (action)
             params.action = action;
         if (kol)
@@ -136,13 +139,31 @@ function registerTools(server) {
             params.min_winrate = min_winrate;
         return { content: [{ type: "text", text: await query("/api/x402/kol/leaderboard", params) }] };
     });
-    server.tool("madeonsol_deployer_alerts", "Get real-time alerts from Pump.fun deployers with KOL buy enrichment. PRO/ULTRA subscribers can filter by deployer tier (elite/good/moderate/rising/cold).", {
+    server.tool("madeonsol_deployer_alerts", "Get real-time alerts from Pump.fun deployers with KOL buy enrichment. Filters: deployer tier, alert_type, priority, and min_kol_buys to gate out noise. Cursor-paginated via 'before' (preferred over 'offset' at scale).", {
         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"),
+        offset: z.number().min(0).default(0).describe("Legacy offset pagination (prefer 'before' for polling)"),
+        before: z.string().optional().describe("Cursor — ISO 8601 timestamp; returns alerts strictly older than this. Pass next_before from the previous response."),
+        since: z.string().optional().describe("Only alerts after this ISO 8601 timestamp."),
         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 } : {}) }) }],
-    }));
+        alert_type: z.string().optional().describe("Filter by alert_type (e.g. 'new_deploy', 'bonded')."),
+        priority: z.enum(["high", "medium", "low"]).optional().describe("Filter by alert priority."),
+        min_kol_buys: z.number().min(1).max(100).optional().describe("Only alerts where at least N KOLs bought the token (1-100)."),
+    }, readOnlyAnnotations, async ({ limit, offset, before, since, tier, alert_type, priority, min_kol_buys }) => {
+        const params = { limit, offset };
+        if (before)
+            params.before = before;
+        if (since)
+            params.since = since;
+        if (tier)
+            params.tier = tier;
+        if (alert_type)
+            params.alert_type = alert_type;
+        if (priority)
+            params.priority = priority;
+        if (min_kol_buys !== undefined)
+            params.min_kol_buys = min_kol_buys;
+        return { content: [{ type: "text", text: await query("/api/x402/deployer-hunter/alerts", params) }] };
+    });
     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"),
@@ -399,6 +420,16 @@ function registerTools(server) {
         server.tool("madeonsol_token_buyer_quality", "0–100 buyer-quality score for a token's first-buyer cohort. 5-min cached. BASIC: score+signal only. PRO/ULTRA: full breakdown.", { mint: z.string().describe("Token mint address (base58)") }, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async ({ mint }) => ({
             content: [{ type: "text", text: await restQuery("GET", `/tokens/${encodeURIComponent(mint)}/buyer-quality`) }],
         }));
+        server.tool("madeonsol_tokens_batch_buyer_quality", "Bulk buyer-quality scoring for up to 50 mints in one call. Shares the 5-min LRU cache with the single-mint endpoint — already-warm mints return at ~zero cost. Response includes cache_hits counter.", { mints: z.array(z.string()).min(1).max(50).describe("1–50 base58 Solana token mints") }, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async ({ mints }) => ({
+            content: [{ type: "text", text: await restQuery("POST", "/tokens/batch/buyer-quality", { mints }) }],
+        }));
+        // ── Token intelligence (/token/{mint} + batch) ──
+        server.tool("madeonsol_token_get", "Comprehensive per-mint snapshot: price (VWAP), market cap, 24h volume, deployer reputation, KOL smart-money activity, first_seen_at + age_seconds, and blacklist status — all in one call. ULTRA adds individual KOL wallet addresses in top_buyers[].", { mint: z.string().describe("Token mint address (base58)") }, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async ({ mint }) => ({
+            content: [{ type: "text", text: await restQuery("GET", `/token/${encodeURIComponent(mint)}`) }],
+        }));
+        server.tool("madeonsol_token_batch", "Bulk lookup of up to 50 mints in one request. Returns the same per-mint shape as madeonsol_token_get. DB queries batched with IN(...); dex-stream + RPC fan-outs run in parallel. ~10-20× cheaper than N sequential calls — ideal for sniper pipelines scoring many tokens at once.", { mints: z.array(z.string()).min(1).max(50).describe("1–50 base58 Solana token mints") }, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async ({ mints }) => ({
+            content: [{ type: "text", text: await restQuery("POST", "/token/batch", { mints }) }],
+        }));
         // ── Copy-Trade rules (PRO/ULTRA) ──
         server.tool("madeonsol_copytrade_list", "List your copy-trade rules. PRO=3 rules, ULTRA=20 rules.", {}, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async () => ({
             content: [{ type: "text", text: await restQuery("GET", "/copytrade/subscriptions") }],
@@ -581,6 +612,9 @@ async function main() {
                         { name: "madeonsol_alpha_linked", description: "Behaviorally linked wallets (co-bought 3+ tokens within 2s). ULTRA only." },
                         { name: "madeonsol_token_cap_table", description: "First non-deployer early buyers for a token, enriched. PRO=10, ULTRA=20." },
                         { name: "madeonsol_token_buyer_quality", description: "0–100 buyer quality score for a token's first-buyer cohort." },
+                        { name: "madeonsol_tokens_batch_buyer_quality", description: "Bulk buyer-quality scoring for up to 50 mints. Shares the LRU cache." },
+                        { name: "madeonsol_token_get", description: "Comprehensive per-mint snapshot: price, MC, volume, deployer, KOL, age, blacklist." },
+                        { name: "madeonsol_token_batch", description: "Bulk token snapshot for up to 50 mints — ~10-20× cheaper than N sequential calls." },
                         { name: "madeonsol_copytrade_list", description: "List your copy-trade rules. PRO/ULTRA." },
                         { name: "madeonsol_copytrade_create", description: "Create a copy-trade rule with webhook + WS delivery. PRO/ULTRA." },
                         { name: "madeonsol_copytrade_get", description: "Get one copy-trade rule. PRO/ULTRA." },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-server-madeonsol",
-  "version": "1.1.2",
+  "version": "1.2.1",
   "mcpName": "io.github.lambopoewert/madeonsol",
   "description": "MCP server for MadeOnSol Solana KOL intelligence API — use from Claude, Cursor, or any MCP client",
   "type": "module",

package/glama.json

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