bykaranteli-mcp 0.26.2 → 0.27.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, liquidations, options, ETF flows, Fear & Greed and BTC dominance.
 
-45 read-only tools over the public JSON API of [bykaranteli.com](https://bykaranteli.com/developers). Since 2026-09-17 the API asks programs for an account key: a **free key** comes with any verified account at <https://bykaranteli.com/dashboard/api> (30 requests a minute, public depth), and the Builder, Business and Scale plans raise the rate and unlock member depth (LiqMap on seven timeframes, 5-minute series, the x402 catalog included). Set it as `BYKARANTELI_API_KEY`. Data covers Binance USDT-M perpetuals (funding arbitrage additionally compares OKX, Bybit, Gate, HTX, BingX, Kraken, MEXC and Bitget).
+46 read-only tools over the public JSON API of [bykaranteli.com](https://bykaranteli.com/developers). Since 2026-09-10 the API asks programs for an account key: a **free key** comes with any verified account at <https://bykaranteli.com/dashboard/api> (30 requests a minute, public depth), and the Builder, Business and Scale plans raise the rate and unlock member depth (LiqMap on seven timeframes, 5-minute series, the x402 catalog included). Set it as `BYKARANTELI_API_KEY`. 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 45 tools, nothing to install. Without a key it runs on the
+assistant. Same 46 tools, nothing to install. Without a key it runs on the
 shared Free pool; a connector header `Authorization: Bearer bk_...` (Builder
 and above) brings your own rate limit and member depth.
 
@@ -97,7 +97,7 @@ All responses are JSON and carry a `generatedAt` timestamp plus a `source` URL t
 
 | Env var | Default | Purpose |
 |---|---|---|
-| `BYKARANTELI_API_KEY` | none | Account key (`bk_...`) sent as `Authorization: Bearer`. Free at <https://bykaranteli.com/dashboard/api>; required for programs from 2026-09-17 |
+| `BYKARANTELI_API_KEY` | none | Account key (`bk_...`) sent as `Authorization: Bearer`. Free at <https://bykaranteli.com/dashboard/api>; required for programs from 2026-09-10 |
 | `BYKARANTELI_BASE_URL` | `https://bykaranteli.com` | Override the API host (testing only) |
 
 ## Data notes

package/dist/tools.d.ts

@@ -16,7 +16,7 @@ export type RegisterOptions = {
     /** Version string for the outbound user-agent. */
     version?: string;
     /** Account API key (bk_...) sent as Authorization: Bearer on every fetch.
-     * Since 2026-09-17 the public API asks programs for one; a free key comes
+     * Since 2026-09-10 the public API asks programs for one; a free key comes
      * with any verified account (https://bykaranteli.com/dashboard/api) and paid
      * plans raise the rate and unlock member depth. Falls back to the
      * BYKARANTELI_API_KEY environment variable. */

package/dist/tools.js

@@ -946,6 +946,29 @@ export function registerByKaranteliTools(server, options) {
             return fail(err);
         }
     });
+    server.registerTool("get_turkey_premium", {
+        title: "Turkey premium: TRY reference prices from Turkish venues and the premium over the global price",
+        description: "Call this when the user asks about Bitcoin, Ether or USDT prices in Turkish lira, the Turkey premium, the USDT/TRY rate or dollar premium in Turkey, or which Turkish exchanges (BtcTurk, Bitlo, CoinTR, OKX TR, Binance TR, Bybit TR, KuCoin TR, Bitexen) trade above or below the global price. Returns the live board: five reference prices (median of eligible order books), per-venue book status, spread and depth, premiums in basis points. Pass pair and history_days for 15-minute history of one pair.",
+        inputSchema: {
+            pair: z.string().trim().toUpperCase().regex(/^(BTC-TRY|ETH-TRY|USDT-TRY|BTC-USDT|ETH-USDT)$/).optional().describe("Pair: BTC-TRY, ETH-TRY, USDT-TRY, BTC-USDT or ETH-USDT"),
+            history_days: z.number().int().min(1).max(30).optional().describe("Include 15-minute index history for the pair, 1..30 days"),
+        },
+        annotations: READ_ONLY,
+    }, async ({ pair, history_days }) => {
+        try {
+            const q = new URLSearchParams();
+            if (pair)
+                q.set("pair", pair);
+            if (history_days)
+                q.set("days", String(history_days));
+            const qs = q.toString();
+            const path = `/api/public/turkey-premium${qs ? `?${qs}` : ""}`;
+            return ok(withProvenance(await fetchJson(path), path));
+        }
+        catch (err) {
+            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.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bykaranteli-mcp",
-  "version": "0.26.2",
+  "version": "0.27.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. 45 read-only tools, free account key, paid depth via plans or x402.",
   "type": "module",
   "bin": {