bykaranteli-mcp 0.5.0 → 0.7.0

package/README.md

@@ -53,6 +53,10 @@ Requires Node.js 18 or newer.
 | `get_flow_toxicity` | "Is toxic order flow building?", "What is BTC's VPIN right now?" |
 | `get_options_flow` | "What are the big options players buying?", "Any block trades today?" |
 | `get_slippage` | "How much slippage on a $1M market order?", "Which book is thinnest?" |
+| `get_fomc_impact` | "What does BTC do on Fed days?", "When is the next FOMC meeting?" |
+| `get_liquidation_cascades` | "What caused that flush?", "Who got liquidated this week?" |
+| `get_open_interest` | "Is leverage entering the market?", "Are shorts building in XRP?" |
+| `get_psi_charge` | "What liquidity state is the market in?", "Is parked money deploying?" |
 
 All responses are JSON and carry a `generatedAt` timestamp plus a `source` URL to the human-readable page. Symbols accept both `BTCUSDT` and bare `BTC`.
 

package/dist/tools.js

@@ -397,4 +397,56 @@ export function registerByKaranteliTools(server, options) {
             return fail(err);
         }
     });
+    server.registerTool("get_fomc_impact", {
+        title: "Measured FOMC impact on Bitcoin",
+        description: "Call this when the user asks what Bitcoin does on Fed days, how FOMC statements move crypto, or when the next FOMC meeting is. Returns per-statement 5/30/60-minute BTC reactions measured from a minute-resolution record, the average move versus a normal half hour, the up/down split (near a coin flip), and the next meeting date. Description, not prediction.",
+        inputSchema: {},
+        annotations: READ_ONLY,
+    }, async () => {
+        try {
+            return ok(await fetchJson("/api/public/events"));
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    server.registerTool("get_liquidation_cascades", {
+        title: "Auto-detected liquidation cascades (forensic case file)",
+        description: "Call this when the user asks what caused a recent crash or flush, about liquidation cascades, or who got liquidated. Returns auto-detected cascade incidents: when, total notional flushed, long/short split, which coins led, and BTC's move during the window. Totals are an honestly-labeled lower bound from a real liquidation tape.",
+        inputSchema: {},
+        annotations: READ_ONLY,
+    }, async () => {
+        try {
+            return ok(await fetchJson("/api/public/incidents"));
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    server.registerTool("get_open_interest", {
+        title: "Intraday open interest and leverage regimes (10 major perps)",
+        description: "Call this when the user asks whether leverage is entering or leaving the market, about open interest changes, or whether longs or shorts are building in a major coin. Returns 5-minute-resolution OI with 24h OI and price deltas and a four-regime read per symbol: longs building, shorts building, long squeeze, short squeeze, or quiet.",
+        inputSchema: {},
+        annotations: READ_ONLY,
+    }, async () => {
+        try {
+            return ok(await fetchJson("/api/public/oi"));
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    server.registerTool("get_psi_charge", {
+        title: "PsiCharge liquidity state (proprietary model, outcomes published)",
+        description: "Call this when the user asks about the market's hidden liquidity state, PsiCharge, or whether parked money is deploying or stress is unwinding. Returns the current Psi score (0-100), state (superposition = charge building, collapse = low-stress discharge, purge = high-stress discharge and historically the most consistent risk-off state, ground = ordinary), stress locality, recent alarms and the year-split measured scorecard. Inputs are proprietary; outcomes are always published. Not a trade signal, not a crash predictor.",
+        inputSchema: {},
+        annotations: READ_ONLY,
+    }, async () => {
+        try {
+            return ok(await fetchJson("/api/public/charge"));
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
 }

package/package.json

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