mcp-server-madeonsol 1.18.0 → 1.20.0

package/README.md

@@ -13,6 +13,10 @@ 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, 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, every endpoint — no signup payment. Get a key at [madeonsol.com/pricing](https://madeonsol.com/pricing).
 
+> **New in 1.20.0** — **Token depth / price impact + deployer self-activity on risk.** New tool `madeonsol_token_depth` (`GET /tokens/{mint}/depth`) — per-pool price-impact / slippage: "how much SOL moves this token's price N%", per pool (NOT router-optimal). Pass up to 8 SOL buy `sizes` (each >0 and ≤10000; default `[0.5, 1, 5, 10]`); every computable pool returns `spot_price_sol`, `fee_pct`, a `quotes[]` entry per size (`size_sol`, `tokens_out`, `avg_price_sol`, `price_impact_pct`), and `to_move_price` — the SOL required to move price **1% / 5% / 10%**. Constant-product AMMs are served from stream reserves (`source: "stream"` with `reserves_age_ms`); pump.fun/bonk bonding curves from a **live** read of the curve's virtual reserves (`source: "live_rpc"`). Pools that can't be priced honestly — concentrated CLMM/Orca/DLMM, Meteora-DBC curves, unclassified models — come back in `unsupported_pools[]` with a `reason` (e.g. `concentrated_liquidity_depth_not_supported`, `curve_graduated_use_amm_pool`) instead of a wrong number; `primary_pool` names the deepest computable pool, `found: false` means no pools tracked. PRO/ULTRA only. And `madeonsol_token_risk` now returns a top-level **`dev` block** (deployer self-activity; `null` when the mint has no deployer-pipeline row): the create-tx self-buy snapshot (`buy_sol`, `buy_tokens`, `buy_supply_pct`), the post-create rollup (`bought_tokens_after` — catches the same-second-separate-tx dev buy the create snapshot reads as 0 — `sold_tokens`, `sold_sol`, `first_sell_at`/`last_sell_at`), **live on-chain holdings** (`holdings_tokens`, `holdings_supply_pct` — pump.fun 1B denominator, null elsewhere — `wallet_empty`: is the dev wallet empty NOW), and `transferred_out` (tokens left without a sell; `null` = unknown, never a guess), plus `as_of`. `deployer:alert` webhook/WS payloads gain `dev_buy_sol` + `dev_buy_supply_pct`.
+>
+> **New in 1.19.0** — **Batch wallet classification + token trade tape + bigger keyless catalog.** New tool `madeonsol_wallet_batch_classify` — reputation flags for 1–100 wallets in one call (counts as one request): per wallet `is_sniper` / `is_bundler` / `is_dumper` / `is_kol` (+ `kol_name`), `bot_confidence` (string enum `none`/`low`/`medium`/`high`, `null` when not alpha-tracked), and a `dump_cluster` block (`dump_cohorts`, `runner_cohorts`, `total_cohorts`, `as_of`). Flags are pump.fun-pipeline scoped — `false` = not observed, NOT verified clean; `is_bundler` is lifetime, `is_dumper` is a rolling 42d window. New tool `madeonsol_token_trades` — mint-scoped cursor-paginated trade tape (the backfill complement to the live firehose): `tx_signature`, `wallet_address`, `action`, `sol_amount`, `token_amount`, `price_sol`/`price_usd`, `early_buyer_rank`, `slot`, `block_time`, `traded_at`; filters `action` / `wallet` / `since`–`until` (default FULL history — capture starts 2026-04-12), plus a `coverage` honesty block. Both PRO/ULTRA. `madeonsol_wallet_stats` flags gain `is_sniper`/`is_bundler`/`is_dumper` + `dump_cluster`, and `bot_confidence` is now correctly typed as a string enum (it was documented as a number and always came back `null` due to a server bug — now returns real values). `madeonsol_token_risk` inputs and `madeonsol_sniper_recent` deploys gain the slot-window `sniper_footprint`/`footprint` rollup (`buys`, `buyers`, `sol`, `supply_pct`, `sniper_wallet_buys`, `data_available`, `as_of` — `null` = not observable, not zero). The **keyless x402 catalog grows 18 → 25 endpoints**: token candles ($0.01), almost-bonded ($0.01), top-traders ($0.02), cap-table ($0.02), sniper recent ($0.01), token flow ($0.01), deployer trajectory ($0.01) — `madeonsol_sniper_recent` and `madeonsol_deployer_trajectory` now work keyless via x402 too.
+>
 > **New in 1.18.0** — **Verified on-chain wallet holdings.** New tool `madeonsol_wallet_holdings` — the wallet's CURRENT holdings read straight from chain: its actual SPL + Token-2022 token accounts and SOL balance, each enriched with our `price_usd` / `value_usd` / `market_cap_usd` / `name` / `symbol` / `is_bonded`, plus `transfer_delta` (on-chain amount − trade-derived net position — exposes non-swap flows like airdrops, insider funding, and wallet-hopping). Distinct from `madeonsol_wallet_positions` (trade-derived FIFO): this is what the wallet *actually* holds right now. Params: `limit` (1–500, default 200), `min_value_usd` (default 0). Returns `{ address, sol_balance, holdings[], summary, verified_at, trade_window_days, cache_hit, ttl_seconds }`. ULTRA only.
 >
 > **New in 1.17.0** — **Bundle-cohort holdings.** New tool `madeonsol_token_bundle` — which same-slot "bundle" wallets bought a token and how much of supply they *still* hold (the incumbents' "current held %" rug/insider signal, from confirmed on-chain data). Returns a `bundle` block (`wallet_count`, `bundle_kind` atomic_tx/same_slot/none, `held_ratio`, `held_pct_of_supply` — the headline, net held / circulating supply, null if unknown — `fully_exited`, `buy_volume`, `tokens_held`) plus a `wallets[]` array (`rank`, `wallet`, `held_ratio`, `has_sold`, `atomic`, `is_kol`). BASIC get the bundle block only (empty `wallets[]`); PRO adds top-10 flags-only wallets; ULTRA returns the full cohort with enriched identities (`kol_name`, `win_rate`, `bot_confidence`, `tokens_held`).
@@ -91,6 +95,7 @@ Building an autonomous agent? Skip the signup. Point a **funded Solana wallet**
 How it works:
 
 - The wallet behind `SVM_PRIVATE_KEY` settles each request as a **USDC micropayment on Solana** (~$0.005–$0.02 per call, settled on-chain). No subscription, no quota.
+- The keyless catalog covers **25 endpoints** — the latest 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).
 - The free **`madeonsol_discovery`** tool needs no auth and returns every endpoint with its exact per-call price — call it first to see what each tool costs.
 - Install the x402 peer deps alongside the server (only required for this mode):
 
@@ -174,7 +179,7 @@ Pre-confirm pump.fun deploy feed reconstructed from shred-level (**deshred**) da
 
 | Tool | Description |
 |---|---|
-| `madeonsol_sniper_recent` | Newest-first deshred deploy feed. Pro: elite/good · Ultra: all tiers. `watchlist: true` (Ultra) narrows to your custom deployer watchlist |
+| `madeonsol_sniper_recent` | Newest-first deshred deploy feed. Pro: elite/good · Ultra: all tiers · keyless x402: $0.01 (elite/good). `watchlist: true` (Ultra) narrows to your custom deployer watchlist. **New 1.19:** each deploy carries `footprint` — the slot-window snipe rollup (`buys`, `buyers`, `sol`, `supply_pct`, `sniper_wallet_buys`, `data_available`, `as_of`) or `null` when not yet settled/observable |
 | `madeonsol_sniper_by_deployer` | Deshred deploys for a single deployer wallet (Ultra) |
 
 ### Wallet Tracker
@@ -191,7 +196,8 @@ Pre-confirm pump.fun deploy feed reconstructed from shred-level (**deshred**) da
 
 | Tool | Description |
 |---|---|
-| `madeonsol_wallet_stats` | Aggregate 90d stats + cross-product flags (is_kol, is_alpha_tracked + bot_confidence + win_rate + net_pnl, is_deployer + tokens_deployed) — quick sizing-up of an unknown wallet |
+| `madeonsol_wallet_stats` | Aggregate 90d stats + cross-product flags (is_kol, is_alpha_tracked + bot_confidence `none`/`low`/`medium`/`high`, is_deployer + tokens_deployed, **new 1.19:** is_sniper / is_bundler / is_dumper + `dump_cluster` cohorts) — quick sizing-up of an unknown wallet |
+| `madeonsol_wallet_batch_classify` | **New 1.19** · Bulk reputation flags for 1–100 wallets in one call — is_sniper/is_bundler/is_dumper/is_kol + kol_name, bot_confidence, dump_cluster. Pump.fun-pipeline scoped: `false` = not observed, not verified clean |
 | `madeonsol_wallet_pnl` | Full FIFO cost-basis PnL: realized + unrealized SOL, profit factor, max drawdown, avg + median hold minutes, daily UTC PnL curve, closed + open positions hydrated with live mc-tracker prices |
 | `madeonsol_wallet_positions` | Open positions only — lighter slice of /pnl. Shares the same cache. |
 | `madeonsol_wallet_holdings` | **New 1.18** · Verified CURRENT on-chain holdings (real SPL + Token-2022 accounts + SOL) enriched with price/MC/name, plus `transfer_delta` vs trade-derived position. ULTRA only. |
@@ -217,12 +223,14 @@ Scored from 1M+ early-buyer records (wallets seen in the first 20 buyers of Pump
 | `madeonsol_almost_bonded` | PRO+ | Pre-bond pump.fun tokens near graduation, ranked by velocity (Δprogress/min) — `progress_pct`, `velocity_pct_per_min`, `eta_minutes`, `stalled`, `deployer_tier`, `age_minutes` |
 | `madeonsol_token_cap_table` | PRO+ | First non-deployer early buyers, enriched with PnL/KOL/bot flags. PRO=10, ULTRA=20 |
 | `madeonsol_token_buyer_quality` | All | 0–100 buyer-quality score + full breakdown (5-min cached) |
-| `madeonsol_token_risk` | PRO+ | Transparent 0–100 rug-risk/safety score with `band`, explainable `factors[]`, and raw `inputs` |
+| `madeonsol_token_risk` | PRO+ | Transparent 0–100 rug-risk/safety score with `band`, explainable `factors[]`, and raw `inputs` (**new 1.19:** `inputs.sniper_footprint` — slot-window snipe rollup, `null` = not observable; **new 1.20:** top-level `dev` block — deployer self-buy at create, sells rollup, live on-chain holdings, `wallet_empty`, `transferred_out`) |
 | `madeonsol_token_bundle` | All | Bundle-cohort holdings — which same-slot bundle wallets bought a token and how much of supply they still hold (`held_pct_of_supply` headline, plus `bundle_kind`, `held_ratio`, `fully_exited`). BASIC: bundle block only. PRO: top-10 flags. ULTRA: full cohort + identities |
 | `madeonsol_token_pools` | PRO+ | Per-venue liquidity map — every DEX pool a token trades in (pump.fun/PumpSwap/Raydium/Meteora/Orca) with per-pool `liquidity_usd`, `is_active` (live vs parked), plus a `summary` (pool/DEX counts, `total_liquidity_usd`, `primary_pool`, `top_pool_share_pct` concentration) |
+| `madeonsol_token_depth` | **New 1.20** · PRO+ | Per-pool price impact / slippage — `quotes[]` per SOL buy size (`tokens_out`, `avg_price_sol`, `price_impact_pct`) + `to_move_price` (SOL to move price 1%/5%/10%). `sizes` max 8, default `[0.5, 1, 5, 10]`; unsupported pools (CLMM/DLMM/DBC) flagged with a `reason` |
 | `madeonsol_tokens_batch_risk` | PRO+ | Bulk rug-risk/safety scoring for up to 50 mints — same shape as `madeonsol_token_risk` + `as_of`. Untracked mints return `{ mint, error: "not_tracked" }` without failing the batch; counts as one request |
 | `madeonsol_token_candles` | PRO+ | Historical OHLCV candles (1m–1d). PRO=OHLCV 30d; ULTRA=+net flow, liquidity delta, MEV volume, full history |
 | `madeonsol_token_flow` | PRO+ | Trade-flow aggregate (organic-vs-fake volume) over a 1h/24h `window` — unique wallets/buyers/sellers, buy/sell counts + SOL, `net_sol`, `trades_per_wallet` wash-trading proxy |
+| `madeonsol_token_trades` | **New 1.19** · PRO+ | Mint-scoped trade tape — cursor-paginated raw trades for one token (action / wallet / since–until filters, default FULL history). History starts 2026-04-12; `coverage` block marks scope |
 
 ### Copy-Trade Rules (PRO/ULTRA)
 

package/dist/index.js

@@ -210,20 +210,11 @@ function registerTools(server) {
         }
         return { content: [{ type: "text", text: "KOL timing requires MADEONSOL_API_KEY (msk_) — get one free at madeonsol.com/pricing." }] };
     });
-    server.tool("madeonsol_deployer_trajectory", "Deployer skill curve — streaks, rolling bond rate, improvement trend, and deployment cadence for a Pump.fun deployer.", {
+    server.tool("madeonsol_deployer_trajectory", "Deployer skill curve — streaks, rolling bond rate, improvement trend, and deployment cadence for a Pump.fun deployer. Works with an msk_ key (Pro/Ultra) or keyless via x402 ($0.01/call).", {
         wallet: z.string().describe("Deployer wallet address (base58)"),
-    }, readOnlyAnnotations, async ({ wallet }) => {
-        if (authMode === "madeonsol") {
-            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 MADEONSOL_API_KEY (msk_, Pro/Ultra) — get one at madeonsol.com/pricing." }] };
-    });
+    }, readOnlyAnnotations, async ({ wallet }) => ({
+        content: [{ type: "text", text: await query(`/api/x402/deployer-hunter/${encodeURIComponent(wallet)}/trajectory`) }],
+    }));
     server.tool("madeonsol_kol_hot_tokens", "KOL momentum tokens — tokens with accelerating KOL buy interest, early signals before coordination triggers. PRO+ adds buyer-quality filters.", {
         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"),
@@ -284,30 +275,23 @@ function registerTools(server) {
     }, readOnlyAnnotations, async ({ period, min_kols, limit }) => ({
         content: [{ type: "text", text: await query("/api/x402/kol/tokens/trending", { period, min_kols, limit }) }],
     }));
-    server.tool("madeonsol_sniper_recent", "Deshred pre-confirm pump.fun deploy feed — new launches surface ~500ms before they confirm on-chain (reconstructed from shred-level data). PRO sees elite/good deployers; ULTRA sees every tier. Requires a Pro/Ultra msk_ API key.", {
+    server.tool("madeonsol_sniper_recent", "Deshred pre-confirm pump.fun deploy feed — new launches surface ~500ms before they confirm on-chain (reconstructed from shred-level data). Each deploy now carries footprint — the slot-window snipe rollup ({ buys, buyers, sol, supply_pct|null, sniper_wallet_buys, data_available, as_of } | null; buys in slots deploy-1..deploy+3). footprint is null for deploys younger than the ~10-min settle window or outside the trade-pipeline write-gate — absent, not zero. PRO (msk_ key) sees elite/good deployers; ULTRA sees every tier; also callable keyless via x402 ($0.01/call, elite/good scope).", {
         deployer_tier: z.enum(["elite", "good", "moderate", "rising", "cold", "unranked"]).optional().describe("Filter by deployer reputation tier (ULTRA)"),
         min_bond_rate: z.number().min(0).max(1).optional().describe("Minimum deployer lifetime bond rate (0-1)"),
         since: z.string().optional().describe("ISO-8601 — only deploys detected after this timestamp"),
-        watchlist: z.boolean().optional().describe("ULTRA: narrow to your custom deployer watchlist (any tier)"),
+        watchlist: z.boolean().optional().describe("ULTRA (msk_ key only): narrow to your custom deployer watchlist (any tier)"),
         limit: z.number().min(1).max(200).default(50).describe("Max results"),
     }, readOnlyAnnotations, async ({ deployer_tier, min_bond_rate, since, watchlist, limit }) => {
-        if (authMode !== "madeonsol")
-            return { content: [{ type: "text", text: "Sniper feed requires MADEONSOL_API_KEY (msk_, Pro/Ultra) — get one at madeonsol.com/pricing." }] };
-        const qs = new URLSearchParams({ limit: String(limit) });
+        const params = { limit };
         if (deployer_tier)
-            qs.set("deployer_tier", deployer_tier);
+            params.deployer_tier = deployer_tier;
         if (min_bond_rate != null)
-            qs.set("min_bond_rate", String(min_bond_rate));
+            params.min_bond_rate = min_bond_rate;
         if (since)
-            qs.set("since", since);
+            params.since = since;
         if (watchlist)
-            qs.set("watchlist", "true");
-        const res = await fetch(`${BASE_URL}/api/v1/sniper/recent?${qs}`, { 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) }] };
+            params.watchlist = "true";
+        return { content: [{ type: "text", text: await query("/api/x402/sniper/recent", params) }] };
     });
     server.tool("madeonsol_sniper_by_deployer", "Deshred pre-confirm deploys filtered to a single deployer wallet — audit a deployer's recent launches before tracking them. ULTRA only.", {
         wallet: z.string().describe("Deployer wallet address (base58)"),
@@ -322,7 +306,7 @@ function registerTools(server) {
         }
         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.", {}, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }, async () => {
+    server.tool("madeonsol_discovery", "List all available MadeOnSol API endpoints with prices and parameter docs. Free, no auth required. 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();
         return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
@@ -397,7 +381,7 @@ function registerTools(server) {
                 return { content: [{ type: "text", text }] };
             });
             // ── Universal wallet endpoints (PRO+, any wallet — not just curated KOLs) ──
-            server.tool("madeonsol_wallet_stats", "Aggregate stats for any Solana wallet over the last 90 days plus cross-product flags (is_kol, is_alpha_tracked with bot_confidence + win_rate + net_pnl, is_deployer with tokens_deployed + bonding_rate). Use this before drilling into PnL to size up an unknown wallet quickly. PRO+.", {
+            server.tool("madeonsol_wallet_stats", "Aggregate stats for any Solana wallet over the last 90 days plus cross-product flags (is_kol, is_alpha_tracked with bot_confidence + win_rate + net_pnl, is_deployer with tokens_deployed + bonding_rate). flags now also carries reputation flags — is_sniper, is_bundler, is_dumper — plus a dump_cluster block ({ dump_cohorts, runner_cohorts, total_cohorts, as_of } | null). bot_confidence is a string enum 'none'|'low'|'medium'|'high' (null when not alpha-tracked; earlier versions documented it as a number and it always serialized null — fixed). Scope caveat: reputation flags are pump.fun-pipeline scoped — false = not observed, NOT verified clean; is_bundler is lifetime, is_dumper is a rolling 42d window. Use this before drilling into PnL to size up an unknown wallet quickly. PRO+.", {
                 address: z.string().describe("Solana wallet address (base58)"),
             }, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async ({ address }) => {
                 const res = await fetch(`${BASE_URL}/api/v1/wallet/${encodeURIComponent(address)}`, {
@@ -461,8 +445,13 @@ function registerTools(server) {
                 const text = res.ok ? JSON.stringify(await res.json(), null, 2) : `Error ${res.status}: ${await res.text().catch(() => "")}`;
                 return { content: [{ type: "text", text }] };
             });
+            server.tool("madeonsol_wallet_batch_classify", "Bulk wallet reputation flags for 1-100 wallets in ONE call (counts as one request). Per wallet: is_sniper / is_bundler / is_dumper / is_kol (+ kol_name), bot_confidence (string enum 'none'|'low'|'medium'|'high', null when the wallet isn't alpha-tracked), and dump_cluster ({ dump_cohorts, runner_cohorts, total_cohorts, as_of } | null). Same semantics as the flags block on madeonsol_wallet_stats. IMPORTANT scope caveat: all three reputation flags derive from the pump.fun trade pipeline — false means 'not observed', NOT verified clean. is_sniper is behavior-updated (~12min cron) and can clear if the wallet reforms; is_bundler is a LIFETIME flag (bought >1 token in the same block, ever); is_dumper uses a rolling 42-day window (recomputed daily, up to ~48h stale). Response: { wallets[], count, as_of }. PRO/ULTRA only.", {
+                wallets: z.array(z.string()).min(1).max(100).describe("1-100 base58 Solana wallet addresses"),
+            }, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async ({ wallets }) => ({
+                content: [{ type: "text", text: await walletTrackerRequest("POST", "/wallet/batch/classify", { wallets }) }],
+            }));
             console.error("[madeonsol-mcp] Wallet tracker tools enabled");
-            console.error("[madeonsol-mcp] Universal wallet tools enabled (stats / pnl / positions / holdings / trades)");
+            console.error("[madeonsol-mcp] Universal wallet tools enabled (stats / pnl / positions / holdings / trades / batch classify)");
         }
         else {
             console.error("[madeonsol-mcp] Wallet tracker tools disabled (requires MADEONSOL_API_KEY)");
@@ -608,7 +597,7 @@ function registerTools(server) {
         server.tool("madeonsol_token_buyer_quality", "0–100 buyer-quality score for a token's first-buyer cohort. 5-min cached. Full breakdown on all tiers, incl. dump_cluster_count (3+ dump-cluster wallets in the first-20 → 94% historical dump rate vs 61% base) and recycled_early_buyer_count.", { 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_token_risk", "Transparent 0–100 token rug-risk/safety score (higher = riskier). Returns a band (safe/caution/danger), an explainable factors[] array (mint authority, freeze authority, liquidity, transfer fee, token-2022, burn, launch cohort, deployer bond rate, KOL signal, blacklist) each with status/points/detail, and the raw inputs that produced the score. PRO/ULTRA only — BASIC receives HTTP 403.", { mint: z.string().describe("Token mint address (base58)") }, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async ({ mint }) => ({
+        server.tool("madeonsol_token_risk", "Transparent 0–100 token rug-risk/safety score (higher = riskier). Returns a band (safe/caution/danger), an explainable factors[] array (mint authority, freeze authority, liquidity, transfer fee, token-2022, burn, launch cohort, deployer bond rate, KOL signal, blacklist) each with status/points/detail, and the raw inputs that produced the score. inputs now includes sniper_footprint — the slot-window launch-snipe rollup ({ buys, buyers, sol, supply_pct|null, sniper_wallet_buys, data_available, as_of } | null; buys landing in slots deploy-1..deploy+3). data_available=false means the mint isn't observable in the trade pipeline — NOT zero snipes; null means no rollup yet. Also returns a top-level dev block (deployer self-activity, null when the mint has no deployer-pipeline row): wallet, launchpad, deployed_at, create-tx self-buy snapshot (buy_sol / buy_tokens / buy_supply_pct), post-create rollup (bought_tokens_after — catches the same-second-separate-tx dev buy — sold_tokens, sold_sol, first_sell_at, last_sell_at), LIVE on-chain holdings (holdings_tokens, holdings_supply_pct — pump.fun 1B denominator, null elsewhere — wallet_empty: is the dev wallet empty NOW), and transferred_out (tokens left without a sell; null = unknown, never a guess). PRO/ULTRA only — BASIC receives HTTP 403.", { 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)}/risk`) }],
         }));
         server.tool("madeonsol_token_bundle", "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). Rug/insider signal. Returns a `bundle` block (wallet_count, bundle_kind atomic_tx/same_slot/none, held_ratio, held_pct_of_supply [the headline — net held / circulating supply, null if unknown], fully_exited, buy_volume, tokens_held) plus a `wallets[]` array (rank, wallet, held_ratio, has_sold, atomic, is_kol). BASIC get the bundle block only (empty wallets[]); PRO adds top-10 flags-only wallets; ULTRA returns the full cohort with enriched identities (kol_name, win_rate, bot_confidence, tokens_held).", { mint: z.string().describe("Token mint address (base58)") }, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async ({ mint }) => ({
@@ -617,6 +606,18 @@ function registerTools(server) {
         server.tool("madeonsol_token_pools", "Per-venue liquidity map for a Solana token — every DEX pool it trades in (pump.fun/PumpSwap/Raydium/Meteora/Orca) with per-pool liquidity, live vs parked (is_active), plus a summary (total liquidity, pool/DEX counts, primary/deepest pool, top_pool_share_pct concentration). Shows WHERE liquidity sits and how fragmented it is, vs the single aggregate number from the token endpoint.", { 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)}/pools`) }],
         }));
+        server.tool("madeonsol_token_depth", "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 pool (NOT router-optimal). Each computable pool returns spot_price_sol, fee_pct, a quotes[] entry per requested SOL size (size_sol, tokens_out, avg_price_sol, price_impact_pct), and to_move_price — the SOL required to move price 1%/5%/10%. Constant-product AMMs are served from stream reserves (source=stream, with reserves_age_ms); pump.fun/bonk bonding curves from a LIVE read of the curve's virtual reserves (source=live_rpc). Pools that can't be priced honestly — concentrated CLMM/Orca/DLMM, Meteora-DBC curves, unclassified models — come back in unsupported_pools[] with a reason (e.g. concentrated_liquidity_depth_not_supported, curve_graduated_use_amm_pool) instead of a wrong number. primary_pool = deepest computable pool; found=false means no pools tracked. PRO/ULTRA only — BASIC receives HTTP 403.", {
+            mint: z.string().describe("Token mint address (base58)"),
+            sizes: z.array(z.number().gt(0).max(10000)).min(1).max(8).optional()
+                .describe("SOL buy sizes to quote (max 8, each >0 and ≤10000). Default [0.5, 1, 5, 10]"),
+        }, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async ({ mint, sizes }) => {
+            const qs = new URLSearchParams();
+            if (sizes && sizes.length > 0)
+                qs.set("sizes", sizes.join(","));
+            const query = qs.toString();
+            const path = `/tokens/${encodeURIComponent(mint)}/depth${query ? `?${query}` : ""}`;
+            return { content: [{ type: "text", text: await restQuery("GET", path) }] };
+        });
         server.tool("madeonsol_deployer_history", "A pump.fun deployer's daily reputation time-series (bonding_rate, recent_bond_rate, tier, avg_peak_mc per day). Lets an agent answer 'was this deployer elite AT THE TIME it launched token X?' — backtest deployer signals without look-ahead bias.", {
             wallet: z.string().describe("Deployer wallet address (base58)"),
             limit: z.number().min(1).max(365).default(90).describe("Number of daily snapshots to return (1-365, default 90)"),
@@ -659,6 +660,31 @@ function registerTools(server) {
             const path = `/tokens/${encodeURIComponent(mint)}/flow${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, early_buyer_rank|null, slot|null, block_time (unix sec), traded_at (ISO). 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)"),
+            cursor: z.string().optional().describe("Cursor from previous response's next_cursor field"),
+            action: z.enum(["buy", "sell"]).optional().describe("Filter to buys or sells only"),
+            wallet: z.string().optional().describe("Filter to a single wallet address (base58)"),
+            since: z.number().optional().describe("Unix epoch seconds — default full history (2026-04-12 onward)"),
+            until: z.number().optional().describe("Unix epoch seconds — default now"),
+        }, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async ({ mint, limit, cursor, action, wallet, since, until }) => {
+            const url = new URL(`${BASE_URL}/api/v1/tokens/${encodeURIComponent(mint)}/trades`);
+            url.searchParams.set("limit", String(limit));
+            if (cursor)
+                url.searchParams.set("cursor", cursor);
+            if (action)
+                url.searchParams.set("action", action);
+            if (wallet)
+                url.searchParams.set("wallet", wallet);
+            if (since !== undefined)
+                url.searchParams.set("since", String(since));
+            if (until !== undefined)
+                url.searchParams.set("until", String(until));
+            const res = await fetch(url.toString(), { headers: { "Content-Type": "application/json", ...apiKeyHeaders() } });
+            const text = res.ok ? JSON.stringify(await res.json(), null, 2) : `Error ${res.status}: ${await res.text().catch(() => "")}`;
+            return { content: [{ type: "text", text }] };
+        });
         server.tool("madeonsol_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 }) }],
         }));
@@ -1019,7 +1045,8 @@ async function main() {
                         { 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_wallet_stats", description: "Aggregate stats + cross-product flags (is_kol/alpha/deployer) for any Solana wallet. PRO+." },
+                        { name: "madeonsol_wallet_stats", description: "Aggregate stats + cross-product flags (is_kol/alpha/deployer, is_sniper/is_bundler/is_dumper + dump_cluster) for any Solana wallet. PRO+." },
+                        { 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, dump_cluster. PRO+." },
                         { name: "madeonsol_wallet_pnl", description: "Full FIFO cost-basis PnL for any wallet: realized + unrealized, profit factor, drawdown, daily curve, closed + open positions. PRO+." },
                         { name: "madeonsol_wallet_positions", description: "Open positions only for any wallet — lighter slice of /pnl. Live unrealized SOL from mc-tracker. PRO+." },
                         { name: "madeonsol_wallet_trades", description: "Cursor-paginated raw trades for any wallet. Filter by action / token_mint / time window. PRO+." },
@@ -1028,7 +1055,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_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_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+." },
                         { name: "madeonsol_token_get", description: "Comprehensive per-mint snapshot: price, MC, volume, deployer, KOL, age, blacklist." },

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "1.18.0";
+export declare const VERSION = "1.20.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.18.0";
+export const VERSION = "1.20.0";

package/glama.json

@@ -1,13 +1,19 @@
 {
   "name": "mcp-server-madeonsol",
-  "maintainers": ["madeonsol"],
+  "maintainers": [
+    "madeonsol"
+  ],
   "display_name": "MadeOnSol — Solana memecoin intelligence",
-  "description": "Real-time Solana memecoin trading intelligence — track 1,000+ KOL wallets with <3s latency, 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; auth via msk_ API key or x402 micropayments.",
-  "version": "1.16.0",
+  "description": "Real-time Solana memecoin trading intelligence — track 1,000+ KOL wallets with <3s latency, 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, no payment to start; auth via msk_ API key or x402 micropayments. New customers get a 5-day free trial of Pro or Ultra by card — nothing charged during the trial, cancel anytime.",
+  "version": "1.20.0",
   "homepage": "https://madeonsol.com/solana-api",
   "repository": "https://github.com/madeonsol/mcp-server-madeonsol",
   "license": "MIT",
-  "categories": ["blockchain", "finance", "web3"],
+  "categories": [
+    "blockchain",
+    "finance",
+    "web3"
+  ],
   "tags": [
     "mcp",
     "claude",
@@ -30,62 +36,238 @@
     "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_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_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 a 24h WebSocket streaming token (Pro/Ultra). 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)." }
+    {
+      "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_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 a 24h WebSocket streaming token (Pro/Ultra). 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"
   ],
-  "transports": ["stdio", "http"],
   "runtime": "node"
 }

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "mcp-server-madeonsol",
-  "version": "1.18.0",
+  "version": "1.20.0",
   "mcpName": "io.github.MadeOnSol/madeonsol",
-  "description": "MCP server for MadeOnSol Solana KOL intelligence API — use from Claude, Cursor, or any MCP client",
+  "description": "MCP server for MadeOnSol Solana KOL intelligence API — use from Claude, Cursor, or any MCP client. Free tier 200 req/day, no payment to start; new customers get a 5-day free trial of Pro or Ultra by card.",
   "type": "module",
   "bin": {
     "mcp-server-madeonsol": "dist/index.js"