bykaranteli-mcp 0.34.2 → 0.34.3

package/CHANGELOG.md

@@ -2,6 +2,15 @@
 
 Notable changes to the `bykaranteli-mcp` package. The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and versions follow [Semantic Versioning](https://semver.org/spec/v2.0.0.html). Dates are UTC and come from the git tag of each release (the version commit where no tag exists). The tool count is the number of tools the server registers in that release.
 
+## [0.34.3] - 2026-10-08
+
+67 tools.
+
+### Fixed
+
+- `chart_url` of `get_liquidations` and `get_etf_flows` opens the symbol or asset the call filtered on (the dataset path carried no filter, so every link opened BTCUSDT).
+- `chart_url` of `get_options_snapshot` with a venue sets the options levels' own key (`lvv`), not the OI and funding panes' venue (`v`), so the chart draws the same venue's levels the answer reports.
+
 ## [0.34.2] - 2026-10-08
 
 67 tools.

package/dist/provenance.js

@@ -63,12 +63,13 @@ function chartSymbol(q) {
         return "BTCUSDT";
     return /USDT$|USD$|PERP$/.test(raw) ? raw : `${raw}USDT`;
 }
-/** The venue and the window of the request as chart keys (empty when the request names neither). */
-function chartExtras(q, periodMs) {
+/** The venue and the window of the request as chart keys (empty when the request names neither). `venueKey` is the
+ * chart key the venue belongs to: v for the OI and funding panes, lvv for the options levels (2026-10-08). */
+function chartExtras(q, periodMs, venueKey = "v") {
     let out = "";
     const venue = (q.get("venue") ?? "").toLowerCase().replace(/[^a-z0-9]/g, "");
-    if (venue && venue !== "binance" && venue !== "all")
-        out += `&v=${venue}`;
+    if (venue && venue !== "all" && (venueKey === "lvv" || venue !== "binance"))
+        out += `&${venueKey}=${venue}`;
     const toRaw = q.get("to");
     const fromRaw = q.get("from");
     const to = toRaw ? Date.parse(toRaw) : NaN;
@@ -95,7 +96,7 @@ export function chartUrlForApiPath(path) {
         return `${CHART_BASE}?s=${s}&panes=liquidations,oi&heat=1&pr=1&rv=1${x}`;
     }
     if (clean.startsWith("/api/public/options"))
-        return `${CHART_BASE}?s=${s}&panes=oi&lv=1&heat=1&pr=0${x}`;
+        return `${CHART_BASE}?s=${s}&panes=oi&lv=1&heat=1&pr=0${chartExtras(q, 0, "lvv")}`;
     if (clean.startsWith("/api/public/funding") || clean.startsWith("/api/public/heatmap"))
         return `${CHART_BASE}?s=${s}&panes=funding,oi&heat=1&pr=0${x}`;
     if (clean.startsWith("/api/public/oi"))

package/dist/tools.js

@@ -234,7 +234,7 @@ export function registerByKaranteliTools(server, options) {
                     ? `rows is capped at ${MAX_ROWS} of ${filtered.length} matching rows (largest first). Use summary.totals and summary.by_date for complete figures, or pass a symbol filter. ` + baseNote
                     : baseNote,
                 source: `${PUBLIC_URL}/liquidations`,
-                provenance: provenanceFor(d, "/api/v1/public/datasets/liquidations-daily.json", "/liquidations"),
+                provenance: provenanceFor(d, `/api/v1/public/datasets/liquidations-daily.json${wantSymbol ? `?symbol=${wantSymbol}` : ""}`, "/liquidations"),
             });
         }
         catch (err) {
@@ -273,7 +273,7 @@ export function registerByKaranteliTools(server, options) {
                 truncated: dates.length < new Set(filtered.map((r) => String(r.date))).size,
                 note: "Finalized US trading days only; a positive net_inflow_usd means the funds bought more of the asset than they sold that day. window_net_inflow_usd sums the returned window per asset.",
                 source: `${PUBLIC_URL}/etf`,
-                provenance: provenanceFor(d, "/api/v1/public/datasets/etf-flows.json", "/etf"),
+                provenance: provenanceFor(d, `/api/v1/public/datasets/etf-flows.json${asset ? `?asset=${asset}` : ""}`, "/etf"),
             });
         }
         catch (err) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bykaranteli-mcp",
-  "version": "0.34.2",
+  "version": "0.34.3",
   "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. 67 read-only and account tools (the alert and watchlist tools act on your own account), free account key, paid depth via plans or x402.",
   "type": "module",
   "bin": {