bykaranteli-mcp 0.22.0 → 0.23.1

package/README.md

@@ -2,12 +2,12 @@
 
 MCP (Model Context Protocol) server for **live crypto derivatives data**: funding rates, cross-exchange funding arbitrage, open interest pressure, Fear & Greed, BTC dominance and a verified signal track record.
 
-46 read-only tools over the free, no-auth public JSON API of [bykaranteli.com](https://bykaranteli.com/developers). No API key, no account, no rate-limit registration. Data covers Binance USDT-M perpetuals (funding arbitrage additionally compares OKX, Bybit, Gate, HTX, BingX, Kraken, MEXC and Bitget).
+48 read-only tools over the free, no-auth public JSON API of [bykaranteli.com](https://bykaranteli.com/developers). No API key, no account, no rate-limit registration. Data covers Binance USDT-M perpetuals (funding arbitrage additionally compares OKX, Bybit, Gate, HTX, BingX, Kraken, MEXC and Bitget).
 
 ## Hosted endpoint (no install)
 
 Paste `https://mcp.bykaranteli.com` as a custom connector in any MCP-capable
-assistant. Same 46 tools, nothing to install, no key.
+assistant. Same 48 tools, nothing to install, no key.
 
 ## Quick start
 
@@ -69,6 +69,8 @@ Requires Node.js 18 or newer.
 | `get_withdrawal_status` | "Has KuCoin paused USDT withdrawals?", "Cheapest network to withdraw USDT from Gate?", "Which exchanges have withdrawals closed right now?" |
 | `get_venue_profile` | "What do you record about Bybit?", "How many contracts does OKX list?", "Is HTX up, and what happened there this week?" |
 | `get_settlements` | "What expires this week?", "When is the next BTC quarterly on OKX?", "At what price did the September future settle?" |
+| `get_borrow_rates` | "What does it cost to borrow USDT on Binance?", "Cheapest venue to borrow ETH?", "Is stablecoin borrow spiking?" |
+| `get_fee_table` | "What are Bitget's perp fees?", "Which exchange has the lowest taker fee?", "Did any venue change fees this week?" |
 | `get_lead_lag` | "Does Coinbase or Binance move first?" |
 | `get_iv_surface` | "What is BTC implied vol by expiry?", "Is downside protection expensive (skew)?" |
 | `get_whale_tape` | "Are whales buying or selling right now?" |
@@ -117,7 +119,7 @@ MIT. Attribution appreciated: "ByKaranteli (bykaranteli.com)".
 
 ## Paid depth (optional)
 
-The 46 tools above are free and stay free. For recorded history and raw records
+The 48 tools above are free and stay free. For recorded history and raw records
 beyond the live snapshots, bykaranteli.com also exposes pay-per-call x402
 endpoints (USDC on Solana or Base, priced per call, no account):
 <https://bykaranteli.com/developers#x402> · machine catalog:

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,7 +62,7 @@ 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)}`,
         };
     }
     function ok(data) {
@@ -615,6 +633,32 @@ export function registerByKaranteliTools(server, options) {
             return fail(err);
         }
     });
+    server.registerTool("get_borrow_rates", {
+        title: "Margin borrow rates per venue: the cost of leverage, hourly",
+        description: "Call this when the user asks what it costs to borrow USDT, USDC, BTC, ETH or a major alt on an exchange, which venue has the cheapest borrow, whether stablecoin borrow cost is spiking, or what the carry of a basis trade is on a venue (funding minus borrow). Returns the latest annualised rate per venue and asset, 30 days of hourly series for the stablecoins and majors, and the carry table. Recorded hourly by ByKaranteli (Binance and OKX today).",
+        inputSchema: {},
+        annotations: READ_ONLY,
+    }, async () => {
+        try {
+            return ok(withProvenance(await fetchJson("/api/public/borrow-rates"), "/api/public/borrow-rates"));
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    server.registerTool("get_fee_table", {
+        title: "Trading fee schedules per venue, base tier maker and taker",
+        description: "Call this when the user asks what an exchange charges to trade, how maker and taker fees compare across venues, whether a venue changed its fees, or what a round trip costs on a given notional. Returns base tier maker and taker per venue and market type (median across pairs where the venue prices per pair) and the fee change log, read daily by ByKaranteli from each venue's own fee endpoint.",
+        inputSchema: {},
+        annotations: READ_ONLY,
+    }, async () => {
+        try {
+            return ok(withProvenance(await fetchJson("/api/public/fees"), "/api/public/fees"));
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
     server.registerTool("get_settlements", {
         title: "Expiry calendar and settlement prices across venues",
         description: "Call this when the user asks what futures or options expire soon, when the next quarterly expiry is on an exchange, how many contracts settle this week, or at what price a dated future settled. Returns the next 60 days of dated future and option expiries grouped by date, venue and underlying from 54 venues' market lists, plus the settlement prices recorded as dated futures deliver.",

package/package.json

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