bykaranteli-mcp 0.11.0 → 0.13.0

package/README.md

@@ -74,6 +74,8 @@ Requires Node.js 18 or newer.
 | `get_network_health` | "Bitcoin hashrate, difficulty, fees, mempool right now?" |
 | `get_tradfi_board` | "TSLA perp funding rate? Which exchanges list NVDA perps? Is the stock session open?" |
 | `get_rsi_heatmap` | "Which coins are oversold on the daily? BTC RSI on 4h and 1w?" |
+| `get_hl_whales` | "Are Hyperliquid whales net long BTC? What did the biggest accounts just flip?" |
+| `get_cycle_indicators` | "Has the Pi Cycle crossed? Mayer Multiple and Puell today?" |
 | `get_altseason` | "Is it altseason?", "What is the altcoin season index?" |
 | `get_metric_context` | "Is today's funding extreme historically?", "Where does this reading sit in its distribution?" |
 | `get_quantum_exposure` | "How much Bitcoin is quantum-vulnerable?", "What is the P2PK exposure?" |

package/dist/tools.js

@@ -810,4 +810,44 @@ export function registerByKaranteliTools(server, options) {
             return fail(err);
         }
     });
+    server.registerTool("get_cycle_indicators", {
+        title: "Bitcoin cycle indicators: Pi Cycle, Mayer, 200W MA, Puell, S2F",
+        description: "Call this when the user asks whether Bitcoin is near a cycle top or bottom by the classic indicators, about the Pi Cycle Top, Mayer Multiple, 200-week moving average, 2-year MA multiplier, golden ratio multiple, profitable days, stock-to-flow, Puell Multiple or Bitfinex margin positioning. Returns the latest readings, the Pi Cycle cross dates on record, and optionally the daily series (recomputed nightly from a first-party close record since 2012). Levels, not forecasts.",
+        inputSchema: {
+            days: z.number().int().min(30).max(10000).optional().describe("Window in days for the series (default 730)"),
+            include_points: z.boolean().optional().describe("Include the daily series (large). Default false: latest values and cross dates only."),
+        },
+        annotations: READ_ONLY,
+    }, async ({ days, include_points }) => {
+        try {
+            const path = `/api/public/indicators?days=${days && days > 0 ? Math.floor(days) : 730}${include_points ? "" : "&points=0"}`;
+            return ok(withProvenance(await fetchJson(path), path));
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    server.registerTool("get_hl_whales", {
+        title: "Hyperliquid whale tracker: top-300 accounts, long vs short, positions, changes",
+        description: "Call this when the user asks what Hyperliquid whales are doing, whether the biggest Hyperliquid accounts are net long or short a coin, for the largest open positions with liquidation prices, or what large accounts just opened, closed or flipped. Returns the live board of the 300 largest accounts by equity (scanned every 5 minutes, addresses only) and with events the last 200 position changes.",
+        inputSchema: {
+            coin: z.string().trim().toUpperCase().regex(/^[A-Z0-9]{1,24}$/).optional().describe("One coin, e.g. BTC"),
+            events: z.boolean().optional().describe("Include the last 200 position change events"),
+        },
+        annotations: READ_ONLY,
+    }, async ({ coin, events }) => {
+        try {
+            const params = new URLSearchParams();
+            if (coin)
+                params.set("coin", coin);
+            if (events)
+                params.set("events", "1");
+            const qs = params.toString();
+            const path = `/api/public/hyperliquid-whales${qs ? `?${qs}` : ""}`;
+            return ok(withProvenance(await fetchJson(path), path));
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bykaranteli-mcp",
-  "version": "0.11.0",
+  "version": "0.13.0",
   "description": "MCP server for live crypto derivatives data from bykaranteli.com: funding rates, funding arbitrage, open interest pressure, Fear & Greed, BTC dominance and verified signal performance. Free, no API key.",
   "type": "module",
   "bin": {