mcp-server-madeonsol 1.24.0 → 1.24.1

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, 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.24.1 — stream tokens never expire.** `madeonsol_stream_token` (`POST /stream/token`) now returns the **same token on every call, forever**. It stops working only if your subscription lapses or you call the tool with `rotate: true` to replace it (the previous value keeps working for 60 s). `expires_at` and the new `next_refresh_at` are always `null` (kept for wire compatibility — do not schedule refreshes on them); the response gains `rotated` (boolean) and `lifetime` (string). The server never rotates on its own and never sends `token_refresh` unless you rotated; a `4001` close means "mint again" (lapsed or rotated), never a timer. Prefer `Authorization: Bearer <token>` on the WebSocket handshake — `?token=` still works and is masked in access logs.
+
 > **New in 1.24.0 — token locks & vesting, upcoming unlocks, and pump.fun creator-fee sharing / claims.** Five new tools (all PRO+, keyed `msk_` API only — no x402 route). `madeonsol_token_locks` binds `GET /tokens/{mint}/locks`: every on-chain lock / vesting contract on a mint (Streamflow, Jupiter Lock, Bonfida vesting) with the schedule, the terms (`cancelable_by_sender` = the locker can pull it — funds are locked against the recipient, not the locker) and a live-derived view (`locked_*`, `claimable_*`, `next_unlock`) plus a `summary` with 7d / 30d forward unlock totals. `madeonsol_token_locks_feed` (`GET /tokens/locks`) is the cross-token feed of NEW contracts (cursor `pagination.next_since`, or push on WS channel **`token:locks`**), `madeonsol_token_unlocks` (`GET /tokens/unlocks`) lists upcoming unlock EVENTS (cliff / period / final / tranche) inside a 1h–90d window sorted by soonest / largest_usd / largest_pct. **LP locks are not included** — token/vesting locks only. `madeonsol_token_fee_shares` (`GET /tokens/{mint}/fee-shares`) decodes a pump.fun coin's on-chain `SharingConfig` — shareholders with `share_bps`, `is_admin`, `is_social_pda` (fees earmarked for an X identity: `social.platform` 2 = X, `user_id` = the numeric platform id, not the handle), `redirected_bps`, `is_default: true` = 100% to the creator — plus a distributions rollup and config history; `madeonsol_token_fee_claims` (`GET /tokens/fee-claims`) is the fee-event feed (`distribution` with per-address `payouts[]`, `social_claim`, `shares_created/updated/reset`, `creator_transferred`, `creator_claim` only when asked via `type=`), pushed on WS channel **`token:fee_claims`**. **Fee-event history starts 2026-08-17.** All base-unit amounts are digit **strings**; ui / usd / pct are `null` when decimals or price are unknown.
 
 > **New in 1.23.0 — live holder census: exact holder count, labelled holders, and pools that are named, not just excluded.** The new `madeonsol_token_holders` tool binds `GET /tokens/{mint}/holders` (PRO+): every token account of the mint read from the ledger at `confirmed` and merged per owner, so `concentration.holder_count` is EXACT (distinct non-zero owners minus pools / bonding curves / burns) — never a trade-derived estimate; it is `null` only when the provider refuses the census for a mega-cap, in which case you get the top-20 view and `source.census_fallback_reason` says so. Each disclosed owner carries our labels (`deployer` / `kol` / `early_buyer` / `bundle` / `bot` / `dump_cluster` — empty means unknown to us, not clean), and `excluded[]` NAMES what was taken out of the circulating denominator: `reason` = `pool` (with `dex` + `pool_address`), `bonding_curve` (pump.fun / LaunchLab), `burn`, or `program_account` only when we genuinely cannot attribute the PDA; `pool_pct` / `burned_pct` / `program_pct` split the exclusion. Amounts are raw u64 **strings**. Disclosure: PRO ranks 1–10, ULTRA 1–50, BUSINESS 1–100 — the maths is tier-independent. Big tokens take 5–30 s upstream: you get `503 holder_scan_in_progress` with `retry_after_seconds: 20` while the scan finishes into the cache, and the retry is instant.
@@ -317,7 +319,7 @@ CRUD for token dip/recovery price alerts. Fires when a token's market cap crosse
 
 | Tool | Description |
 |---|---|
-| `madeonsol_stream_token` | Get a 24h WebSocket token for KOL/deployer streaming and DEX trade stream — PRO/ULTRA. Channels now also include `token:locks` (new lock/vesting contracts, event `token:lock`) and `token:fee_claims` (pump.fun fee events, event `token:fee_claim`) |
+| `madeonsol_stream_token` | Get your WebSocket token for KOL/deployer streaming and DEX trade stream — PRO/ULTRA. **Never expires** (1.24.1): same token on every call; `rotate: true` replaces it (old value works 60 s more); `expires_at` / `next_refresh_at` always `null`. Channels now also include `token:locks` (new lock/vesting contracts, event `token:lock`) and `token:fee_claims` (pump.fun fee events, event `token:fee_claim`) |
 | `madeonsol_stream_sessions_list` | List your live WebSocket sessions — `id`, `service`, `tier`, `channels`, `connected_at`, `remote_ip`, `messages_sent` — PRO/ULTRA |
 | `madeonsol_stream_session_kill` | Evict a live WebSocket session by id to free its connection slot (e.g. a ghost socket) — PRO/ULTRA |
 | `madeonsol_create_webhook` | Register a webhook for real-time push notifications — PRO/ULTRA |

package/dist/index.js

@@ -575,8 +575,8 @@ function registerTools(server) {
         }, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async ({ webhook_id }) => ({
             content: [{ type: "text", text: await restQuery("POST", "/webhooks/test", { webhook_id }) }],
         }));
-        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). PRO+ channels now also include token:locks (event token:lock — every NEW Streamflow / Jupiter Lock / Bonfida lock or vesting contract) and token:fee_claims (event token:fee_claim — every pump.fun fee event: distributions to shareholders, social/X claims, config changes, creator transfers).", {}, { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }, async () => ({
-            content: [{ type: "text", text: await restQuery("POST", "/stream/token") }],
+        server.tool("madeonsol_stream_token", "Get your WebSocket streaming token. Stream tokens NEVER EXPIRE: every call returns the same token until your subscription lapses or you pass rotate=true, which replaces it (the previous value keeps working for 60 s). expires_at / next_refresh_at are always null (kept for wire compatibility); the response also carries rotated (boolean) and lifetime (string). The server never rotates on its own and never sends token_refresh unless you rotated; a 4001 close means 'mint again', never a timer. Authenticate the handshake with 'Authorization: Bearer <token>' (?token= still works, masked in logs). Includes ws_url for KOL/deployer streaming (Pro/Ultra) and dex_ws_url for all-DEX trade streaming (Ultra only). PRO+ channels now also include token:locks (event token:lock — every NEW Streamflow / Jupiter Lock / Bonfida lock or vesting contract) and token:fee_claims (event token:fee_claim — every pump.fun fee event: distributions to shareholders, social/X claims, config changes, creator transfers).", { rotate: z.boolean().optional().describe("Replace the current token with a new one (the old value keeps working for 60 s). Default false — returns the existing token.") }, { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async ({ rotate }) => ({
+            content: [{ type: "text", text: await restQuery("POST", "/stream/token", rotate ? { rotate: true } : undefined) }],
         }));
         server.tool("madeonsol_stream_sessions_list", "List your live WebSocket streaming sessions. Returns sessions[] (each with id, service 'ws-streaming'|'dex-stream', tier, channels[], connected_at, remote_ip, messages_sent) and count. Use it to see which connections are holding your per-tier socket slots before evicting a ghost with madeonsol_stream_session_kill. PRO/ULTRA only.", {}, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async () => ({
             content: [{ type: "text", text: await restQuery("GET", "/stream/sessions") }],
@@ -1189,7 +1189,7 @@ async function main() {
                         { name: "madeonsol_list_webhooks", description: "List your registered webhooks. Pro/Ultra." },
                         { name: "madeonsol_delete_webhook", description: "Delete a webhook by ID. Pro/Ultra." },
                         { name: "madeonsol_test_webhook", description: "Send a test payload to verify a webhook. Pro/Ultra." },
-                        { name: "madeonsol_stream_token", description: "Get a 24h WebSocket streaming token. Pro/Ultra." },
+                        { name: "madeonsol_stream_token", description: "Get your WebSocket streaming token (never expires; same token on every call, rotate=true to replace it). Pro/Ultra." },
                         { name: "madeonsol_stream_sessions_list", description: "List your 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: "Inspect your account — tier, quota state, remaining requests, subscription expiry, per-feature usage." },

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "1.24.0";
+export declare const VERSION = "1.24.1";

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.24.0";
+export const VERSION = "1.24.1";

package/glama.json

@@ -5,7 +5,7 @@
   ],
   "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, no payment to start; auth via msk_ API key or x402 micropayments.",
-  "version": "1.20.1",
+  "version": "1.24.1",
   "homepage": "https://madeonsol.com/solana-api",
   "repository": "https://github.com/madeonsol/mcp-server-madeonsol",
   "license": "MIT",
@@ -246,7 +246,7 @@
     },
     {
       "name": "madeonsol_stream_token",
-      "description": "Issue a 24h WebSocket streaming token (Pro/Ultra). Includes dex_ws_url on ULTRA."
+      "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",

package/package.json

@@ -1,87 +1,87 @@
-{
-  "name": "mcp-server-madeonsol",
-  "version": "1.24.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, no payment to start.",
-  "type": "module",
-  "bin": {
-    "mcp-server-madeonsol": "dist/index.js"
-  },
-  "main": "dist/index.js",
-  "files": [
-    "dist",
-    "README.md",
-    "LICENSE",
-    "glama.json"
-  ],
-  "scripts": {
-    "prebuild": "node ../gen-version.mjs",
-    "build": "tsc",
-    "test": "vitest run",
-    "preflight": "bash ../../scripts/preflight-publish.sh",
-    "prepublishOnly": "npm run preflight && npm run build"
-  },
-  "keywords": [
-    "mcp",
-    "model-context-protocol",
-    "mcp-server",
-    "solana",
-    "x402",
-    "kol",
-    "kol-tracker",
-    "trading",
-    "claude",
-    "claude-desktop",
-    "cursor",
-    "windsurf",
-    "ai-agent",
-    "memecoin",
-    "memecoin-tracker",
-    "pumpfun",
-    "deployer-hunter",
-    "alpha",
-    "alpha-bot",
-    "smart-money",
-    "copy-trading",
-    "madeonsol"
-  ],
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/madeonsol/mcp-server-madeonsol"
-  },
-  "homepage": "https://madeonsol.com/solana-api",
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.12.1",
-    "zod": "^4.3.6"
-  },
-  "peerDependencies": {
-    "@x402/fetch": "^2.8.0",
-    "@x402/core": "^2.8.0",
-    "@x402/svm": "^2.8.0",
-    "@solana/kit": "^5.5.1",
-    "@scure/base": "^2.0.0"
-  },
-  "peerDependenciesMeta": {
-    "@x402/fetch": {
-      "optional": true
-    },
-    "@x402/core": {
-      "optional": true
-    },
-    "@x402/svm": {
-      "optional": true
-    },
-    "@solana/kit": {
-      "optional": true
-    },
-    "@scure/base": {
-      "optional": true
-    }
-  },
-  "devDependencies": {
-    "@types/node": "^20",
-    "typescript": "^5",
-    "vitest": "^4.1.5"
-  }
-}
+{
+  "name": "mcp-server-madeonsol",
+  "version": "1.24.1",
+  "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, no payment to start.",
+  "type": "module",
+  "bin": {
+    "mcp-server-madeonsol": "dist/index.js"
+  },
+  "main": "dist/index.js",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "glama.json"
+  ],
+  "scripts": {
+    "prebuild": "node ../gen-version.mjs",
+    "build": "tsc",
+    "test": "vitest run",
+    "preflight": "bash ../../scripts/preflight-publish.sh",
+    "prepublishOnly": "npm run preflight && npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "mcp-server",
+    "solana",
+    "x402",
+    "kol",
+    "kol-tracker",
+    "trading",
+    "claude",
+    "claude-desktop",
+    "cursor",
+    "windsurf",
+    "ai-agent",
+    "memecoin",
+    "memecoin-tracker",
+    "pumpfun",
+    "deployer-hunter",
+    "alpha",
+    "alpha-bot",
+    "smart-money",
+    "copy-trading",
+    "madeonsol"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/madeonsol/mcp-server-madeonsol"
+  },
+  "homepage": "https://madeonsol.com/solana-api",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "zod": "^4.3.6"
+  },
+  "peerDependencies": {
+    "@x402/fetch": "^2.8.0",
+    "@x402/core": "^2.8.0",
+    "@x402/svm": "^2.8.0",
+    "@solana/kit": "^5.5.1",
+    "@scure/base": "^2.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@x402/fetch": {
+      "optional": true
+    },
+    "@x402/core": {
+      "optional": true
+    },
+    "@x402/svm": {
+      "optional": true
+    },
+    "@solana/kit": {
+      "optional": true
+    },
+    "@scure/base": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^20",
+    "typescript": "^5",
+    "vitest": "^4.1.5"
+  }
+}