bykaranteli-mcp 0.23.1 → 0.24.1

package/dist/tools.js

@@ -65,8 +65,27 @@ export function registerByKaranteliTools(server, options) {
             source: typeof record.source === "string" ? record.source : `${PUBLIC_URL}${pageForApiPath(path)}`,
         };
     }
+    /* Compact JSON (pretty-printing cost ~35% of the budget) and a hard ceiling:
+     * a few argument combinations produced 400k+ characters, more than an LLM
+     * context window, with no signal that anything was cut (audit 2026-09-04
+     * #41). Above the ceiling the tool answers with guidance instead of a
+     * payload the caller could not use anyway. */
+    const MAX_RESULT_CHARS = 240_000;
     function ok(data) {
-        return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+        const text = JSON.stringify(data);
+        if (text.length <= MAX_RESULT_CHARS)
+            return { content: [{ type: "text", text }] };
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify({
+                        truncated: true,
+                        chars: text.length,
+                        limit: MAX_RESULT_CHARS,
+                        note: "Result too large for one context window. Narrow the call: fewer hours or days, a single symbol, or include_points=false, then call again.",
+                    }),
+                }],
+        };
     }
     function fail(err) {
         const message = err instanceof Error ? err.message : String(err);
@@ -380,9 +399,9 @@ export function registerByKaranteliTools(server, options) {
         inputSchema: {
             symbol: z.string().describe("The symbol, e.g. BTCUSDT, or a coin name like BTC."),
             window_days: z
-                .preprocess((v) => (typeof v === "string" && v.trim() !== "" && Number.isFinite(Number(v)) ? Number(v) : v), z.union([z.literal(30), z.literal(90), z.literal(180)]))
+                .preprocess((v) => (typeof v === "string" && v.trim() !== "" && Number.isFinite(Number(v)) ? Number(v) : v), z.number().int().min(1).max(365))
                 .optional()
-                .describe("Optional lookback window in days (30, 90 or 180). Default 90."),
+                .describe("Optional lookback window in days, 1 to 365 (the API accepts any integer in that range). Default 90."),
         },
         annotations: READ_ONLY,
     }, async ({ symbol, window_days }) => {
@@ -764,11 +783,11 @@ export function registerByKaranteliTools(server, options) {
     server.registerTool("get_iv_surface", {
         title: "Options implied-volatility surface and 25-delta skew",
         description: "Call this when the user asks about implied volatility by strike or expiry, skew, put versus call IV, term structure of IV, or whether downside protection is expensive. Returns the IV surface (expiry x moneyness), per-expiry ATM / 25-delta put and call IV, skew and butterfly, and the constant-30d history, from the daily Deribit chain.",
-        inputSchema: { currency: z.string().optional().describe("BTC or ETH, default BTC") },
+        inputSchema: { currency: z.enum(["BTC", "ETH"]).optional().describe("BTC or ETH, default BTC") },
         annotations: READ_ONLY,
     }, async (args) => {
         try {
-            const path = `/api/public/options/surface?currency=${(args.currency ?? "BTC").toUpperCase() === "ETH" ? "ETH" : "BTC"}`;
+            const path = `/api/public/options/surface?currency=${args.currency ?? "BTC"}`;
             return ok(withProvenance(await fetchJson(path), path));
         }
         catch (err) {
@@ -831,7 +850,7 @@ export function registerByKaranteliTools(server, options) {
     });
     server.registerTool("get_network_health", {
         title: "Bitcoin network health from our own node",
-        description: "Call this when the user asks about Bitcoin hashrate, difficulty, fees or mempool congestion. Returns the recorded daily series and latest values measured on ByKaranteli's own node.",
+        description: "Call this when the user asks about Bitcoin hashrate, difficulty or block fees (our node runs blocksonly, so there is no mempool series). Returns the recorded daily series and latest values measured on ByKaranteli's own node.",
         inputSchema: { days: z.number().int().min(1).max(730).optional().describe("Window in days, 1-730 (default 365).") },
         annotations: READ_ONLY,
     }, async (args) => {
@@ -1010,7 +1029,7 @@ export function registerByKaranteliTools(server, options) {
     });
     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.",
+        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. snapshots[].country is the jurisdiction only when the venue states one; it is null for most venues, so do not read null as unknown risk.",
         inputSchema: {},
         annotations: READ_ONLY,
     }, async () => {

package/package.json

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