bykaranteli-mcp 0.4.0 → 0.6.0

package/README.md

@@ -47,6 +47,15 @@ Requires Node.js 18 or newer.
 | `get_strategy_leaderboard` | "Which strategies are performing best?" |
 | `get_liquidations` | "How much was liquidated today?", "Did longs or shorts get flushed this week?" |
 | `get_etf_flows` | "Did the Bitcoin ETFs buy or sell yesterday?", "Cumulative ETH ETF inflow?" |
+| `get_cot_positioning` | "Are hedge funds long or short Bitcoin?", "What did the COT report show?" |
+| `get_options_snapshot` | "Where are the BTC option walls?", "What is DVOL / the zero-gamma level?" |
+| `get_coinbase_premium` | "Are US investors buying Bitcoin?", "What does the basis trade pay?" |
+| `get_flow_toxicity` | "Is toxic order flow building?", "What is BTC's VPIN right now?" |
+| `get_options_flow` | "What are the big options players buying?", "Any block trades today?" |
+| `get_slippage` | "How much slippage on a $1M market order?", "Which book is thinnest?" |
+| `get_fomc_impact` | "What does BTC do on Fed days?", "When is the next FOMC meeting?" |
+| `get_liquidation_cascades` | "What caused that flush?", "Who got liquidated this week?" |
+| `get_open_interest` | "Is leverage entering the market?", "Are shorts building in XRP?" |
 
 All responses are JSON and carry a `generatedAt` timestamp plus a `source` URL to the human-readable page. Symbols accept both `BTCUSDT` and bare `BTC`.
 

package/dist/tools.js

@@ -358,4 +358,82 @@ export function registerByKaranteliTools(server, options) {
             return fail(err);
         }
     });
+    server.registerTool("get_flow_toxicity", {
+        title: "Order-flow toxicity (VPIN) for BTC, ETH, SOL perps",
+        description: "Call this when the user asks whether informed or toxic order flow is building, about VPIN, or whether market makers are under pressure in Bitcoin, Ethereum or Solana. Returns the current VPIN (0 = balanced, 1 = fully one-sided), its 90-day percentile, the danger threshold and the 24h average. Elevated readings historically precede volatility; VPIN says nothing about direction.",
+        inputSchema: {},
+        annotations: READ_ONLY,
+    }, async () => {
+        try {
+            return ok(await fetchJson("/api/public/flow"));
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    server.registerTool("get_options_flow", {
+        title: "Options tape: biggest prints and premium flow (BTC + ETH)",
+        description: "Call this when the user asks what big options players are buying, about block trades, or whether call or put premium dominates today. Returns 24h call vs put premium bought, the block-trade share, and the largest prints of the last 48 hours with strikes, premium and IV. Updated every 15 minutes.",
+        inputSchema: {},
+        annotations: READ_ONLY,
+    }, async () => {
+        try {
+            return ok(await fetchJson("/api/public/options-flow"));
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    server.registerTool("get_slippage", {
+        title: "Live execution cost: what a market order really costs",
+        description: "Call this when the user asks how much slippage a trade of a given size would face, how thick the books are, or which major perp market is thinnest right now. Returns live cost ladders in basis points for $10K to $5M market orders across 8 major perpetuals, both sides, from the full visible order book. Excludes fees; null = the book cannot absorb that size.",
+        inputSchema: {},
+        annotations: READ_ONLY,
+    }, async () => {
+        try {
+            return ok(await fetchJson("/api/public/slippage"));
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    server.registerTool("get_fomc_impact", {
+        title: "Measured FOMC impact on Bitcoin",
+        description: "Call this when the user asks what Bitcoin does on Fed days, how FOMC statements move crypto, or when the next FOMC meeting is. Returns per-statement 5/30/60-minute BTC reactions measured from a minute-resolution record, the average move versus a normal half hour, the up/down split (near a coin flip), and the next meeting date. Description, not prediction.",
+        inputSchema: {},
+        annotations: READ_ONLY,
+    }, async () => {
+        try {
+            return ok(await fetchJson("/api/public/events"));
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    server.registerTool("get_liquidation_cascades", {
+        title: "Auto-detected liquidation cascades (forensic case file)",
+        description: "Call this when the user asks what caused a recent crash or flush, about liquidation cascades, or who got liquidated. Returns auto-detected cascade incidents: when, total notional flushed, long/short split, which coins led, and BTC's move during the window. Totals are an honestly-labeled lower bound from a real liquidation tape.",
+        inputSchema: {},
+        annotations: READ_ONLY,
+    }, async () => {
+        try {
+            return ok(await fetchJson("/api/public/incidents"));
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    server.registerTool("get_open_interest", {
+        title: "Intraday open interest and leverage regimes (10 major perps)",
+        description: "Call this when the user asks whether leverage is entering or leaving the market, about open interest changes, or whether longs or shorts are building in a major coin. Returns 5-minute-resolution OI with 24h OI and price deltas and a four-regime read per symbol: longs building, shorts building, long squeeze, short squeeze, or quiet.",
+        inputSchema: {},
+        annotations: READ_ONLY,
+    }, async () => {
+        try {
+            return ok(await fetchJson("/api/public/oi"));
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
 }

package/package.json

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