bykaranteli-mcp 0.23.0 → 0.24.0

package/dist/tools.js

@@ -37,6 +37,24 @@ export function registerByKaranteliTools(server, options) {
     }
     /* Every answer carries where it came from and when (README promise; audit
      * P3 #416): routes that already emit these keep their own values. */
+    /* API stems whose public page has a different name. Stripping /api/public off
+     * the route gave nine tools a `source` that 404s on the site (2026-09-04
+     * audit: /borrow-rates, /oi, /recent, /venues/markets ...). */
+    const PAGE_FOR_STEM = {
+        "/borrow-rates": "/borrow",
+        "/oi": "/oi-leaderboard",
+        "/recent": "/signals",
+        "/leaderboard": "/strategies",
+        "/venues/markets": "/venues",
+        "/venues/lead-lag": "/venues",
+        "/venues/profile": "/venues",
+        "/datasets/etf-flows": "/etf",
+        "/datasets/liquidations-daily": "/liquidations",
+    };
+    function pageForApiPath(path) {
+        const stem = path.replace(/^\/api\/(?:v1\/)?public/, "").split("?")[0] || "/";
+        return PAGE_FOR_STEM[stem] ?? stem;
+    }
     function withProvenance(data, path) {
         if (!data || typeof data !== "object" || Array.isArray(data))
             return data;
@@ -44,11 +62,30 @@ export function registerByKaranteliTools(server, options) {
         return {
             ...record,
             generatedAt: typeof record.generatedAt === "string" ? record.generatedAt : new Date().toISOString(),
-            source: typeof record.source === "string" ? record.source : `${PUBLIC_URL}${path.replace(/^\/api\/public/, "").split("?")[0] || "/"}`,
+            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);
@@ -813,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) => {

package/package.json

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