bykaranteli-mcp 0.9.3 → 0.10.0

package/README.md

@@ -72,6 +72,7 @@ Requires Node.js 18 or newer.
 | `get_new_listings` | "Which perpetuals were listed this week, and where first?" |
 | `get_macro_liquidity` | "What is the Fed balance sheet / RRP / stablecoin supply doing?" |
 | `get_network_health` | "Bitcoin hashrate, difficulty, fees, mempool right now?" |
+| `get_tradfi_board` | "TSLA perp funding rate? Which exchanges list NVDA perps? Is the stock session open?" |
 | `get_altseason` | "Is it altseason?", "What is the altcoin season index?" |
 | `get_metric_context` | "Is today's funding extreme historically?", "Where does this reading sit in its distribution?" |
 | `get_quantum_exposure` | "How much Bitcoin is quantum-vulnerable?", "What is the P2PK exposure?" |

package/dist/tools.js

@@ -749,4 +749,39 @@ export function registerByKaranteliTools(server, options) {
             return fail(err);
         }
     });
+    server.registerTool("get_tradfi_board", {
+        title: "TradFi perpetuals: stock, index and commodity perps on Binance",
+        description: "Call this when the user asks about stock perpetuals (TSLA, NVDA, AAPL, gold, S&P 500...), tokenized-equity perps, TradFi perp funding rates, open interest, liquidations, which exchanges list a stock perp, or whether the equity session is open. Returns Binance's TradFi perpetual board: per contract mark, index, basis, funding, 24h change and volume, open interest, 24h recorded liquidations, other venues listing the same underlying, and the trading-session state per market. Filter by market (EQUITY, HK_EQUITY, KR_EQUITY, CN_EQUITY, COMMODITY, INDEX, PREMARKET) or one symbol.",
+        inputSchema: {
+            market: z
+                .string()
+                .trim()
+                .toUpperCase()
+                .regex(/^[A-Z_]{3,16}$/)
+                .optional()
+                .describe("Market filter: EQUITY | HK_EQUITY | KR_EQUITY | CN_EQUITY | COMMODITY | INDEX | PREMARKET"),
+            symbol: z
+                .string()
+                .trim()
+                .toUpperCase()
+                .regex(/^[A-Z0-9]{2,24}$/)
+                .optional()
+                .describe("One Binance TradFi symbol, e.g. TSLAUSDT"),
+        },
+        annotations: READ_ONLY,
+    }, async ({ market, symbol }) => {
+        try {
+            const params = new URLSearchParams();
+            if (market)
+                params.set("market", market);
+            if (symbol)
+                params.set("symbol", symbol);
+            const qs = params.toString();
+            const path = `/api/public/tradfi${qs ? `?${qs}` : ""}`;
+            return ok(withProvenance(await fetchJson(path), path));
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
 }

package/package.json

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