bykaranteli-mcp 0.17.0 → 0.21.0

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.
 
-34 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).
+45 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 34 tools, nothing to install, no key.
+assistant. Same 45 tools, nothing to install, no key.
 
 ## Quick start
 
@@ -65,6 +65,9 @@ Requires Node.js 18 or newer.
 | `get_theme_indices` | "Which crypto narrative is leading: AI, RWA, DePIN, memes, L2s, DeFi?" |
 | `get_factor_board` | "Which indicators sit in an unusual band today, and what followed historically?" |
 | `get_venue_markets` | "Total BTC open interest across exchanges?", "What is the DEX share of perp OI?", "Is USDT off peg anywhere?" |
+| `get_leverage_tiers` | "How much leverage does Bybit allow on SOL?", "Which exchange has the highest max leverage for DOGE?", "Did any venue cut leverage on a coin this week?" |
+| `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_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?" |
@@ -78,6 +81,7 @@ Requires Node.js 18 or newer.
 | `get_positioning` | "BTC long/short ratio on Binance? Are top traders net short ETH? CVD today?" |
 | `get_coverage` | "Which exchanges are behind your liquidation totals? How fresh is the data?" |
 | `get_orderbook_depth` | "Where is the biggest BTC bid wall? How deep is ETH within 2% on Coinbase vs Binance?" |
+| `get_jupiter_perps` | "How much long vs short OI is on Jupiter SOL perps? Who topped Jupiter this week? What is the JLP APR?" |
 | `get_cycle_indicators` | "Has the Pi Cycle crossed? Mayer Multiple and Puell today?" |
 | `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?" |
@@ -112,7 +116,7 @@ MIT. Attribution appreciated: "ByKaranteli (bykaranteli.com)".
 
 ## Paid depth (optional)
 
-The 34 tools above are free and stay free. For recorded history and raw records
+The 45 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

@@ -615,6 +615,63 @@ export function registerByKaranteliTools(server, options) {
             return fail(err);
         }
     });
+    server.registerTool("get_venue_profile", {
+        title: "Venue profile: everything ByKaranteli records about one exchange",
+        description: "Call this when the user asks about a specific exchange (Bybit, OKX, Gate, KuCoin, HTX, Bitget, MEXC, BitMEX, Hyperliquid ...): how many contracts it lists, its perp open interest and average funding, its leverage ladders, deposit and withdrawal networks and how many are paused, its base fee schedule, its status uptime and the recent event log (listings, delistings, leverage cuts, withdrawal pauses, incidents). Without venue returns the list of recorded venues.",
+        inputSchema: { venue: z.string().optional().describe("string, optional venue id, e.g. bybit") },
+        annotations: READ_ONLY,
+    }, async (args) => {
+        try {
+            return ok(withProvenance(await fetchJson(args.venue ? `/api/public/venues/profile?venue=${encodeURIComponent(String(args.venue).toLowerCase())}` : "/api/public/venues/profile"), args.venue ? `/api/public/venues/profile?venue=${encodeURIComponent(String(args.venue).toLowerCase())}` : "/api/public/venues/profile"));
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    server.registerTool("get_withdrawal_status", {
+        title: "Withdrawal status and network fees: which exchanges paused withdrawals, per asset and network",
+        description: "Call this when the user asks whether an exchange has paused withdrawals or deposits, which networks are open for an asset, what the withdrawal fee or minimum is on each venue, or which venue is cheapest to withdraw from. Without arguments returns the overview (withdrawals paused right now, ranked, plus recent suspension and resumption events). Pass asset (e.g. USDT) for every venue and network of that asset, and venue (e.g. kucoin) to narrow. Recorded daily by ByKaranteli from 20+ venues' public currency lists.",
+        inputSchema: {
+            asset: z.string().optional().describe("string, optional asset code, e.g. USDT"),
+            venue: z.string().optional().describe("string, optional venue id, e.g. kucoin"),
+        },
+        annotations: READ_ONLY,
+    }, async (args) => {
+        try {
+            const qs = new URLSearchParams();
+            if (args.asset)
+                qs.set("asset", String(args.asset).toUpperCase());
+            if (args.venue)
+                qs.set("venue", String(args.venue).toLowerCase());
+            const q = qs.toString();
+            return ok(withProvenance(await fetchJson(`/api/public/withdrawals${q ? `?${q}` : ""}`), `/api/public/withdrawals${q ? `?${q}` : ""}`));
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    server.registerTool("get_leverage_tiers", {
+        title: "Leverage tiers: max leverage and maintenance margin per perpetual on every venue",
+        description: "Call this when the user asks how much leverage an exchange allows on a coin, what the maintenance margin or risk limit ladder is, which venue offers the highest leverage for a symbol, or whether an exchange recently cut leverage. Returns the current ladder per venue (tier, notional floor and cap, max leverage, maintenance margin rate) recorded daily by ByKaranteli, plus a change log. Pass symbol for one base asset (e.g. SOL) and venue for one exchange (bybit, okx, gate, htx, bitget, mexc).",
+        inputSchema: {
+            symbol: z.string().optional().describe("string, optional base asset, e.g. BTC"),
+            venue: z.string().optional().describe("string, optional venue id, e.g. bybit"),
+        },
+        annotations: READ_ONLY,
+    }, async (args) => {
+        try {
+            const qs = new URLSearchParams();
+            if (args.symbol)
+                qs.set("symbol", String(args.symbol).toUpperCase());
+            if (args.venue)
+                qs.set("venue", String(args.venue).toLowerCase());
+            const q = qs.toString();
+            return ok(withProvenance(await fetchJson(`/api/public/leverage-tiers${q ? `?${q}` : ""}`), `/api/public/leverage-tiers${q ? `?${q}` : ""}`));
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
     server.registerTool("get_venue_markets", {
         title: "Exchange coverage: OI, volume, funding and pegs across 43 exchanges",
         description: "Call this when the user asks about total open interest across exchanges, which venues hold the most OI, DEX versus CEX share, funding dispersion between venues, or stablecoin pegs. Returns the latest 10-minute snapshot aggregates across 56 feeds on 43 exchanges; pass symbol for one coin's per-venue rows.",
@@ -871,6 +928,29 @@ export function registerByKaranteliTools(server, options) {
             return fail(err);
         }
     });
+    server.registerTool("get_jupiter_perps", {
+        title: "Jupiter Perps (Solana): exact long/short OI, utilization, borrow rates, weekly top traders",
+        description: "Call this when the user asks about Jupiter perpetuals on Solana: long versus short open interest per market (SOL, ETH, BTC) read from the on-chain custody state, pool utilization and hourly borrow rates, JLP pool AUM and APR, 24h volume, or the week's top traders by realized PnL. Pass base and history_days for the hourly OI history.",
+        inputSchema: {
+            base: z.string().trim().toUpperCase().regex(/^(SOL|ETH|BTC)$/).optional().describe("Market base: SOL, ETH or BTC"),
+            history_days: z.number().int().min(1).max(30).optional().describe("Include hourly OI history for the base, 1..30 days"),
+        },
+        annotations: READ_ONLY,
+    }, async ({ base, history_days }) => {
+        try {
+            const q = new URLSearchParams();
+            if (base)
+                q.set("base", base);
+            if (history_days)
+                q.set("days", String(history_days));
+            const qs = q.toString();
+            const path = `/api/public/jupiter${qs ? `?${qs}` : ""}`;
+            return ok(withProvenance(await fetchJson(path), path));
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
     server.registerTool("get_coverage", {
         title: "Coverage registry: which venues and data types we collect, how, and how fresh",
         description: "Call this when the user asks which exchanges sit behind a ByKaranteli number, whether a feed is complete or sampled, since when a venue is collected, or how fresh the data is. Returns the live coverage registry: liquidation feeds per venue with kind and last record, snapshot feeds per venue and market, funding arbitrage legs, positioning sources, whale tape, spot minutes and the Hyperliquid whale scan with freshness.",

package/package.json

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