bykaranteli-mcp 0.26.0 → 0.26.2

package/dist/tools.js

@@ -802,7 +802,7 @@ export function registerByKaranteliTools(server, options) {
     });
     server.registerTool("get_liqmap", {
         title: "LiqMap: estimated liquidation clusters with real prints overlaid",
-        description: "Call this when the user asks where liquidation clusters or liquidity pools sit for a perpetual, where leveraged longs/shorts would get liquidated, or for a liquidation heatmap reading. Returns the public LiqMap snapshot for one symbol: modeled liquidation levels by price, zone aggregates and real liquidation prints from six venues. Public tier serves the 24h view; other intervals are a member feature at the source page.",
+        description: "Call this when the user asks where liquidation clusters or liquidity pools sit for a perpetual, where leveraged longs/shorts would get liquidated, or for a liquidation heatmap reading. Returns the LiqMap snapshot for one symbol: modeled liquidation levels by price, zone aggregates and real liquidation prints from six venues. Without an account key (or on the Free plan) the 24h view; with a Builder or higher key (BYKARANTELI_API_KEY) every timeframe from 1h to 30d.",
         inputSchema: {
             symbol: z
                 .string()
@@ -811,13 +811,17 @@ export function registerByKaranteliTools(server, options) {
                 .regex(/^[A-Z0-9]{2,20}$/)
                 .optional()
                 .describe("Symbol like BTCUSDT (bare BTC accepted). Default BTCUSDT."),
+            timeframe: z
+                .enum(["1h", "4h", "12h", "24h", "3d", "1w", "30d"])
+                .optional()
+                .describe("Model window. Default 24h, the only one served without a Builder or higher key."),
         },
         annotations: READ_ONLY,
-    }, async ({ symbol }) => {
+    }, async ({ symbol, timeframe }) => {
         try {
             const raw = symbol ?? "BTCUSDT";
             const sym = raw.endsWith("USDT") ? raw : `${raw}USDT`;
-            const path = `/api/liqmap/public?symbol=${encodeURIComponent(sym)}&timeframe=24h`;
+            const path = `/api/liqmap/public?symbol=${encodeURIComponent(sym)}&timeframe=${encodeURIComponent(timeframe ?? "24h")}`;
             const data = await fetchJson(path);
             return ok({ ...data, source: `${PUBLIC_URL}/liqmap/${sym.replace(/USDT$/, "").toLowerCase()}` });
         }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "bykaranteli-mcp",
-  "version": "0.26.0",
-  "description": "MCP server for live crypto derivatives data from bykaranteli.com: funding rates, funding arbitrage, open interest pressure, liquidations, options, ETF flows, Fear & Greed and BTC dominance. Free, no API key.",
+  "version": "0.26.2",
+  "description": "MCP server for live crypto derivatives data from bykaranteli.com: funding rates, funding arbitrage, open interest pressure, liquidations, options, ETF flows, Fear & Greed and BTC dominance. 45 read-only tools, free account key, paid depth via plans or x402.",
   "type": "module",
   "bin": {
     "bykaranteli-mcp": "dist/index.js"