bykaranteli-mcp 0.15.0 → 0.17.0

package/README.md

@@ -77,6 +77,7 @@ Requires Node.js 18 or newer.
 | `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_orderbook_depth` | "Where is the biggest BTC bid wall? How deep is ETH within 2% on Coinbase vs Binance?" |
 | `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

@@ -198,9 +198,9 @@ export function registerByKaranteliTools(server, options) {
     });
     server.registerTool("get_etf_flows", {
         title: "US spot Bitcoin and Ethereum ETF daily flows",
-        description: "Call this when the user asks about Bitcoin or Ethereum ETF flows: daily net inflows or outflows, cumulative flow since launch, or total net assets of the US spot ETFs (IBIT, FBTC, ETHA and the rest). Returns one row per finalized US trading day and asset with net inflow, total net assets, cumulative inflow and value traded, all in USD. About 14 months of history.",
+        description: "Call this when the user asks about Bitcoin, Ethereum or Solana spot ETF flows: daily net inflows or outflows, cumulative flow since launch, or total net assets of the US spot ETFs (IBIT, FBTC, ETHA and the rest). Returns one row per finalized US trading day and asset with net inflow, total net assets, cumulative inflow and value traded, all in USD. About 14 months of history.",
         inputSchema: {
-            asset: z.enum(["BTC", "ETH"]).optional().describe("Filter to one asset. Omit for both."),
+            asset: z.enum(["BTC", "ETH", "SOL"]).optional().describe("Filter to one asset (BTC, ETH or SOL, SOL since 2026-09-02). Omit for all."),
             days: z.number().int().min(1).max(400).optional().describe("How many most recent trading days to return (default 10)."),
         },
         annotations: READ_ONLY,
@@ -885,4 +885,27 @@ export function registerByKaranteliTools(server, options) {
             return fail(err);
         }
     });
+    server.registerTool("get_orderbook_depth", {
+        title: "Spot order book depth: walls and 2% depth across Binance, Coinbase, Kraken, Bybit, OKX",
+        description: "Call this when the user asks where the bid or ask walls are, how deep the spot order book is, whether buyers or sellers have more resting orders near price, or for an order book heatmap. Returns the five venues' books binned into 0.1% buckets within 5% of mid (USD notional), the largest walls with venue split, 2% depth and book reach per venue, and optionally the summed 5-minute history; coins: BTC, ETH, SOL, XRP, DOGE, ADA, LINK, AVAX, LTC, BNB.",
+        inputSchema: {
+            symbol: z.string().trim().toUpperCase().regex(/^[A-Z0-9]{2,12}$/).optional().describe("One coin, e.g. BTC (default BTC)"),
+            hours: z.number().int().min(1).max(24).optional().describe("Include the summed 5-minute history for this many hours"),
+        },
+        annotations: READ_ONLY,
+    }, async ({ symbol, hours }) => {
+        try {
+            const params = new URLSearchParams();
+            if (symbol)
+                params.set("symbol", symbol);
+            if (hours)
+                params.set("hours", String(hours));
+            const qs = params.toString();
+            const path = `/api/public/orderbook${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.15.0",
+  "version": "0.17.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": {