bykaranteli-mcp 0.13.0 → 0.15.0

package/README.md

@@ -75,6 +75,8 @@ Requires Node.js 18 or newer.
 | `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_positioning` | "BTC long/short ratio on Binance? Are top traders net short ETH? CVD today?" |
+| `get_coverage` | "Which exchanges are behind your liquidation totals? How fresh is the data?" |
 | `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

@@ -618,11 +618,16 @@ export function registerByKaranteliTools(server, options) {
     server.registerTool("get_venue_markets", {
         title: "Exchange coverage: OI, volume, funding and pegs across 43 exchanges",
         description: "Call this when the user asks about total open interest across exchanges, which venues hold the most OI, DEX versus CEX share, funding dispersion between venues, or stablecoin pegs. Returns the latest 10-minute snapshot aggregates across 56 feeds on 43 exchanges; pass symbol for one coin's per-venue rows.",
-        inputSchema: { symbol: z.string().optional().describe("string, optional base asset, e.g. BTC") },
+        inputSchema: {
+            symbol: z.string().optional().describe("string, optional base asset, e.g. BTC"),
+            history_days: z.number().int().min(1).max(90).optional().describe("Return the hourly multi-venue open interest history (total, DEX share, OI-weighted funding) for this many days instead of the snapshot"),
+        },
         annotations: READ_ONLY,
     }, async (args) => {
         try {
-            const path = args.symbol ? `/api/public/venues/markets?symbol=${encodeURIComponent(args.symbol.toUpperCase())}` : "/api/public/venues/markets";
+            const path = args.history_days
+                ? `/api/public/venues/oi-history?days=${Math.min(90, Math.floor(args.history_days))}`
+                : args.symbol ? `/api/public/venues/markets?symbol=${encodeURIComponent(args.symbol.toUpperCase())}` : "/api/public/venues/markets";
             return ok(withProvenance(await fetchJson(path), path));
         }
         catch (err) {
@@ -850,4 +855,34 @@ export function registerByKaranteliTools(server, options) {
             return fail(err);
         }
     });
+    server.registerTool("get_positioning", {
+        title: "Positioning: long/short ratios, taker buy/sell and CVD on Binance, Bybit, OKX",
+        description: "Call this when the user asks about the long/short ratio, whether retail or top traders are net long or short, the taker buy/sell ratio, or CVD (cumulative volume delta) for a perpetual. Returns exchange-published statistics for the 30 most traded Binance USDT perps (Binance global and top-trader ratios, Bybit share long, OKX ratios and taker volume) and CVD series for BTC, ETH and SOL; refreshed every 15 minutes.",
+        inputSchema: {
+            symbol: z.string().trim().toUpperCase().regex(/^[A-Z0-9]{2,24}$/).optional().describe("One Binance symbol, e.g. BTCUSDT"),
+        },
+        annotations: READ_ONLY,
+    }, async ({ symbol }) => {
+        try {
+            const path = `/api/public/positioning${symbol ? `?symbol=${encodeURIComponent(symbol)}` : ""}`;
+            return ok(withProvenance(await fetchJson(path), path));
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    server.registerTool("get_coverage", {
+        title: "Coverage registry: which venues and data types we collect, how, and how fresh",
+        description: "Call this when the user asks which exchanges sit behind a ByKaranteli number, whether a feed is complete or sampled, since when a venue is collected, or how fresh the data is. Returns the live coverage registry: liquidation feeds per venue with kind and last record, snapshot feeds per venue and market, funding arbitrage legs, positioning sources, whale tape, spot minutes and the Hyperliquid whale scan with freshness.",
+        inputSchema: {},
+        annotations: READ_ONLY,
+    }, async () => {
+        try {
+            const path = "/api/public/coverage";
+            return ok(withProvenance(await fetchJson(path), path));
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bykaranteli-mcp",
-  "version": "0.13.0",
+  "version": "0.15.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": {