mcp-server-madeonsol 1.6.0 → 1.7.2

package/README.md

@@ -2,9 +2,9 @@
 
 MCP server for [MadeOnSol](https://madeonsol.com) Solana KOL intelligence API. Use from Claude Desktop, Cursor, or any MCP-compatible client.
 
-> Real-time Solana trading intelligence: track 1,000+ KOL wallets with <3s latency, score 6,700+ Pump.fun deployers by reputation, detect multi-KOL coordination signals, monitor any Solana wallet for swaps and transfers, and stream every DEX trade. Free tier: 200 requests/day at [madeonsol.com/developer](https://madeonsol.com/developer) — no credit card required.
+> Real-time Solana trading intelligence: track 1,000+ KOL wallets with <3s latency, score 6,700+ Pump.fun deployers by reputation, detect multi-KOL coordination signals, monitor any Solana wallet for swaps and transfers, and stream every DEX trade. Free tier: 200 requests/day at [madeonsol.com/pricing](https://madeonsol.com/pricing) — no credit card required.
 
-> **New in 1.6.0** *(2026-05-09)* — **Market-cap filtering everywhere.** `madeonsol_kol_feed`, `madeonsol_kol_coordination`, `madeonsol_kol_first_touches`, and `madeonsol_copytrade_signals` all accept `min_mc_usd` / `max_mc_usd` so the assistant can ask "show me sub-$50K KOL trades" without post-filtering. Tool descriptions updated. Deprecated `avg_entry_mc_usd` removed from leaderboards.
+> **New in 1.7.0** *(2026-05-12)* — Two new tools: **`madeonsol_me`** (account/quota introspection — read tier, remaining requests, and per-feature usage without parsing rate-limit headers) and **`madeonsol_tokens_list`** (PRO+ filtered, sortable token directory — MC band, liquidity floor, primary DEX, authority/safety flags, plus computed 1h volume / MEV-share / MC-change deltas). Token responses now expose **velocity / MEV-share** fields. Token directory defaults to **`min_liq=2000`** to skip phantom-MC dust — pass `min_liq=0` to opt out. `/token/{mint}` now returns **structured 400 errors** (`code` / `reason` / `example` / `docs`) instead of plain strings. Deprecated `avg_entry_mc_usd` field fully removed from KOL/alpha leaderboards.
 
 ## Quick start (10 seconds)
 
@@ -12,7 +12,7 @@ MCP server for [MadeOnSol](https://madeonsol.com) Solana KOL intelligence API. U
 npm install -g mcp-server-madeonsol
 ```
 
-Add to `claude_desktop_config.json` or Cursor MCP settings (free key: https://madeonsol.com/developer):
+Add to `claude_desktop_config.json` or Cursor MCP settings (free tier at https://madeonsol.com/pricing):
 
 ```json
 { "mcpServers": { "madeonsol": { "command": "mcp-server-madeonsol", "env": { "MADEONSOL_API_KEY": "msk_..." } } } }
@@ -26,10 +26,10 @@ Two options (in priority order):
 
 | Method | Env var | Best for |
 |---|---|---|
-| **MadeOnSol API key** (recommended) | `MADEONSOL_API_KEY` | Developers — [get a free key](https://madeonsol.com/developer) |
+| **MadeOnSol API key** (recommended) | `MADEONSOL_API_KEY` | Developers — [get a free key](https://madeonsol.com/pricing) |
 | x402 micropayments | `SVM_PRIVATE_KEY` | AI agents with Solana wallets |
 
-> **v1.0 breaking change:** RapidAPI auth (`RAPIDAPI_KEY`) has been removed. The MadeOnSol RapidAPI marketplace was retired on 2026-04-19. Get a free `msk_` key at [madeonsol.com/developer](https://madeonsol.com/developer).
+> **v1.0 breaking change:** RapidAPI auth (`RAPIDAPI_KEY`) has been removed. The MadeOnSol RapidAPI marketplace was retired on 2026-04-19. Get a free `msk_` key at [madeonsol.com/pricing](https://madeonsol.com/pricing).
 
 ## Install
 
@@ -109,6 +109,7 @@ Scored from 47,000+ early-buyer records (wallets seen in the first 20 buyers of
 
 | Tool | Tier | Description |
 |---|---|---|
+| `madeonsol_tokens_list` | PRO+ | Filtered, sortable token directory — MC band, liquidity floor, primary DEX, authority/safety flags, computed 1h volume / MEV-share / MC-change deltas. Default `min_liq=2000` skips phantom-MC dust. |
 | `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) |
 
@@ -169,6 +170,7 @@ Every "first KOL buy on a token mint" event. Filterable by **scout tier** (S/A/B
 | Tool | Description |
 |---|---|
 | `madeonsol_discovery` | List all endpoints and prices (free, no auth) |
+| `madeonsol_me` | Inspect your account — tier, daily/burst quota state, remaining requests, subscription expiry, per-feature usage (webhooks, copy-trade wallets, coordination rules, etc.). Self-throttle without parsing rate-limit headers. |
 
 ## Tiers
 
@@ -178,7 +180,7 @@ Every "first KOL buy on a token mint" event. Filterable by **scout tier** (S/A/B
 | Pro | $49/mo | 50 | 10,000 |
 | Ultra | $149/mo | 100 + WS events | 100,000 |
 
-Free tier returns the full REST response shape on every endpoint — real wallets, TX signatures, full precision. Paid tiers unlock webhooks, WebSockets, rule engines, and ULTRA-only data depth. Get a key at [madeonsol.com/developer](https://madeonsol.com/developer).
+Free tier returns the full REST response shape on every endpoint — real wallets, TX signatures, full precision. Paid tiers unlock webhooks, WebSockets, rule engines, and ULTRA-only data depth. Get a key at [madeonsol.com/pricing](https://madeonsol.com/pricing).
 
 ## Also Available
 

package/dist/index.js

@@ -5,7 +5,7 @@ import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/
 import { z } from "zod";
 import { createServer } from "node:http";
 const BASE_URL = process.env.MADEONSOL_API_URL || "https://madeonsol.com";
-const MADEONSOL_API_KEY = process.env.MADEONSOL_API_KEY; // Native key from madeonsol.com/developer
+const MADEONSOL_API_KEY = process.env.MADEONSOL_API_KEY; // Native key from madeonsol.com/pricing
 const PRIVATE_KEY = process.env.SVM_PRIVATE_KEY; // x402 micropayments (for AI agents)
 const PORT = parseInt(process.env.PORT || "3100", 10);
 const MODE = process.env.MCP_TRANSPORT || "stdio"; // "stdio" or "http"
@@ -43,7 +43,7 @@ async function initAuth() {
         }
     }
     console.error("\n[madeonsol-mcp] No auth configured — every tool call will fail.\n" +
-        "  → Get a free MADEONSOL_API_KEY (200 req/day, no card) at https://madeonsol.com/developer\n" +
+        "  → Get a free MADEONSOL_API_KEY (200 req/day, no card) at https://madeonsol.com/pricing\n" +
         "  → Or set SVM_PRIVATE_KEY for x402 micropayments.\n");
 }
 async function query(path, params) {
@@ -184,7 +184,7 @@ function registerTools(server) {
             }
             return { content: [{ type: "text", text: JSON.stringify(await res.json(), null, 2) }] };
         }
-        return { content: [{ type: "text", text: "KOL timing requires MADEONSOL_API_KEY (msk_) — get one free at madeonsol.com/developer." }] };
+        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.", {
         wallet: z.string().describe("Deployer wallet address (base58)"),
@@ -198,7 +198,7 @@ function registerTools(server) {
             }
             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/developer." }] };
+        return { content: [{ type: "text", text: "Deployer trajectory requires MADEONSOL_API_KEY (msk_, Pro/Ultra) — get one at madeonsol.com/pricing." }] };
     });
     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"),
@@ -251,7 +251,7 @@ function registerTools(server) {
             }
             return { content: [{ type: "text", text: JSON.stringify(await res.json(), null, 2) }] };
         }
-        return { content: [{ type: "text", text: "KOL PnL requires MADEONSOL_API_KEY (msk_) — get one free at madeonsol.com/developer." }] };
+        return { content: [{ type: "text", text: "KOL PnL requires MADEONSOL_API_KEY (msk_) — get one free at madeonsol.com/pricing." }] };
     });
     server.tool("madeonsol_kol_trending_tokens", "Tokens ranked by KOL buy volume — pure capital-flow signal. Sub-hour periods (5m/15m/30m) require PRO/ULTRA.", {
         period: z.enum(["5m", "15m", "30m", "1h", "2h", "4h", "12h"]).default("1h").describe("Time window"),
@@ -392,6 +392,37 @@ function registerTools(server) {
         server.tool("madeonsol_stream_token", "Generate a 24h WebSocket streaming token. Includes ws_url for KOL/deployer streaming (Pro/Ultra) and dex_ws_url for all-DEX trade streaming (Ultra only).", {}, { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }, async () => ({
             content: [{ type: "text", text: await restQuery("POST", "/stream/token") }],
         }));
+        // ── Account / quota introspection ──
+        server.tool("madeonsol_me", "Inspect your MadeOnSol API account — current tier, daily/burst quota state, remaining requests, subscription expiry, and per-feature usage (webhooks, copy-trade wallets, coordination rules, etc.). Use to self-throttle without parsing rate-limit headers.", {}, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async () => ({
+            content: [{ type: "text", text: await restQuery("GET", "/me") }],
+        }));
+        // ── Token directory (PRO+) ──
+        server.tool("madeonsol_tokens_list", "Filtered, sortable token directory. Browse all tracked Solana tokens by market-cap band, liquidity floor, recent-activity window, primary DEX, authority/safety flags, and computed 1h volume / MEV-share / MC-change deltas. Default min_liq=2000 skips phantom-MC dust (low-liquidity pools producing absurd VWAP×supply products) — pass min_liq=0 to opt out. Computed filters (min_volume_1h_usd, max_mev_share_pct, mc_change_1h_min_pct, mc_change_1h_max_pct) over-fetch and post-filter — pagination.post_filtered=true on the response means page size may be < limit. PRO+ only.", {
+            min_mc: z.number().optional().describe("Minimum market cap in USD"),
+            max_mc: z.number().optional().describe("Maximum market cap in USD"),
+            min_liq: z.number().optional().describe("Minimum quote-side liquidity in USD (default 2000 — pass 0 to opt out of phantom-MC filter)"),
+            active_h: z.number().optional().describe("Only tokens with a trade in the last N hours"),
+            primary_dex: z.enum(["pumpfun", "pumpswap", "raydium", "meteora", "orca", "raydium_clmm"]).optional().describe("Filter by primary DEX"),
+            authority_revoked: z.boolean().optional().describe("Only tokens whose mint+freeze authority is revoked"),
+            exclude_token2022: z.boolean().optional().describe("Exclude Token-2022 mints (transfer-fee / hook risk)"),
+            min_lp_burnt_pct: z.number().optional().describe("Minimum % of LP supply burned (0-100)"),
+            min_volume_1h_usd: z.number().optional().describe("Minimum trailing 1h volume in USD (post-filter — may shrink page size)"),
+            max_mev_share_pct: z.number().optional().describe("Maximum MEV-share % of 1h volume (post-filter)"),
+            mc_change_1h_min_pct: z.number().optional().describe("Minimum 1h MC change % (post-filter; negative allowed)"),
+            mc_change_1h_max_pct: z.number().optional().describe("Maximum 1h MC change % (post-filter)"),
+            sort: z.enum(["mc_desc", "mc_asc", "last_trade_desc", "liquidity_desc", "cumulative_volume_desc"]).optional().describe("Sort axis (default mc_desc)"),
+            limit: z.number().min(1).max(100).optional().describe("Page size (max 100)"),
+            offset: z.number().min(0).optional().describe("Pagination offset"),
+        }, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async (args) => {
+            const url = new URL(`${BASE_URL}/api/v1/tokens`);
+            for (const [k, v] of Object.entries(args)) {
+                if (v !== undefined)
+                    url.searchParams.set(k, typeof v === "boolean" ? (v ? "true" : "false") : String(v));
+            }
+            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 }] };
+        });
         // ── Alpha wallet intelligence ──
         server.tool("madeonsol_alpha_leaderboard", "Top statistically profitable early-buyer wallets, scored from 47,000+ early-buyer records. BASIC=25 (truncated), PRO=100, ULTRA=500 + bot signals.", {
             period: z.enum(["7d", "30d", "all"]).default("30d").describe("Time window"),
@@ -650,7 +681,7 @@ async function main() {
                 res.end(JSON.stringify({
                     name: "madeonsol",
                     description: "Solana KOL trading intelligence and deployer analytics. Real-time data from 1,000+ KOL wallets, 6,700+ Pump.fun deployers, 47,000+ scored alpha wallets, copy-trade rules, and wallet tracker. Supports MadeOnSol API key (msk_) or x402 micropayments.",
-                    version: "1.3.1",
+                    version: "1.7.0",
                     tools: [
                         { name: "madeonsol_kol_feed", description: "Get real-time Solana KOL trades from 1,000+ tracked wallets." },
                         { name: "madeonsol_kol_coordination", description: "Get KOL convergence signals — tokens multiple KOLs are accumulating." },
@@ -671,6 +702,8 @@ async function main() {
                         { name: "madeonsol_delete_webhook", description: "Delete a webhook by ID. Pro/Ultra." },
                         { name: "madeonsol_test_webhook", description: "Send a test payload to verify a webhook. Pro/Ultra." },
                         { name: "madeonsol_stream_token", description: "Get a 24h WebSocket streaming token. Pro/Ultra." },
+                        { name: "madeonsol_me", description: "Inspect your account — tier, quota state, remaining requests, subscription expiry, per-feature usage." },
+                        { name: "madeonsol_tokens_list", description: "Filtered, sortable token directory — MC band, liquidity floor, primary DEX, authority/safety flags, computed 1h volume / MEV-share / MC-change. PRO+." },
                         { name: "madeonsol_wallet_tracker_watchlist", description: "List your tracked wallets and remaining capacity." },
                         { name: "madeonsol_wallet_tracker_add", description: "Add a wallet to your watchlist." },
                         { name: "madeonsol_wallet_tracker_remove", description: "Remove a wallet from your watchlist." },
@@ -716,7 +749,7 @@ async function main() {
                         transport = new StreamableHTTPServerTransport({
                             sessionIdGenerator: undefined,
                         });
-                        const server = new McpServer({ name: "madeonsol", version: "1.1.2" });
+                        const server = new McpServer({ name: "madeonsol", version: "1.7.0" });
                         registerTools(server);
                         await server.connect(transport);
                     }
@@ -754,7 +787,7 @@ async function main() {
     }
     else {
         // Stdio transport for local use (Claude Desktop, Cursor, Claude Code)
-        const server = new McpServer({ name: "madeonsol", version: "1.1.2" });
+        const server = new McpServer({ name: "madeonsol", version: "1.7.0" });
         registerTools(server);
         const transport = new StdioServerTransport();
         await server.connect(transport);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-server-madeonsol",
-  "version": "1.6.0",
+  "version": "1.7.2",
   "mcpName": "io.github.lambopoewert/madeonsol",
   "description": "MCP server for MadeOnSol Solana KOL intelligence API — use from Claude, Cursor, or any MCP client",
   "type": "module",
@@ -16,7 +16,8 @@
   ],
   "scripts": {
     "build": "tsc",
-    "prepublishOnly": ""
+    "preflight": "bash ../../scripts/preflight-publish.sh",
+    "prepublishOnly": "npm run preflight && npm run build"
   },
   "keywords": [
     "mcp",