bykaranteli-mcp 0.16.0 → 0.18.0

package/README.md

@@ -7,7 +7,7 @@ MCP (Model Context Protocol) server for **live crypto derivatives data**: fundin
 ## Hosted endpoint (no install)
 
 Paste `https://mcp.bykaranteli.com` as a custom connector in any MCP-capable
-assistant. Same 34 tools, nothing to install, no key.
+assistant. Same 35 tools, nothing to install, no key.
 
 ## Quick start
 
@@ -77,6 +77,8 @@ 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_jupiter_perps` | "How much long vs short OI is on Jupiter SOL perps? Who topped Jupiter this week? What is the JLP APR?" |
 | `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?" |
@@ -111,7 +113,7 @@ MIT. Attribution appreciated: "ByKaranteli (bykaranteli.com)".
 
 ## Paid depth (optional)
 
-The 34 tools above are free and stay free. For recorded history and raw records
+The 35 tools above are free and stay free. For recorded history and raw records
 beyond the live snapshots, bykaranteli.com also exposes pay-per-call x402
 endpoints (USDC on Solana or Base, priced per call, no account):
 <https://bykaranteli.com/developers#x402> · machine catalog:

package/dist/tools.js

@@ -871,6 +871,29 @@ export function registerByKaranteliTools(server, options) {
             return fail(err);
         }
     });
+    server.registerTool("get_jupiter_perps", {
+        title: "Jupiter Perps (Solana): exact long/short OI, utilization, borrow rates, weekly top traders",
+        description: "Call this when the user asks about Jupiter perpetuals on Solana: long versus short open interest per market (SOL, ETH, BTC) read from the on-chain custody state, pool utilization and hourly borrow rates, JLP pool AUM and APR, 24h volume, or the week's top traders by realized PnL. Pass base and history_days for the hourly OI history.",
+        inputSchema: {
+            base: z.string().trim().toUpperCase().regex(/^(SOL|ETH|BTC)$/).optional().describe("Market base: SOL, ETH or BTC"),
+            history_days: z.number().int().min(1).max(30).optional().describe("Include hourly OI history for the base, 1..30 days"),
+        },
+        annotations: READ_ONLY,
+    }, async ({ base, history_days }) => {
+        try {
+            const q = new URLSearchParams();
+            if (base)
+                q.set("base", base);
+            if (history_days)
+                q.set("days", String(history_days));
+            const qs = q.toString();
+            const path = `/api/public/jupiter${qs ? `?${qs}` : ""}`;
+            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.",
@@ -885,4 +908,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.16.0",
+  "version": "0.18.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": {