mcp-server-madeonsol 1.26.0 → 1.27.0

package/README.md

@@ -13,6 +13,8 @@ MCP server for [MadeOnSol](https://madeonsol.com) Solana KOL intelligence API. U
 
 > Real-time Solana trading intelligence: track 1,069 KOL wallets with <3s latency on paid keys and x402 pay-per-call (free-tier live feeds are 5-min delayed), score 23,000+ Pump.fun deployers, surface deshred deploy signals **~500ms before on-chain confirmation**, detect multi-KOL coordination, surface bundle-cohort holdings (which same-slot wallets still hold a token's supply), verify any wallet's CURRENT on-chain holdings straight from its token accounts, and stream every DEX trade across 9+ programs. Free tier: 200 requests/day across 40+ endpoints (live feeds 5-min delayed) — no signup payment. Get a key at [madeonsol.com/pricing](https://madeonsol.com/pricing).
 
+> **New in 1.27.0 — top traders, sniper watchlist management, and two update tools (104 tools total).** Six additions found by an internal agentic-infra coverage audit. `madeonsol_token_top_traders` (`GET /tokens/{mint}/top-traders`, PRO/ULTRA) ranks a token's wallets by realized PnL or ROI, enriched with KOL/alpha-wallet identity — this endpoint already existed on the REST API and x402 rail but had no MCP tool. `madeonsol_sniper_watchlist_list` / `_add` / `_remove` (PRO+/ULTRA) manage your custom sniper-deploy watchlist (`madeonsol_sniper_recent(watchlist: true)` narrows to it) — previously only reachable via raw HTTP. `madeonsol_update_webhook` (PATCH) changes a webhook's URL, events, or active state without deleting and recreating it. `madeonsol_wallet_tracker_relabel` (PATCH) renames or clears a tracked wallet's label.
+>
 > **New in 1.26.0 — deployer reputation as-of a date, and creator-fee rewards.** Two new tools (PRO+, keyed `msk_` API only — no x402 route). `madeonsol_deployer_as_of` binds `GET /deployer-hunter/{wallet}/as-of`: the deployer's reputation exactly as it stood on `date` (default today, UTC) — the latest write-on-change snapshot at or before it, so an agent backtests without look-ahead bias. `snapshot.snapshot_date` can predate `date` (write-on-change); `snapshot.carried: true` marks that. No snapshot at or before `date` → `as_of: false, snapshot: null` — nothing is ever synthesized. `date` must be ≥ 2026-04-07 and not in the future. `madeonsol_deployer_rewards` binds `GET /deployer-hunter/{wallet}/rewards`: pump.fun creator-fee rewards, answered two ways that are never merged — `collected` (what actually reached the wallet: direct vault claims kept 90 days, social-handle claims, shareholder payouts on **any** token) and `attributed` (every payout on the tokens it **deployed**, split `to_self`/`to_others` + `redirected_pct`). Every money field is `{sol, usdc, usd}`; `usd` is `null` (never a silent 0) when a SOL amount exists and no SOL price was available. `top_tokens`/`top_recipients` (≤10, USD-sorted) show where attributed fees went. Works for non-deployers too (`is_deployer: false`, `attributed` empty).
 
 > **New in 1.25.0 — token surges & revivals: momentum fires with the honest half attached.** The new `madeonsol_tokens_surges` tool binds `GET /tokens/surges` (PRO+, keyed `msk_` API only — no x402 route): every token momentum fire, newest first. Two kinds, one row shape. **`surge`** — a token < 30 min old whose market cap runs hard against its *launch* MC, in three tiers that each fire at most once per mint: `early` (≤10 min, ≥$12k, ≥3× launch), `strong` (≤30 min, ≥$30k, ≥6× launch **and** ≥2× the lowest sample of the last 3 min — it is climbing *now*), `breakout` (≤2 min, ≥$45k, ≥8×). A tier must be **sustained** (current tick *and* a sample ≥10 s older; nothing fires before 20 s of age) — a same-slot bundle marked to $475k at age 1 s is a spike, not a surge. **`revival`** — a token with no 1-minute trade candle for ≥24 h that starts trading again, confirmed **only by the tape** (≥5 buys, ≥$500 buy volume, MC ≥1.5× the pre-dormancy close), never by the price mark; `tier` is `null`. Hard gates on both: liquidity ≥$1.5k and ≥2 % of MC, and the MC gained must be **paid for** by buy volume (a price mark in a spoof pool moves MC on ~$0). Every row carries the burst `tape` (`source` candles / wallet_trades; `unique_buyers` only where the mint is in trade coverage — `wallet_data_available:false` otherwise, never an inferred zero), `kol` buyers, the first-20 `early_buyers` cohort (bundled / sold / sniper wallets), `deployer` reputation and `risk_flags[]` (`bundled_launch`, `few_buyers`, `wash_pattern`, `thin_liquidity`, `cold_deployer`, `sniper_heavy`, `early_buyers_exiting`, `sell_pressure`, `no_tape_trades`, `no_prior_price`, `mint_authority_active`, `transfer_fee` — empty means no flag raised, not verified clean). Rows ≥65 min old carry the +1 h `outcome`; `stats=1` prints per-(kind, tier) hit-rates (`up_1h_pct`, `median_peak_multiple`, `doubled_1h_pct`) — out-of-sample by construction. Filters `kind`, `tier`, `mint`, `launchpad`, `deployer_tier`, `min_mc_usd` / `max_mc_usd`, `min_buys`, `exclude_flags`, `only_clean`; cursors `since` / `before`. Pushed live on the new **`token:surges`** WS channel (events `token:surge` / `token:revival`; subscribe filters `kinds[]`, `tiers[]`, `launchpads[]`, `exclude_flags[]`, `min_mc_usd` / `max_mc_usd`, `deployer_tier[]`) and accepted by `madeonsol_create_webhook` as events `token:surge` / `token:revival` with the same filters. The response echoes the live thresholds in `definitions`.

package/dist/index.js

@@ -375,6 +375,49 @@ function registerTools(server) {
         }
         return { content: [{ type: "text", text: JSON.stringify(await res.json(), null, 2) }] };
     });
+    server.tool("madeonsol_sniper_watchlist_list", "List your custom sniper watchlist (tracked deployer wallets, any tier). PRO+/ULTRA only. Added 2026-09-10.", {}, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async () => {
+        if (authMode !== "madeonsol")
+            return { content: [{ type: "text", text: "Sniper watchlist requires MADEONSOL_API_KEY (msk_)." }] };
+        const res = await fetch(`${BASE_URL}/api/v1/sniper/watchlist`, { headers: apiKeyHeaders() });
+        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) }] };
+    });
+    server.tool("madeonsol_sniper_watchlist_add", "Add one or many deployer wallets to your sniper watchlist — narrows madeonsol_sniper_recent(watchlist:true) to just these. PRO+/ULTRA only. Added 2026-09-10.", {
+        wallet: z.string().optional().describe("Single deployer wallet address (base58) — provide this or `wallets`"),
+        wallets: z.array(z.string()).optional().describe("Multiple deployer wallet addresses (base58, up to 50) — provide this or `wallet`"),
+        label: z.string().optional().describe("Optional human-readable label"),
+    }, { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }, async ({ wallet, wallets, label }) => {
+        if (authMode !== "madeonsol")
+            return { content: [{ type: "text", text: "Sniper watchlist requires MADEONSOL_API_KEY (msk_)." }] };
+        const body = {};
+        if (wallet)
+            body.wallet = wallet;
+        if (wallets)
+            body.wallets = wallets;
+        if (label)
+            body.label = label;
+        const res = await fetch(`${BASE_URL}/api/v1/sniper/watchlist`, { method: "POST", headers: { "Content-Type": "application/json", ...apiKeyHeaders() }, body: JSON.stringify(body) });
+        if (!res.ok) {
+            const respBody = await res.text().catch(() => "");
+            return { content: [{ type: "text", text: `Error ${res.status}: ${respBody}` }] };
+        }
+        return { content: [{ type: "text", text: JSON.stringify(await res.json(), null, 2) }] };
+    });
+    server.tool("madeonsol_sniper_watchlist_remove", "Remove a deployer wallet from your sniper watchlist. PRO+/ULTRA only. Added 2026-09-10.", {
+        wallet: z.string().describe("Deployer wallet address (base58) to remove"),
+    }, { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: true }, async ({ wallet }) => {
+        if (authMode !== "madeonsol")
+            return { content: [{ type: "text", text: "Sniper watchlist requires MADEONSOL_API_KEY (msk_)." }] };
+        const res = await fetch(`${BASE_URL}/api/v1/sniper/watchlist/${encodeURIComponent(wallet)}`, { method: "DELETE", headers: apiKeyHeaders() });
+        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) }] };
+    });
     server.tool("madeonsol_discovery", "List all available MadeOnSol API endpoints with prices and parameter docs. Free, no auth required. The keyless x402 catalog now covers 25 endpoints — recent additions: token candles ($0.01), almost-bonded ($0.01), top-traders ($0.02), cap-table ($0.02), sniper recent deploys ($0.01), token flow ($0.01), and deployer trajectory ($0.01).", {}, { 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();
@@ -414,6 +457,12 @@ function registerTools(server) {
             }, { 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_relabel", "Rename (or clear) the label on a wallet already in your watchlist. Added 2026-09-10.", {
+                wallet_address: z.string().describe("Solana wallet address (base58) already on your watchlist"),
+                label: z.string().nullable().describe("New label, or null to clear it"),
+            }, { 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.", {
                 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"),
@@ -570,6 +619,21 @@ function registerTools(server) {
         }, { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: true }, async ({ id }) => ({
             content: [{ type: "text", text: await restQuery("DELETE", `/webhooks/${id}`) }],
         }));
+        server.tool("madeonsol_update_webhook", "Update a webhook's URL, subscribed events, or active state. Only the fields you pass are changed. Added 2026-09-10.", {
+            id: z.number().describe("Webhook ID to update"),
+            url: z.string().url().optional().describe("New HTTPS webhook URL"),
+            events: z.array(z.enum(["kol:trade", "kol:coordination", "deployer:alert", "deployer:bond"])).optional().describe("Replace the subscribed event types"),
+            is_active: z.boolean().optional().describe("Enable or disable this webhook"),
+        }, webhookAnnotations, async ({ id, url, events, is_active }) => {
+            const body = {};
+            if (url !== undefined)
+                body.url = url;
+            if (events !== undefined)
+                body.events = events;
+            if (is_active !== undefined)
+                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.", {
             webhook_id: z.number().describe("ID of the webhook to test"),
         }, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async ({ webhook_id }) => ({
@@ -849,6 +913,26 @@ function registerTools(server) {
             const path = `/tokens/${encodeURIComponent(mint)}/flow${query ? `?${query}` : ""}`;
             return { content: [{ type: "text", text: await restQuery("GET", path) }] };
         });
+        server.tool("madeonsol_token_top_traders", "The wallets that made (or lost) the most on a token, ranked by realized PnL or ROI (up to 25 on PRO, 100 on ULTRA). Each trader enriched with KOL identity and alpha-wallet reputation (bot_confidence, historical win rate/PnL) so you can tell smart money from bots. Added 2026-09-10 — this tool was missing despite the endpoint existing on every other surface. PRO/ULTRA only.", {
+            mint: z.string().describe("Token mint address (base58)"),
+            limit: z.number().min(1).max(100).optional().describe("Max traders returned — 1-25 PRO, 1-100 ULTRA (default 10)"),
+            sort: z.enum(["pnl", "roi"]).optional().describe("Rank by realized PnL (default) or ROI"),
+            window_days: z.number().min(1).max(180).optional().describe("Lookback window in days (default 90)"),
+            min_bought_sol: z.number().optional().describe("Exclude traders below this total SOL bought (default 0.1)"),
+        }, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async ({ mint, limit, sort, window_days, min_bought_sol }) => {
+            const qs = new URLSearchParams();
+            if (limit !== undefined)
+                qs.set("limit", String(limit));
+            if (sort !== undefined)
+                qs.set("sort", sort);
+            if (window_days !== undefined)
+                qs.set("window_days", String(window_days));
+            if (min_bought_sol !== undefined)
+                qs.set("min_bought_sol", String(min_bought_sol));
+            const query = qs.toString();
+            const path = `/tokens/${encodeURIComponent(mint)}/top-traders${query ? `?${query}` : ""}`;
+            return { content: [{ type: "text", text: await restQuery("GET", path) }] };
+        });
         server.tool("madeonsol_token_trades", "Mint-scoped trade tape — cursor-paginated raw trades for one token, newest first (the backfill/history complement to the live DEX firehose stream). Each trade: tx_signature, wallet_address, action (buy|sell), sol_amount, token_amount, price_sol|null, price_usd|null, market_price_sol|null, market_price_usd|null, early_buyer_rank|null, slot|null, block_time (unix sec), traded_at (ISO). TWO PRICES, and picking the wrong one gives wrong answers: price_sol is THIS trade's executed price (sol_amount / token_amount — the trader's all-in rate, including swap fee and any account rent, not the pool mid), while market_price_sol is the canonical pool price sampled near that slot and is SHARED by every trade in the slot. Use price_sol for cost basis, fills and PnL; use market_price_sol for a per-token price series independent of trade size and direction. Filters: action, wallet, since/until (unix seconds — defaults to FULL history, not 90d). Pass next_cursor from the previous response to page older trades; has_more tells you when to stop. Coverage honesty: capture starts 2026-04-12 and is pump.fun-pipeline scoped — the response carries coverage.history_start + coverage.scope so agents can reason about gaps. PRO/ULTRA only.", {
             mint: z.string().describe("Token mint address (base58)"),
             limit: z.number().min(1).max(500).default(100).describe("Trades per page (1-500, default 100)"),
@@ -1260,6 +1344,7 @@ async function main() {
                         { name: "madeonsol_token_buyer_quality", description: "0–100 buyer quality score for a token's first-buyer cohort." },
                         { name: "madeonsol_token_depth", description: "Per-pool price impact / slippage — quotes per SOL buy size + SOL to move price 1%/5%/10%; unsupported pools flagged with a reason. PRO+." },
                         { name: "madeonsol_token_candles", description: "Historical OHLCV price candles (1m–1d). PRO=OHLCV 30d; ULTRA=+net flow, liquidity delta, full history." },
+                        { name: "madeonsol_token_top_traders", description: "The wallets that made or lost the most on a token, ranked by PnL or ROI, enriched with KOL/alpha-wallet identity. PRO/ULTRA." },
                         { name: "madeonsol_token_trades", description: "Mint-scoped trade tape — cursor-paginated raw trades for one token, full history from 2026-04-12. PRO+." },
                         { name: "madeonsol_tokens_batch_buyer_quality", description: "Bulk buyer-quality scoring for up to 50 mints. Shares the LRU cache." },
                         { 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+." },

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "1.26.0";
+export declare const VERSION = "1.27.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 = "1.26.0";
+export const VERSION = "1.27.0";

package/glama.json

@@ -1,277 +1,437 @@
-{
-  "name": "mcp-server-madeonsol",
-  "maintainers": [
-    "madeonsol"
-  ],
-  "display_name": "MadeOnSol — Solana memecoin intelligence",
-  "description": "Real-time Solana memecoin trading intelligence — track 1,000+ KOL wallets with <3s latency on paid keys and x402 (free-tier live feeds are 5-min delayed), score 15,500+ Pump.fun deployers, 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": "1.26.0",
-  "homepage": "https://madeonsol.com/solana-api",
-  "repository": "https://github.com/madeonsol/mcp-server-madeonsol",
-  "license": "MIT",
-  "categories": [
-    "blockchain",
-    "finance",
-    "web3"
-  ],
-  "tags": [
-    "mcp",
-    "claude",
-    "cursor",
-    "solana",
-    "memecoin",
-    "kol",
-    "kol-tracker",
-    "alpha-bot",
-    "first-touch",
-    "coordination",
-    "deployer-hunter",
-    "pump-fun",
-    "copy-trade",
-    "smart-money",
-    "x402",
-    "micropayments",
-    "defi",
-    "trading",
-    "api"
-  ],
-  "tools": [
-    {
-      "name": "madeonsol_kol_feed",
-      "description": "Real-time Solana KOL trade feed from 1,000+ tracked wallets."
-    },
-    {
-      "name": "madeonsol_kol_coordination",
-      "description": "Multi-KOL convergence with 0-100 score, peak-density window, exits."
-    },
-    {
-      "name": "madeonsol_kol_first_touches",
-      "description": "First-KOL-touch events — backtested scout signal, filter by tier S/A/B/C."
-    },
-    {
-      "name": "madeonsol_kol_leaderboard",
-      "description": "KOL PnL + win-rate rankings over today, 7d, 30d, 90d, 180d."
-    },
-    {
-      "name": "madeonsol_kol_pairs",
-      "description": "KOL affinity matrix — which KOLs co-trade the same tokens."
-    },
-    {
-      "name": "madeonsol_kol_hot_tokens",
-      "description": "KOL momentum tokens — accelerating buy interest."
-    },
-    {
-      "name": "madeonsol_kol_trending_tokens",
-      "description": "Tokens ranked by KOL buy volume across 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 with overlap analysis."
-    },
-    {
-      "name": "madeonsol_kol_alerts_recent",
-      "description": "Unified live KOL alert feed: clusters, fresh buys, heating-up wallets."
-    },
-    {
-      "name": "madeonsol_kol_pnl",
-      "description": "Deep per-wallet PnL: equity curve, risk metrics, closed + open positions."
-    },
-    {
-      "name": "madeonsol_kol_timing",
-      "description": "KOL entry/exit timing profile — average hold, win rate by hour."
-    },
-    {
-      "name": "madeonsol_deployer_alerts",
-      "description": "Pump.fun deployer alerts with KOL enrichment, filter by tier."
-    },
-    {
-      "name": "madeonsol_deployer_trajectory",
-      "description": "Deployer skill curve — streaks, rolling bond rate, trend."
-    },
-    {
-      "name": "madeonsol_alpha_leaderboard",
-      "description": "Top profitable early-buyer wallets — 25,000+ scored, up to 500 on ULTRA."
-    },
-    {
-      "name": "madeonsol_alpha_wallet",
-      "description": "Full alpha profile + bot-signal flags for one wallet."
-    },
-    {
-      "name": "madeonsol_alpha_linked",
-      "description": "Behaviorally linked wallets (co-bought 3+ tokens within 2s)."
-    },
-    {
-      "name": "madeonsol_tokens_list",
-      "description": "Filtered token directory — MC band, liquidity, MEV-share, velocity, primary DEX, authority flags, momentum/trending sorts."
-    },
-    {
-      "name": "madeonsol_almost_bonded",
-      "description": "Pre-bond pump.fun tokens near graduation, ranked by velocity (Δprogress/min) — progress, eta, stalled, deployer tier."
-    },
-    {
-      "name": "madeonsol_token_get",
-      "description": "Single token detail — MC, holders, velocity, MEV-share, history age."
-    },
-    {
-      "name": "madeonsol_token_batch",
-      "description": "Bulk token detail fetch — up to 50 mints per call."
-    },
-    {
-      "name": "madeonsol_token_cap_table",
-      "description": "First non-deployer early buyers for a token, enriched with PnL/KOL/bot flags."
-    },
-    {
-      "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 — up to 50 mints per call."
-    },
-    {
-      "name": "madeonsol_tokens_batch_risk",
-      "description": "Bulk rug-risk/safety scoring — up to 50 mints per call, same shape as madeonsol_token_risk + as_of; untracked mints don't fail the batch."
-    },
-    {
-      "name": "madeonsol_token_trades",
-      "description": "Mint-scoped trade tape — cursor-paginated raw trades for one token, full history from 2026-04-12, pump.fun-pipeline scoped. PRO+."
-    },
-    {
-      "name": "madeonsol_tokens_surges",
-      "description": "Token surges & revivals — momentum fires with tape, KOL, early-buyer, deployer context and risk_flags[]; surge tiers early/strong/breakout vs launch MC, revivals confirmed by tape buys; +1 h outcomes and per-tier hit-rates. PRO+."
-    },
-    {
-      "name": "madeonsol_wallet_tracker_watchlist",
-      "description": "List tracked wallets and remaining capacity (Free 10 / Pro 50 / Ultra 100)."
-    },
-    {
-      "name": "madeonsol_wallet_tracker_add",
-      "description": "Add a wallet to your watchlist with optional label."
-    },
-    {
-      "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 (120-day retention)."
-    },
-    {
-      "name": "madeonsol_wallet_tracker_summary",
-      "description": "Per-wallet stats: swap counts, SOL bought/sold, last event."
-    },
-    {
-      "name": "madeonsol_wallet_batch_classify",
-      "description": "Bulk reputation flags for 1-100 wallets in one call — is_sniper/is_bundler/is_dumper/is_kol, bot_confidence (none/low/medium/high), dump_cluster cohorts. PRO+."
-    },
-    {
-      "name": "madeonsol_copytrade_list",
-      "description": "List your copy-trade rules."
-    },
-    {
-      "name": "madeonsol_copytrade_create",
-      "description": "Create a copy-trade rule with webhook + WS delivery (HMAC-signed)."
-    },
-    {
-      "name": "madeonsol_copytrade_get",
-      "description": "Get one copy-trade rule."
-    },
-    {
-      "name": "madeonsol_copytrade_update",
-      "description": "Update or toggle a copy-trade rule."
-    },
-    {
-      "name": "madeonsol_copytrade_delete",
-      "description": "Delete a copy-trade rule."
-    },
-    {
-      "name": "madeonsol_copytrade_signals",
-      "description": "Recent fired copy-trade signals (up to 7 days, 1-500)."
-    },
-    {
-      "name": "madeonsol_coordination_alerts_list",
-      "description": "List your KOL coordination alert rules (PRO=5, ULTRA=20)."
-    },
-    {
-      "name": "madeonsol_coordination_alerts_create",
-      "description": "Create a coordination alert rule — pg_notify push, sub-second delivery."
-    },
-    {
-      "name": "madeonsol_coordination_alerts_get",
-      "description": "Get one coordination alert rule."
-    },
-    {
-      "name": "madeonsol_coordination_alerts_update",
-      "description": "Update or toggle a coordination alert rule."
-    },
-    {
-      "name": "madeonsol_coordination_alerts_delete",
-      "description": "Delete a coordination alert rule."
-    },
-    {
-      "name": "madeonsol_first_touch_subscriptions_list",
-      "description": "List your first-touch webhook subscriptions (ULTRA, up to 10)."
-    },
-    {
-      "name": "madeonsol_first_touch_subscriptions_create",
-      "description": "Create a first-touch webhook subscription — push on every S-tier scout buy."
-    },
-    {
-      "name": "madeonsol_first_touch_subscriptions_get",
-      "description": "Get one first-touch subscription."
-    },
-    {
-      "name": "madeonsol_first_touch_subscriptions_update",
-      "description": "Update or toggle a first-touch subscription."
-    },
-    {
-      "name": "madeonsol_first_touch_subscriptions_delete",
-      "description": "Delete a first-touch subscription."
-    },
-    {
-      "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": "Issue your WebSocket streaming token (Pro/Ultra) — never expires; same token on every call, rotate=true to replace it. Includes dex_ws_url on ULTRA."
-    },
-    {
-      "name": "madeonsol_stream_sessions_list",
-      "description": "List live WebSocket streaming sessions — id, service, tier, channels, connected_at, messages_sent (Pro/Ultra)."
-    },
-    {
-      "name": "madeonsol_stream_session_kill",
-      "description": "Evict a live WebSocket streaming session by id — frees its connection slot (Pro/Ultra)."
-    },
-    {
-      "name": "madeonsol_me",
-      "description": "Account/quota introspection — tier, remaining requests, per-feature usage."
-    },
-    {
-      "name": "madeonsol_discovery",
-      "description": "List all available endpoints with x402 prices (free, no auth)."
-    }
-  ],
-  "transports": [
-    "stdio",
-    "http"
-  ],
-  "runtime": "node"
-}
+{
+  "name": "mcp-server-madeonsol",
+  "maintainers": [
+    "madeonsol"
+  ],
+  "display_name": "MadeOnSol — Solana memecoin intelligence",
+  "description": "Real-time Solana memecoin trading intelligence — track 1,000+ KOL wallets with <3s latency on paid keys and x402 (free-tier live feeds are 5-min delayed), score 15,500+ Pump.fun deployers, 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": "1.26.0",
+  "homepage": "https://madeonsol.com/solana-api",
+  "repository": "https://github.com/madeonsol/mcp-server-madeonsol",
+  "license": "MIT",
+  "categories": [
+    "blockchain",
+    "finance",
+    "web3"
+  ],
+  "tags": [
+    "mcp",
+    "claude",
+    "cursor",
+    "solana",
+    "memecoin",
+    "kol",
+    "kol-tracker",
+    "alpha-bot",
+    "first-touch",
+    "coordination",
+    "deployer-hunter",
+    "pump-fun",
+    "copy-trade",
+    "smart-money",
+    "x402",
+    "micropayments",
+    "defi",
+    "trading",
+    "api"
+  ],
+  "tools": [
+    {
+      "name": "madeonsol_kol_feed",
+      "description": "Real-time Solana KOL trade feed from 1,000+ tracked wallets."
+    },
+    {
+      "name": "madeonsol_kol_coordination",
+      "description": "Multi-KOL convergence with 0-100 score, peak-density window, exits."
+    },
+    {
+      "name": "madeonsol_kol_leaderboard",
+      "description": "KOL PnL + win-rate rankings over today, 7d, 30d, 90d, 180d."
+    },
+    {
+      "name": "madeonsol_deployer_alerts",
+      "description": "Pump.fun deployer alerts with KOL enrichment, filter by tier."
+    },
+    {
+      "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 — average hold, win rate by hour."
+    },
+    {
+      "name": "madeonsol_deployer_trajectory",
+      "description": "Deployer skill curve — streaks, rolling bond rate, trend."
+    },
+    {
+      "name": "madeonsol_deployer_stats",
+      "description": "Ecosystem-wide Pump.fun deployer stats — tracked_count (how many deployers we grade), signals_today, bonds_detected, the chain-wide bond_..."
+    },
+    {
+      "name": "madeonsol_deployer_leaderboard",
+      "description": "Pump.fun deployer reputation leaderboard, ranked by bonding rate, recent form, total bonded, or last deploy."
+    },
+    {
+      "name": "madeonsol_deployer_profile",
+      "description": "One Pump.fun deployer's profile — tier, lifetime bonding_rate, recent_bond_rate, total deployed/bonded, first seen, last deploy, average..."
+    },
+    {
+      "name": "madeonsol_deployer_tokens",
+      "description": "Every token deployed by one Pump.fun wallet, paginated — each row with deployed_at, bonded_at, time-to-bond and peak market cap."
+    },
+    {
+      "name": "madeonsol_deployer_alert_stats",
+      "description": "Deployer alert volume over a lookback window, with bond-rate and market-cap-multiplier distributions (pct_2x / pct_5x / pct_10x / pct_50x..."
+    },
+    {
+      "name": "madeonsol_deployer_best_tokens",
+      "description": "Best-performing recent tokens launched by RANKED (non-unranked) Pump.fun deployers, by peak market cap multiple over the alert price."
+    },
+    {
+      "name": "madeonsol_deployer_recent_bonds",
+      "description": "Tokens from tracked Pump.fun deployers that just graduated to Raydium, newest first, each with time_to_bond_minutes, mc_at_bond, peak mar..."
+    },
+    {
+      "name": "madeonsol_kol_hot_tokens",
+      "description": "KOL momentum tokens — accelerating buy interest."
+    },
+    {
+      "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 with overlap analysis."
+    },
+    {
+      "name": "madeonsol_kol_alerts_recent",
+      "description": "Unified live KOL alert feed: clusters, fresh buys, heating-up wallets."
+    },
+    {
+      "name": "madeonsol_kol_pnl",
+      "description": "Deep per-wallet PnL: equity curve, risk metrics, closed + open positions."
+    },
+    {
+      "name": "madeonsol_kol_trending_tokens",
+      "description": "Tokens ranked by KOL buy volume across 5m–12h windows."
+    },
+    {
+      "name": "madeonsol_sniper_recent",
+      "description": "Deshred pre-confirm pump.fun deploy feed — new launches surface ~500ms before they confirm on-chain (reconstructed from shred-level data)."
+    },
+    {
+      "name": "madeonsol_sniper_by_deployer",
+      "description": "Deshred pre-confirm deploys filtered to a single deployer wallet — audit a deployer's recent launches before tracking them."
+    },
+    {
+      "name": "madeonsol_discovery",
+      "description": "List all available endpoints with x402 prices (free, no auth)."
+    },
+    {
+      "name": "madeonsol_wallet_tracker_watchlist",
+      "description": "List tracked wallets and remaining capacity (Free 10 / Pro 50 / Ultra 100)."
+    },
+    {
+      "name": "madeonsol_wallet_tracker_add",
+      "description": "Add a wallet to your watchlist with optional label."
+    },
+    {
+      "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 (120-day retention)."
+    },
+    {
+      "name": "madeonsol_wallet_tracker_summary",
+      "description": "Per-wallet stats: swap counts, SOL bought/sold, last event."
+    },
+    {
+      "name": "madeonsol_wallet_stats",
+      "description": "Aggregate stats for any Solana wallet over the last 90 days plus cross-product flags (is_kol, is_alpha_tracked with bot_confidence + win_..."
+    },
+    {
+      "name": "madeonsol_wallet_pnl",
+      "description": "Full FIFO cost-basis PnL for any wallet: realized + unrealized SOL, profit factor, max drawdown, avg + median hold minutes, daily UTC PnL..."
+    },
+    {
+      "name": "madeonsol_wallet_positions",
+      "description": "Open positions only for any wallet — lighter slice of madeonsol_wallet_pnl for use cases that don't need the full PnL summary or curve."
+    },
+    {
+      "name": "madeonsol_wallet_holdings",
+      "description": "Verified CURRENT on-chain holdings for any wallet — reads the wallet's actual SPL + Token-2022 token accounts and SOL balance directly fr..."
+    },
+    {
+      "name": "madeonsol_wallet_trades",
+      "description": "Cursor-paginated raw trades for any wallet."
+    },
+    {
+      "name": "madeonsol_wallet_batch_classify",
+      "description": "Bulk reputation flags for 1-100 wallets in one call — is_sniper/is_bundler/is_dumper/is_kol, bot_confidence (none/low/medium/high), dump_cluster cohorts. PRO+."
+    },
+    {
+      "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": "Issue your WebSocket streaming token (Pro/Ultra) — never expires; same token on every call, rotate=true to replace it. Includes dex_ws_url on ULTRA."
+    },
+    {
+      "name": "madeonsol_stream_sessions_list",
+      "description": "List live WebSocket streaming sessions — id, service, tier, channels, connected_at, messages_sent (Pro/Ultra)."
+    },
+    {
+      "name": "madeonsol_stream_session_kill",
+      "description": "Evict a live WebSocket streaming session by id — frees its connection slot (Pro/Ultra)."
+    },
+    {
+      "name": "madeonsol_me",
+      "description": "Account/quota introspection — tier, remaining requests, per-feature usage."
+    },
+    {
+      "name": "madeonsol_tokens_list",
+      "description": "Filtered token directory — MC band, liquidity, MEV-share, velocity, primary DEX, authority flags, momentum/trending sorts."
+    },
+    {
+      "name": "madeonsol_almost_bonded",
+      "description": "Pre-bond pump.fun tokens near graduation, ranked by velocity (Δprogress/min) — progress, eta, stalled, deployer tier."
+    },
+    {
+      "name": "madeonsol_alpha_leaderboard",
+      "description": "Top profitable early-buyer wallets — 25,000+ scored, up to 500 on ULTRA."
+    },
+    {
+      "name": "madeonsol_alpha_wallet",
+      "description": "Full alpha profile + bot-signal flags for one wallet."
+    },
+    {
+      "name": "madeonsol_alpha_linked",
+      "description": "Behaviorally linked wallets (co-bought 3+ tokens within 2s)."
+    },
+    {
+      "name": "madeonsol_token_cap_table",
+      "description": "First non-deployer early buyers for a token, enriched with PnL/KOL/bot flags."
+    },
+    {
+      "name": "madeonsol_token_buyer_quality",
+      "description": "0-100 buyer-quality score for a token's first-buyer cohort."
+    },
+    {
+      "name": "madeonsol_token_risk",
+      "description": "Transparent 0–100 token rug-risk/safety score (higher = riskier)."
+    },
+    {
+      "name": "madeonsol_token_bundle",
+      "description": "Bundle-cohort holdings for a token — which same-slot bundle wallets bought it and how much of supply they still hold (held_pct_of_supply)."
+    },
+    {
+      "name": "madeonsol_token_pools",
+      "description": "Per-venue liquidity map for a Solana token — every DEX pool it trades in (pump.fun/PumpSwap/Raydium/Meteora/Orca) with per-pool liquidity..."
+    },
+    {
+      "name": "madeonsol_token_holders",
+      "description": "Live holder census + concentration for a Solana token — WHO HOLDS NOW (madeonsol_token_cap_table is who bought first)."
+    },
+    {
+      "name": "madeonsol_token_locks",
+      "description": "Token locks & vesting on ONE Solana mint — every on-chain lock / vesting contract from Streamflow, Jupiter Lock and Bonfida token-vesting..."
+    },
+    {
+      "name": "madeonsol_token_locks_feed",
+      "description": "Cross-token feed of NEW token lock / vesting contracts — who just locked tokens, of what mint, how much, until when — newest first, acros..."
+    },
+    {
+      "name": "madeonsol_token_unlocks",
+      "description": "Upcoming token UNLOCK EVENTS across all active lock / vesting contracts inside a window — cliffs, periodic releases (hourly or coarser) a..."
+    },
+    {
+      "name": "madeonsol_token_fee_shares",
+      "description": "pump.fun creator-fee SHARING on one coin — who receives what share of its creator fees."
+    },
+    {
+      "name": "madeonsol_token_fee_claims",
+      "description": "pump.fun FEE-EVENT feed, newest first, across all coins: every decoded pump_fees / pump event — type = distribution (creator fees paid ou..."
+    },
+    {
+      "name": "madeonsol_tokens_surges",
+      "description": "Token surges & revivals — momentum fires with tape, KOL, early-buyer, deployer context and risk_flags[]; surge tiers early/strong/breakout vs launch MC, revivals confirmed by tape buys; +1 h outcomes and per-tier hit-rates. PRO+."
+    },
+    {
+      "name": "madeonsol_token_depth",
+      "description": "Per-pool price-impact / slippage for a token — answers 'how much SOL moves this token's price N%' and the impact of each buy size, per po..."
+    },
+    {
+      "name": "madeonsol_deployer_history",
+      "description": "A pump.fun deployer's daily reputation time-series (bonding_rate, recent_bond_rate, tier, avg_peak_mc per day)."
+    },
+    {
+      "name": "madeonsol_deployer_as_of",
+      "description": "A pump.fun deployer's reputation exactly as it stood on a given date — the latest write-on-change snapshot at or before it, so an agent b..."
+    },
+    {
+      "name": "madeonsol_deployer_rewards",
+      "description": "pump.fun creator-fee rewards for a wallet, answered two ways that are never merged: collected (what actually reached the wallet — direct..."
+    },
+    {
+      "name": "madeonsol_token_candles",
+      "description": "Historical OHLCV price candles for a token, aggregated from the on-chain trade firehose."
+    },
+    {
+      "name": "madeonsol_token_flow",
+      "description": "Trade-flow aggregate for a token — an organic-vs-fake volume read over a 1h/24h window."
+    },
+    {
+      "name": "madeonsol_token_trades",
+      "description": "Mint-scoped trade tape — cursor-paginated raw trades for one token, full history from 2026-04-12, pump.fun-pipeline scoped. PRO+."
+    },
+    {
+      "name": "madeonsol_tokens_batch_buyer_quality",
+      "description": "Bulk buyer-quality scoring — up to 50 mints per call."
+    },
+    {
+      "name": "madeonsol_tokens_batch_risk",
+      "description": "Bulk rug-risk/safety scoring — up to 50 mints per call, same shape as madeonsol_token_risk + as_of; untracked mints don't fail the batch."
+    },
+    {
+      "name": "madeonsol_token_get",
+      "description": "Single token detail — MC, holders, velocity, MEV-share, history age."
+    },
+    {
+      "name": "madeonsol_token_batch",
+      "description": "Bulk token detail fetch — up to 50 mints per call."
+    },
+    {
+      "name": "madeonsol_copytrade_list",
+      "description": "List your copy-trade rules."
+    },
+    {
+      "name": "madeonsol_copytrade_create",
+      "description": "Create a copy-trade rule with webhook + WS delivery (HMAC-signed)."
+    },
+    {
+      "name": "madeonsol_copytrade_get",
+      "description": "Get one copy-trade rule."
+    },
+    {
+      "name": "madeonsol_copytrade_update",
+      "description": "Update or toggle a copy-trade rule."
+    },
+    {
+      "name": "madeonsol_copytrade_delete",
+      "description": "Delete a copy-trade rule."
+    },
+    {
+      "name": "madeonsol_copytrade_signals",
+      "description": "Recent fired copy-trade signals (up to 7 days, 1-500)."
+    },
+    {
+      "name": "madeonsol_coordination_alerts_list",
+      "description": "List your KOL coordination alert rules (PRO=5, ULTRA=20)."
+    },
+    {
+      "name": "madeonsol_coordination_alerts_create",
+      "description": "Create a coordination alert rule — pg_notify push, sub-second delivery."
+    },
+    {
+      "name": "madeonsol_coordination_alerts_get",
+      "description": "Get one coordination alert rule."
+    },
+    {
+      "name": "madeonsol_coordination_alerts_update",
+      "description": "Update or toggle a coordination alert rule."
+    },
+    {
+      "name": "madeonsol_coordination_alerts_delete",
+      "description": "Delete a coordination alert rule."
+    },
+    {
+      "name": "madeonsol_kol_first_touches",
+      "description": "First-KOL-touch events — backtested scout signal, filter by tier S/A/B/C."
+    },
+    {
+      "name": "madeonsol_first_touch_subscriptions_list",
+      "description": "List your first-touch webhook subscriptions (ULTRA, up to 10)."
+    },
+    {
+      "name": "madeonsol_first_touch_subscriptions_create",
+      "description": "Create a first-touch webhook subscription — push on every S-tier scout buy."
+    },
+    {
+      "name": "madeonsol_first_touch_subscriptions_get",
+      "description": "Get one first-touch subscription."
+    },
+    {
+      "name": "madeonsol_first_touch_subscriptions_update",
+      "description": "Update or toggle a first-touch subscription."
+    },
+    {
+      "name": "madeonsol_first_touch_subscriptions_delete",
+      "description": "Delete a first-touch subscription."
+    },
+    {
+      "name": "madeonsol_price_alerts_list",
+      "description": "List your price alerts."
+    },
+    {
+      "name": "madeonsol_price_alerts_create",
+      "description": "Create a price alert."
+    },
+    {
+      "name": "madeonsol_price_alerts_get",
+      "description": "Get one price alert by id."
+    },
+    {
+      "name": "madeonsol_price_alerts_update",
+      "description": "Update alert name, delivery mode, webhook URL, or is_active."
+    },
+    {
+      "name": "madeonsol_price_alerts_delete",
+      "description": "Delete a price alert and its event history."
+    },
+    {
+      "name": "madeonsol_price_alerts_events",
+      "description": "Fired price alert event history (30-day retention)."
+    },
+    {
+      "name": "madeonsol_scout_leaderboard",
+      "description": "Scout leaderboard — top KOLs ranked by scout score, first-touch frequency, and swarm attraction rate (% of first-touched tokens that attr..."
+    },
+    {
+      "name": "madeonsol_coordination_history",
+      "description": "Coordination history — past coordination alert fires with token, coordination score, KOL count, and timing."
+    },
+    {
+      "name": "madeonsol_kol_consensus",
+      "description": "KOL consensus on a specific token: total buyers/sellers, exit rate, net SOL flow, median entry MC."
+    },
+    {
+      "name": "madeonsol_peak_history",
+      "description": "Peak MC history for a token: all-time high MC, decline from peak %, MC at bond, MC at 1h/6h/24h/7d after bond, time-to-bond, and deploy/b..."
+    },
+    {
+      "name": "madeonsol_signal_performance",
+      "description": "Signal performance stats for a named signal — hit rate, sample size, median outcome, and confidence window."
+    }
+  ],
+  "transports": [
+    "stdio",
+    "http"
+  ],
+  "runtime": "node"
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-server-madeonsol",
-  "version": "1.26.0",
+  "version": "1.27.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",
@@ -59,7 +59,7 @@
     "@x402/fetch": "^2.8.0",
     "@x402/core": "^2.8.0",
     "@x402/svm": "^2.8.0",
-    "@solana/kit": "^5.5.1",
+    "@solana/kit": ">=5.5.1 <9.0.0",
     "@scure/base": "^2.0.0"
   },
   "peerDependenciesMeta": {