mcp-server-madeonsol 3.0.1 → 3.1.0

package/dist/index.js

@@ -440,7 +440,7 @@ function registerTools(server) {
             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 () => ({
+            server.tool("madeonsol_wallet_tracker_watchlist", "List your tracked wallets with labels and remaining watchlist capacity. PRO 50, ULTRA 100, BUSINESS 500 wallets (the Free tier has no wallet tracker).", {}, { 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.", {
@@ -463,13 +463,15 @@ function registerTools(server) {
             }, { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async ({ wallet_address, label }) => ({
                 content: [{ type: "text", text: await walletTrackerRequest("PATCH", `/wallet-tracker/watchlist/${encodeURIComponent(wallet_address)}`, { label }) }],
             }));
-            server.tool("madeonsol_wallet_tracker_trades", "Historical swap and transfer events for all your watched wallets. BASIC: truncated wallets, no tx_signature.", {
+            server.tool("madeonsol_wallet_tracker_trades", "Historical swap and transfer events for all your watched wallets (PRO+). Returns { events[], count, ordered_by, next_cursor, next_cursor_slot }; each event has wallet_address, label, event_type, action (buy/sell on swaps, null on transfers), token_mint/symbol/name, sol_amount, token_amount, tx_signature, block_time (ingest clock), slot (chain order), replayed, ingested_at. Page with before_slot = next_cursor_slot (order=slot, the default) or before = next_cursor (order=block_time).", {
                 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"),
+                action: z.enum(["buy", "sell"]).optional().describe("Swaps only: buy or sell. Transfers have action null; select them with event_type='transfer'"),
                 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 }) => {
+                order: z.enum(["slot", "block_time"]).optional().describe("Sort by on-chain slot (default on a first page) or by block_time, the ingest clock (default when 'before' is passed)"),
+                before_slot: z.number().int().optional().describe("Cursor for order=slot: next_cursor_slot of the previous page"),
+                before: z.number().optional().describe("Legacy cursor for order=block_time: next_cursor of the previous page"),
+            }, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async ({ wallet, action, event_type, limit, order, before_slot, before }) => {
                 const params = { limit };
                 if (wallet)
                     params.wallet = wallet;
@@ -477,6 +479,10 @@ function registerTools(server) {
                     params.action = action;
                 if (event_type)
                     params.event_type = event_type;
+                if (order)
+                    params.order = order;
+                if (before_slot !== undefined)
+                    params.before_slot = before_slot;
                 if (before !== undefined)
                     params.before = before;
                 const url = new URL(`${BASE_URL}/api/v1/wallet-tracker/trades`);
@@ -634,10 +640,11 @@ function registerTools(server) {
                 body.is_active = is_active;
             return { content: [{ type: "text", text: await restQuery("PATCH", `/webhooks/${id}`, body) }] };
         });
-        server.tool("madeonsol_test_webhook", "Send a sample event payload to a webhook URL to verify it works. Returns status code and response time.", {
+        server.tool("madeonsol_test_webhook", "Send a sample event payload to a webhook URL to verify it works. Returns status code, response time and (newer servers) the event type sampled.", {
             webhook_id: z.number().describe("ID of the webhook to test"),
-        }, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async ({ webhook_id }) => ({
-            content: [{ type: "text", text: await restQuery("POST", "/webhooks/test", { webhook_id }) }],
+            event: z.string().optional().describe("Which of the webhook's subscribed events to sample (e.g. 'kol:trade', 'wallet_tracker:event'). Omit for the first subscribed event; an unsubscribed event is answered with 400."),
+        }, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async ({ webhook_id, event }) => ({
+            content: [{ type: "text", text: await restQuery("POST", "/webhooks/test", event ? { webhook_id, event } : { webhook_id }) }],
         }));
         server.tool("madeonsol_stream_token", "Get your WebSocket streaming token. Stream tokens NEVER EXPIRE: every call returns the same token until your subscription lapses or you pass rotate=true, which replaces it (the previous value keeps working for 60 s). expires_at / next_refresh_at are always null (kept for wire compatibility); the response also carries rotated (boolean) and lifetime (string). The server never rotates on its own and never sends token_refresh unless you rotated; a 4001 close means 'mint again', never a timer. Authenticate the handshake with 'Authorization: Bearer <token>' (?token= still works, masked in logs). Includes ws_url for KOL/deployer streaming (Pro/Ultra) and dex_ws_url for all-DEX trade streaming (Ultra only). PRO+ channels now also include token:locks (event token:lock — every NEW Streamflow / Jupiter Lock / Bonfida lock or vesting contract) and token:fee_claims (event token:fee_claim — every pump.fun fee event: distributions to shareholders, social/X claims, config changes, creator transfers) and token:surges (events token:surge — a token < 30 min old running >= 3x / 6x / 8x its launch MC, tier early / strong / breakout, each once per mint, sustained — and token:revival — no trade candle for >= 24 h, then confirmed buys on the tape; every frame carries tape / kol / early_buyers / deployer / risk_flags[]; subscribe filters kinds[], tiers[], launchpads[], exclude_flags[], min_mc_usd / max_mc_usd, deployer_tier[]).", { rotate: z.boolean().optional().describe("Replace the current token with a new one (the old value keeps working for 60 s). Default false — returns the existing token.") }, { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async ({ rotate }) => ({
             content: [{ type: "text", text: await restQuery("POST", "/stream/token", rotate ? { rotate: true } : undefined) }],
@@ -971,22 +978,33 @@ function registerTools(server) {
         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 () => ({
+        // ── Copy-Trade rules (PRO+) ──
+        //
+        // Tier limits (rules per account, source wallets per rule) are enforced by
+        // the SERVER per tier: copytradeLimits() in the API (PRO 3×5, ULTRA 20×50,
+        // BUSINESS 100×250, ENTERPRISE = BUSINESS). The schema below only carries the
+        // structural ceiling so it never rejects a valid request from the highest
+        // tier before the server can answer; a smaller tier gets the server's 400.
+        const COPYTRADE_SOURCE_WALLETS_MAX = 250;
+        const COPYTRADE_SCOPE_NOTE = "source_wallets must be wallets MadeOnSol tracks as KOLs (the roster at GET /api/v1/kol/wallets): any valid Solana address is accepted into a rule, but signals fire only for trades by tracked KOL wallets, so an untracked wallet never produces a signal.";
+        const MC_BAND_NOTE = "Market-cap band in USD (0 to 1e12, min <= max) on the source trade's market cap at trade time; when a bound is set, trades with an unknown market cap are dropped.";
+        server.tool("madeonsol_copytrade_list", "List your copy-trade rules. Rule limits: PRO 3, ULTRA 20, BUSINESS 100 (Enterprise follows Business).", {}, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async () => ({
             content: [{ type: "text", text: await restQuery("GET", "/copytrade/subscriptions") }],
         }));
-        server.tool("madeonsol_copytrade_create", "Create a copy-trade rule. Returns webhook_secret ONCE on creation when delivery_mode includes 'webhook' — store it to verify HMAC signatures. PRO=5 source_wallets/rule, ULTRA=50.", {
-            source_wallets: z.array(z.string()).min(1).max(50).describe("Wallets to mirror (base58)"),
-            sizing_amount: z.number().describe("Amount used by the chosen sizing_mode"),
+        server.tool("madeonsol_copytrade_create", `Create a copy-trade rule. Returns webhook_secret ONCE on creation when delivery_mode includes 'webhook' — store it to verify HMAC signatures. Source wallets per rule: PRO 5, ULTRA 50, BUSINESS 250 (Enterprise follows Business); the server enforces your tier's limit. Responses may carry source_wallets_tracked / source_wallets_untracked and warnings[] (code untracked_source_wallets or source_wallet_tracking_unavailable). ${COPYTRADE_SCOPE_NOTE}`, {
+            source_wallets: z.array(z.string()).min(1).max(COPYTRADE_SOURCE_WALLETS_MAX).describe("Tracked KOL wallets to mirror (base58). Per-rule limit depends on tier (PRO 5, ULTRA 50, BUSINESS 250); the server rejects more than yours."),
+            sizing_amount: z.number().describe("SOL when sizing_mode is 'fixed'; otherwise a multiplier / fraction of the source size (0.25 = a quarter), never a percent"),
             name: z.string().optional().describe("Optional human label"),
             min_trade_sol: z.number().optional().describe("Minimum source-wallet trade size to fire a signal"),
-            only_action: z.enum(["buy", "sell", "both"]).optional().describe("Filter to one side (default 'both')"),
-            sizing_mode: z.enum(["fixed", "proportional", "percent_source"]).optional().describe("How sizing_amount is interpreted"),
+            only_action: z.enum(["buy", "sell", "both"]).optional().describe("Which side fires a signal (default 'buy' when omitted)"),
+            sizing_mode: z.enum(["fixed", "proportional", "percent_source"]).optional().describe("'fixed' = sizing_amount SOL; 'proportional' and 'percent_source' both = source size × sizing_amount (default 'fixed')"),
             delivery_mode: z.enum(["webhook", "websocket", "both"]).optional().describe("Where to deliver fired signals"),
             webhook_url: z.string().url().optional().describe("Required when delivery_mode includes 'webhook'"),
+            min_mc_usd: z.number().min(0).max(1e12).nullable().optional().describe(`Lower bound. ${MC_BAND_NOTE}`),
+            max_mc_usd: z.number().min(0).max(1e12).nullable().optional().describe(`Upper bound. ${MC_BAND_NOTE}`),
         }, { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }, async (args) => {
             const body = { source_wallets: args.source_wallets, sizing_amount: args.sizing_amount };
-            for (const k of ["name", "min_trade_sol", "only_action", "sizing_mode", "delivery_mode", "webhook_url"]) {
+            for (const k of ["name", "min_trade_sol", "only_action", "sizing_mode", "delivery_mode", "webhook_url", "min_mc_usd", "max_mc_usd"]) {
                 if (args[k] !== undefined)
                     body[k] = args[k];
             }
@@ -995,10 +1013,10 @@ function registerTools(server) {
         server.tool("madeonsol_copytrade_get", "Get one copy-trade rule by id.", { id: z.number().describe("Subscription id") }, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async ({ id }) => ({
             content: [{ type: "text", text: await restQuery("GET", `/copytrade/subscriptions/${id}`) }],
         }));
-        server.tool("madeonsol_copytrade_update", "Update fields on a copy-trade rule, including is_active toggle.", {
+        server.tool("madeonsol_copytrade_update", `Update fields on a copy-trade rule, including is_active toggle. Omit a field to leave it unchanged; pass null to clear an MC bound. If this update sets a webhook_url on a rule that had no signing secret yet (e.g. a websocket-only rule), the response returns webhook_secret ONCE — store it; an existing secret is never re-shown. Responses may carry source_wallets_tracked / source_wallets_untracked and warnings[] (code untracked_source_wallets or source_wallet_tracking_unavailable): tell the user which wallets can never fire. ${COPYTRADE_SCOPE_NOTE}`, {
             id: z.number().describe("Subscription id"),
             name: z.string().nullable().optional(),
-            source_wallets: z.array(z.string()).optional(),
+            source_wallets: z.array(z.string()).min(1).max(COPYTRADE_SOURCE_WALLETS_MAX).optional().describe("Replaces the rule's wallets. Per-rule limit depends on tier (PRO 5, ULTRA 50, BUSINESS 250)."),
             min_trade_sol: z.number().optional(),
             only_action: z.enum(["buy", "sell", "both"]).optional(),
             sizing_mode: z.enum(["fixed", "proportional", "percent_source"]).optional(),
@@ -1006,6 +1024,8 @@ function registerTools(server) {
             delivery_mode: z.enum(["webhook", "websocket", "both"]).optional(),
             webhook_url: z.string().url().nullable().optional(),
             is_active: z.boolean().optional(),
+            min_mc_usd: z.number().min(0).max(1e12).nullable().optional().describe(`Lower bound (null clears it). ${MC_BAND_NOTE}`),
+            max_mc_usd: z.number().min(0).max(1e12).nullable().optional().describe(`Upper bound (null clears it). ${MC_BAND_NOTE}`),
         }, { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }, async ({ id, ...patch }) => {
             const body = {};
             for (const [k, v] of Object.entries(patch)) {
@@ -1017,17 +1037,23 @@ function registerTools(server) {
         server.tool("madeonsol_copytrade_delete", "Delete a copy-trade rule permanently.", { id: z.number().describe("Subscription id") }, { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: true }, async ({ id }) => ({
             content: [{ type: "text", text: await restQuery("DELETE", `/copytrade/subscriptions/${id}`) }],
         }));
-        server.tool("madeonsol_copytrade_signals", "Recent fired copy-trade signals (up to 7 days). Filter by subscription_id, since (ISO8601), and limit (1–500).", {
+        server.tool("madeonsol_copytrade_signals", "Recent fired copy-trade signals (up to 7 days). Filter by subscription_id, since (ISO8601), limit (1–500), and min_mc_usd / max_mc_usd on the source trade's market cap.", {
             subscription_id: z.number().optional().describe("Filter to one rule"),
             since: z.string().optional().describe("ISO8601 timestamp — only signals fired at-or-after this time"),
             limit: z.number().min(1).max(500).default(50).describe("Max signals to return (1–500)"),
-        }, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async ({ subscription_id, since, limit }) => {
+            min_mc_usd: z.number().min(0).max(1e12).optional().describe("Keep signals whose source trade's market cap (USD) was at least this; drops unknown-MC signals"),
+            max_mc_usd: z.number().min(0).max(1e12).optional().describe("Keep signals whose source trade's market cap (USD) was at most this; drops unknown-MC signals"),
+        }, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async ({ subscription_id, since, limit, min_mc_usd, max_mc_usd }) => {
             const url = new URL(`${BASE_URL}/api/v1/copytrade/signals`);
             url.searchParams.set("limit", String(limit));
             if (subscription_id !== undefined)
                 url.searchParams.set("subscription_id", String(subscription_id));
             if (since)
                 url.searchParams.set("since", since);
+            if (min_mc_usd !== undefined)
+                url.searchParams.set("min_mc_usd", String(min_mc_usd));
+            if (max_mc_usd !== undefined)
+                url.searchParams.set("max_mc_usd", String(max_mc_usd));
             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 }] };
@@ -1349,12 +1375,12 @@ async function main() {
                         { name: "madeonsol_tokens_batch_risk", description: "Bulk rug-risk/safety scoring for up to 50 mints — same shape as madeonsol_token_risk + as_of; untracked mints don't fail the batch. PRO+." },
                         { 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." },
-                        { 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." },
+                        { name: "madeonsol_copytrade_list", description: "List your copy-trade rules. PRO+." },
+                        { name: "madeonsol_copytrade_create", description: "Create a copy-trade rule with webhook + WS delivery. PRO+." },
+                        { name: "madeonsol_copytrade_get", description: "Get one copy-trade rule. PRO+." },
+                        { name: "madeonsol_copytrade_update", description: "Update a copy-trade rule. PRO+." },
+                        { name: "madeonsol_copytrade_delete", description: "Delete a copy-trade rule. PRO+." },
+                        { name: "madeonsol_copytrade_signals", description: "Recent fired copy-trade signals (up to 7 days). PRO+." },
                         { name: "madeonsol_kol_first_touches", description: "Recent first-KOL-touch events on tokens — backtested scout signal. Filterable by scout tier S/A/B/C, KOL winrate, token age, mint suffix." },
                         { name: "madeonsol_first_touch_subscriptions_list", description: "List your first-touch webhook subscriptions. ULTRA only." },
                         { name: "madeonsol_first_touch_subscriptions_create", description: "Create a first-touch webhook subscription with HMAC signing. ULTRA only." },

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "3.0.1";
+export declare const VERSION = "3.1.0";

package/dist/version.js

@@ -1,2 +1,2 @@
 // AUTO-GENERATED by ../gen-version.mjs (npm prebuild) from package.json. Do not edit.
-export const VERSION = "3.0.1";
+export const VERSION = "3.1.0";

package/glama.json

@@ -5,7 +5,7 @@
   ],
   "display_name": "MadeOnSol — Solana memecoin intelligence",
   "description": "Real-time Solana memecoin trading intelligence — track 2,000+ KOL wallets with sub-second latency on paid keys and x402 (free-tier live feeds are 5-min delayed), score 85,000+ reputation-profiled Pump.fun deployers out of 1.2M+ indexed, surface multi-KOL coordination signals, run server-side copy-trade rules, and stream every DEX trade across 14 programs. Backtested first-touch scout signal (S-tier scouts attract ≥3 follow-on KOLs ~50% of the time vs 14% baseline). Free tier 200 requests per day (live feeds 5-min delayed), no payment to start; auth via msk_ API key or x402 micropayments.",
-  "version": "3.0.1",
+  "version": "3.1.0",
   "homepage": "https://madeonsol.com/solana-api",
   "repository": "https://github.com/madeonsol/mcp-server-madeonsol",
   "license": "MIT",
@@ -130,7 +130,7 @@
     },
     {
       "name": "madeonsol_wallet_tracker_watchlist",
-      "description": "List tracked wallets and remaining capacity (Free 10 / Pro 50 / Ultra 100)."
+      "description": "List tracked wallets and remaining capacity (Pro 50 / Ultra 100 / Business 500)."
     },
     {
       "name": "madeonsol_wallet_tracker_add",
@@ -142,7 +142,7 @@
     },
     {
       "name": "madeonsol_wallet_tracker_trades",
-      "description": "Historical swap/transfer events for watched wallets (120-day retention)."
+      "description": "Historical swap/transfer events for watched wallets (120-day retention). action buy|sell (swaps only), order slot|block_time, before_slot cursor."
     },
     {
       "name": "madeonsol_wallet_tracker_summary",
@@ -322,7 +322,7 @@
     },
     {
       "name": "madeonsol_copytrade_create",
-      "description": "Create a copy-trade rule with webhook + WS delivery (HMAC-signed)."
+      "description": "Create a copy-trade rule with webhook + WS delivery (HMAC-signed). Optional MC band min_mc_usd/max_mc_usd; signals fire only for tracked KOL wallets."
     },
     {
       "name": "madeonsol_copytrade_get",
@@ -338,7 +338,7 @@
     },
     {
       "name": "madeonsol_copytrade_signals",
-      "description": "Recent fired copy-trade signals (up to 7 days, 1-500)."
+      "description": "Recent fired copy-trade signals (up to 7 days, 1-500). Optional min_mc_usd/max_mc_usd."
     },
     {
       "name": "madeonsol_coordination_alerts_list",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-server-madeonsol",
-  "version": "3.0.1",
+  "version": "3.1.0",
   "mcpName": "io.github.MadeOnSol/madeonsol",
   "description": "MCP server for MadeOnSol Solana KOL intelligence API — use from Claude, Cursor, or any MCP client. Free tier 200 req/day (live feeds 5-min delayed; paid is real-time), no payment to start.",
   "type": "module",