bykaranteli-mcp 0.3.1 → 0.5.0

package/README.md

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

@@ -319,4 +319,82 @@ export function registerByKaranteliTools(server, options) {
             return fail(err);
         }
     });
+    server.registerTool("get_cot_positioning", {
+        title: "CME futures positioning (weekly COT report, BTC + ETH)",
+        description: "Call this when the user asks how hedge funds or institutions are positioned in Bitcoin or Ethereum, or about the CFTC Commitments of Traders report. Returns net positions in contracts, week-over-week changes, open interest and notable extremes/streaks, from official CFTC data updated every Friday. Note: a large share of hedge fund shorts is the market-neutral basis trade, so the weekly change carries more signal than the level.",
+        inputSchema: {},
+        annotations: READ_ONLY,
+    }, async () => {
+        try {
+            return ok(await fetchJson("/api/public/cot"));
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    server.registerTool("get_options_snapshot", {
+        title: "Options walls, gamma exposure and DVOL (BTC + ETH)",
+        description: "Call this when the user asks where the big options bets sit, about call/put walls, gamma exposure (GEX), the zero-gamma level, implied volatility (DVOL) or the IV term structure for Bitcoin or Ethereum. Daily snapshot of listed crypto options: top strikes by open interest, put/call ratio, dealer hedging map and ATM IV by expiry.",
+        inputSchema: {},
+        annotations: READ_ONLY,
+    }, async () => {
+        try {
+            return ok(await fetchJson("/api/public/options"));
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    server.registerTool("get_coinbase_premium", {
+        title: "Coinbase Premium (US demand gauge) + carry yield",
+        description: "Call this when the user asks whether US investors are buying or selling Bitcoin or Ethereum, about the Coinbase Premium, or what the cash-and-carry basis trade pays. Returns the latest daily premium in percent, 7-day average, same-sign streak, the last 30 days, and annualized quarterly carry yields. History since 2017; positive premium = US buying pressure.",
+        inputSchema: {},
+        annotations: READ_ONLY,
+    }, async () => {
+        try {
+            return ok(await fetchJson("/api/public/premium"));
+        }
+        catch (err) {
+            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);
+        }
+    });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bykaranteli-mcp",
-  "version": "0.3.1",
+  "version": "0.5.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": {
@@ -64,4 +64,4 @@
       "default": "./dist/tools.js"
     }
   }
-}
+}