bykaranteli-mcp 0.12.0 → 0.13.0

package/README.md

@@ -74,6 +74,7 @@ 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?" |

package/dist/tools.js

@@ -827,4 +827,27 @@ export function registerByKaranteliTools(server, options) {
             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.12.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": {