bykaranteli-mcp 0.30.5 → 0.30.7

package/CHANGELOG.md

@@ -0,0 +1,139 @@
+# Changelog
+
+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.30.7] - 2026-09-30
+
+51 tools.
+
+### Changed
+
+- `get_options_snapshot` describes the per-expiry rows the API now returns (`expiries`: open interest by side, the max pain strike, the one-sigma implied move the ATM IV prices).
+
+### Added
+
+- This changelog ships inside the npm package, and the README links to it.
+
+## [0.30.6] - 2026-09-30
+
+51 tools.
+
+### Fixed
+
+- Source links of the IV surface, metric context, leverage tiers and open interest history tools point at pages that exist, and the options snapshot and options flow descriptions name the wall side, the single ATM strike and how multi-leg trades are netted.
+
+## [0.30.5] - 2026-09-28
+
+51 tools.
+
+### Fixed
+
+- `get_tokenized_stocks` accepts all twelve issuers, `get_solana_perps` passes the symbol as typed so mixed-case markets (kBONK, kPEPE, kSHIB) reach their history, and `get_turkey_premium` says KuCoin TR contributes the USDT pairs only.
+
+## [0.30.4] - 2026-09-25
+
+51 tools.
+
+### Changed
+
+- `get_solana_perps` covers six venues (Jupiter, Pacifica, Phoenix, GM Trade, Velocity, Bullet) with one-sided open interest and history on every venue but Jupiter.
+
+## [0.30.3] - 2026-09-25
+
+51 tools.
+
+### Added
+
+- `get_solana_perps`: the Solana Perps board with venues summed, every market and Pacifica hourly history.
+
+## [0.30.2] - 2026-09-25
+
+50 tools.
+
+### Changed
+
+- The hosted endpoint needs an account key; the README, the registry description and the remote header say so.
+
+## [0.30.1] - 2026-09-24
+
+50 tools.
+
+### Changed
+
+- `get_tokenized_stocks` describes `price_source` per wrapper and `totals.priced_by`.
+
+## [0.30.0] - 2026-09-23
+
+50 tools.
+
+### Added
+
+- `get_tokenized_stocks`: tokenized stock wrappers onchain and on exchanges.
+
+## [0.29.0] - 2026-09-23
+
+49 tools.
+
+### Added
+
+- `get_insurance_funds` (exchange insurance funds on Binance, Bybit, OKX and Gate) and a `venue` argument on `get_options_snapshot` (all, deribit, bybit, binance, okx, delta); `get_orderbook_depth` reports held-out books and venue wording no longer carries hand-written lists.
+
+## [0.28.3] - 2026-09-20
+
+48 tools.
+
+### Added
+
+- `get_liquidation_leaderboard`: the largest single liquidations over 24 hours, 7 days and 30 days, with a 30-day session heatmap.
+
+## [0.28.2] - 2026-09-20
+
+47 tools.
+
+### Changed
+
+- `get_positioning` names six venues (Gate, HTX and Bitget joined on 2026-09-20).
+
+## [0.28.1] - 2026-09-20
+
+47 tools.
+
+### Fixed
+
+- `get_pressure_scores` keeps the `byk_proof` reference in its slim output.
+
+## [0.28.0] - 2026-09-18
+
+47 tools.
+
+### Added
+
+- `get_data_proof`: onchain proofs of the BYK Data Layer on Solana and Base.
+
+## [0.27.2] - 2026-09-17
+
+46 tools.
+
+### Changed
+
+- The README lists `get_turkey_premium`, every description states the same tool count, and the `server.json` and Cursor plugin versions caught up with the package.
+
+## [0.27.1] - 2026-09-17
+
+46 tools. No git tag; the date is the version commit.
+
+### Changed
+
+- `get_turkey_premium` describes the Turkey Premium Index, its score and its regime.
+
+## [0.27.0] - 2026-09-17
+
+46 tools. No git tag; the date is the version commit.
+
+### Added
+
+- `get_turkey_premium`: TRY reference prices from eight Turkish venues and the premium in basis points.
+
+## Earlier versions
+
+Release notes for 0.26.3 and earlier are not recorded in this file; the git history and tags of this repository carry them.

package/README.md

@@ -132,6 +132,8 @@ npm run build
 node dist/index.js   # speaks MCP over stdio
 ```
 
+Release notes per version: [CHANGELOG.md](https://github.com/bykarantelicom/bykaranteli-mcp/blob/main/CHANGELOG.md).
+
 ## License
 
 Server: MIT. Data: personal and research use with attribution "ByKaranteli (bykaranteli.com)"; commercial use with the Business plan. Licence text: <https://bykaranteli.com/data#license>.

package/dist/tools.js

@@ -58,6 +58,10 @@ export function registerByKaranteliTools(server, options) {
         "/venues/markets": "/venues",
         "/venues/lead-lag": "/venues",
         "/venues/profile": "/venues",
+        "/venues/oi-history": "/venues",
+        "/options/surface": "/options",
+        "/context": "/methodology",
+        "/leverage-tiers": "/leverage",
         "/datasets/etf-flows": "/etf",
         "/datasets/liquidations-daily": "/liquidations",
     };
@@ -407,7 +411,7 @@ export function registerByKaranteliTools(server, options) {
     });
     server.registerTool("get_options_snapshot", {
         title: "Options walls, gamma exposure and DVOL (BTC + ETH)",
-        description: "Call this when the user asks where the big options bets sit, about call/put walls, gamma exposure (GEX), the zero-gamma level, implied volatility (DVOL) or the IV term structure for Bitcoin or Ethereum, across options venues or on one venue. Daily snapshot of the listed option chains of every options venue we record, summed by default or one venue with venue: top strikes by open interest, put/call ratio, dealer hedging map, ATM IV by expiry and each venue's open interest (venues_included). DVOL is Deribit's index whatever the venue.",
+        description: "Call this when the user asks where the big options bets sit, about call/put walls, gamma exposure (GEX), the zero-gamma level, implied volatility (DVOL) or the IV term structure for Bitcoin or Ethereum, across options venues or on one venue. Daily snapshot of the listed option chains of every options venue we record, summed by default or one venue with venue: the call wall (largest call open interest above spot) and put wall (largest put open interest below spot), the largest bars on the whole axis, top strikes by open interest, put/call ratio, dealer hedging map, ATM IV by expiry (calls and puts interpolated at the money, iv_source names the venue whose quotes price the chain), each venue's open interest (venues_included), and per expiry the open interest by side, the max pain strike (where the open contracts as a group pay out the least at settlement, not a price target) and the one-sigma implied move the ATM IV prices (expiries). DVOL is Deribit's index whatever the venue.",
         inputSchema: {
             venue: z.enum(["all", "deribit", "bybit", "binance", "okx", "delta"]).optional().describe("all (default) sums every options venue; or one venue id: deribit, bybit, binance, okx or delta (Delta Exchange India)."),
         },
@@ -449,7 +453,7 @@ export function registerByKaranteliTools(server, options) {
     });
     server.registerTool("get_options_flow", {
         title: "Options tape: biggest prints and premium flow (BTC + ETH)",
-        description: "Call this when the user asks what big options players are buying, about block trades, or whether call or put premium dominates today. Returns 24h call vs put premium bought, the block-trade share, and the largest prints of the last 48 hours with strikes, premium, IV and venue (Deribit or OKX). Updated every 15 minutes.",
+        description: "Call this when the user asks what big options players are buying, about block trades, or whether call or put premium dominates today. Returns 24h call vs put premium bought (net of the sold legs of the same multi-leg block or combo, so a spread counts its net premium), the block-trade share, the multi-leg structure count, and the largest prints of the last 48 hours with strikes, premium, IV, structure id and venue (Deribit or OKX). Updated every 15 minutes.",
         inputSchema: {},
         annotations: READ_ONLY,
     }, async () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bykaranteli-mcp",
-  "version": "0.30.5",
+  "version": "0.30.7",
   "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. 51 read-only tools, free account key, paid depth via plans or x402.",
   "type": "module",
   "bin": {
@@ -10,6 +10,7 @@
   "files": [
     "dist",
     "README.md",
+    "CHANGELOG.md",
     "LICENSE"
   ],
   "scripts": {