bykaranteli-mcp 0.3.0 → 0.4.0

package/dist/tools.js

@@ -4,7 +4,7 @@
  * bykaranteli.com both call registerByKaranteliTools on their own server
  * instance, so the 10 tools have exactly one definition.
  */
-import { z } from "zod";
+import { z } from "zod/v4";
 export function registerByKaranteliTools(server, options) {
     const BASE_URL = (options?.baseUrl ?? process.env.BYKARANTELI_BASE_URL ?? "https://bykaranteli.com").replace(/\/+$/, "");
     const USER_AGENT = `bykaranteli-mcp/${options?.version ?? "dev"} (+https://github.com/bykarantelicom/bykaranteli-mcp)`;
@@ -319,4 +319,43 @@ 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);
+        }
+    });
 }

package/package.json

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