bykaranteli-mcp 0.24.1 → 0.25.0

package/README.md

@@ -1,6 +1,6 @@
 # bykaranteli-mcp
 
-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.
+MCP (Model Context Protocol) server for **live crypto derivatives data**: funding rates, cross-exchange funding arbitrage, open interest pressure, liquidations, options, ETF flows, Fear & Greed and BTC dominance.
 
 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).
 
@@ -47,9 +47,6 @@ Requires Node.js 18 or newer.
 | `get_funding_arbitrage` | "Any funding arb opportunities?", "Best venue to long/short BTC for carry?" |
 | `get_pressure_scores` | "Which coins are over-leveraged / crowded right now?" |
 | `get_top_movers` | "Biggest OI spikes today?", "Most extreme funding right now?" |
-| `get_recent_signals` | "How did the signals do in the last 24h?" |
-| `get_symbol_performance` | "Win rate on ETHUSDT over 90 days?" |
-| `get_strategy_leaderboard` | "Which strategies are performing best?" |
 | `get_liquidations` | "How much was liquidated today?", "Did longs or shorts get flushed this week?" |
 | `get_etf_flows` | "Did the Bitcoin ETFs buy or sell yesterday?", "Cumulative ETH ETF inflow?" |
 | `get_cot_positioning` | "Are hedge funds long or short Bitcoin?", "What did the COT report show?" |
@@ -101,7 +98,7 @@ All responses are JSON and carry a `generatedAt` timestamp plus a `source` URL t
 
 ## Data notes
 
-- Signal performance is a **live-only** track record: real published signals with SHA-256 receipts, evaluated net of fees, slippage and funding. Never backtests. Verify any signal at [bykaranteli.com/verify](https://bykaranteli.com/verify).
+- The signal engine was retired in September 2026; this server publishes recorded market data only, no trading signals or performance claims.
 - Funding, OI and pressure data refresh every 15 to 30 minutes; indices every 30 minutes.
 - Nothing here is financial advice. See [bykaranteli.com/risk-guide](https://bykaranteli.com/risk-guide).
 

package/dist/tools.js

@@ -43,8 +43,6 @@ export function registerByKaranteliTools(server, options) {
     const PAGE_FOR_STEM = {
         "/borrow-rates": "/borrow",
         "/oi": "/oi-leaderboard",
-        "/recent": "/signals",
-        "/leaderboard": "/strategies",
         "/venues/markets": "/venues",
         "/venues/lead-lag": "/venues",
         "/venues/profile": "/venues",
@@ -379,78 +377,6 @@ export function registerByKaranteliTools(server, options) {
             return fail(err);
         }
     });
-    server.registerTool("get_recent_signals", {
-        title: "Recent closed trading signals with verified outcomes",
-        description: "Call this when the user asks how the ByKaranteli signal engine is doing today, or wants recent closed LONG/SHORT signals with real outcomes (TP1, SL or TIMEOUT) and net basis-point results. Includes a 24h summary (wins, losses, net bps). Every signal is published with a SHA-256 receipt and results are net of fees, slippage and funding; live signals only, never backtests.",
-        inputSchema: {},
-        annotations: READ_ONLY,
-    }, async () => {
-        try {
-            const d = (await fetchJson("/api/public/recent"));
-            return ok({ ...d, source: `${PUBLIC_URL}/signals` });
-        }
-        catch (err) {
-            return fail(err);
-        }
-    });
-    server.registerTool("get_symbol_performance", {
-        title: "Per-symbol signal performance and recent trades",
-        description: "Call this when the user asks how signals performed on a specific coin (win rate, profit factor, net PnL, best/worst trade) or wants that coin's recent closed signals. Data is the live verified track record for one Binance USDT-M perp over a 30, 90 or 180 day window.",
-        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.number().int().min(1).max(365))
-                .optional()
-                .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 }) => {
-        try {
-            const want = normalizeSymbol(symbol);
-            const w = window_days ?? 90;
-            let d;
-            try {
-                d = (await fetchJson(`/api/v1/public/symbols/${want}?window=${w}`));
-            }
-            catch (err) {
-                // The API 404s when the symbol has no closed signals in the chosen
-                // window (data-dependent, not an invalid request). Say so plainly.
-                if (err instanceof Error && err.message.includes("HTTP 404")) {
-                    return ok({
-                        symbol: want,
-                        window_days: w,
-                        note: `No closed signals recorded for ${want} in the last ${w} days (or the symbol is not tracked). Try window_days: 180, or check ${PUBLIC_URL}/symbols/${want}.`,
-                    });
-                }
-                throw err;
-            }
-            // daily_points can be long; the stats + recent signals carry the answer.
-            const daily = d.daily_points;
-            return ok({
-                ...d,
-                daily_points: Array.isArray(daily) ? daily.slice(-30) : daily,
-                daily_points_truncated: Array.isArray(daily) ? daily.length > 30 : false,
-                source: `${PUBLIC_URL}/symbols/${want}`,
-            });
-        }
-        catch (err) {
-            return fail(err);
-        }
-    });
-    server.registerTool("get_strategy_leaderboard", {
-        title: "Strategy leaderboard with verified live results",
-        description: "Call this when the user asks which trading strategies are performing best, or wants win rate, profit factor, drawdown and Sharpe per strategy. Rankings are computed from live closed signals only (no backtests), net of fees.",
-        inputSchema: {},
-        annotations: READ_ONLY,
-    }, async () => {
-        try {
-            const d = (await fetchJson("/api/v1/public/leaderboard"));
-            return ok({ ...d, source: `${PUBLIC_URL}/leaderboard` });
-        }
-        catch (err) {
-            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.",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "bykaranteli-mcp",
-  "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.",
+  "version": "0.25.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.",
   "type": "module",
   "bin": {
     "bykaranteli-mcp": "dist/index.js"