bykaranteli-mcp 0.34.3 → 0.34.5

package/CHANGELOG.md

@@ -2,6 +2,23 @@
 
 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.5] - 2026-10-09
+
+67 tools. README only; the server code is the same as 0.34.3.
+
+### Changed
+
+- README introduction: the paid plans bring a monthly allowance of x402 catalog calls within each plan's history window (it said the catalog was included in the monthly fair use, which the 2026-10-09 ladder replaced with a ceiling and a window), with a link to the plan table.
+
+## [0.34.4] - 2026-10-09
+
+67 tools. README only; the server code is the same as 0.34.3.
+
+### Changed
+
+- README plan table and x402 paragraph follow the 2026-10-09 plan ladder: Builder includes 1,000 x402 catalog calls a month over the last 90 days at up to 5,000 rows a call, with raw record routes paid per call; Business 10,000 a month over the last 365 days with raw records; Scale has no monthly ceiling and reads the whole archive. A call past the ceiling, before the window or on a raw record route below Business answers with the way to pay per call (a prepaid key in `x-api-key`, or a wallet without the account key) or to move up a plan.
+- README bulk exports line names its window: Business the last 365 days, Scale the whole archive (Scale listed "daily raw" exports, which the plan never carried).
+
 ## [0.34.3] - 2026-10-08
 
 67 tools.

package/README.md

@@ -2,7 +2,7 @@
 
 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.
 
-67 read-only and account tools over the public JSON API of [bykaranteli.com](https://bykaranteli.com/developers): the market data tools only read, and the alert and watchlist tools act on your own account through your key ([Account tools](#account-tools-alerts-and-watchlist)). 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 and 15,000 a month, public depth), and the Builder, Business and Scale plans raise the rate and the monthly fair use and unlock member depth (LiqMap on seven timeframes, 5-minute series, the x402 catalog included in the monthly fair use). Set it as `BYKARANTELI_API_KEY`. Data covers Binance USDT-M perpetuals; funding arbitrage, liquidations, order book depth, options, positioning and insurance funds add the other venues each board lists on bykaranteli.com/coverage.
+67 read-only and account tools over the public JSON API of [bykaranteli.com](https://bykaranteli.com/developers): the market data tools only read, and the alert and watchlist tools act on your own account through your key ([Account tools](#account-tools-alerts-and-watchlist)). 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 and 15,000 a month, public depth), and the Builder, Business and Scale plans raise the rate and the monthly fair use and unlock member depth (LiqMap on seven timeframes, 5-minute series) and a monthly allowance of x402 catalog calls within each plan's history window ([Plans and paid depth](#plans-and-paid-depth)). Set it as `BYKARANTELI_API_KEY`. Data covers Binance USDT-M perpetuals; funding arbitrage, liquidations, order book depth, options, positioning and insurance funds add the other venues each board lists on bykaranteli.com/coverage.
 
 ## Hosted endpoint (no install)
 
@@ -179,9 +179,9 @@ Server: MIT. Data: personal and research use with attribution "ByKaranteli (byka
 |---|---|---|---|
 | Free API | 30 / min | 15,000 | public pages |
 | Terminal | 60 / min | 150,000 | public pages |
-| Builder | 300 / min | 1,000,000 fair use | member depth, x402 catalog included, each call counts as 10 requests of the monthly fair use |
-| Business | 1,200 / min | 3,000,000 fair use | member depth, commercial licence, x402 catalog included, each call counts as 10 requests of the monthly fair use, monthly bulk |
-| Scale | 3,000 / min | 10,000,000 fair use | member depth, derived redistribution, x402 catalog included, each call counts as 10 requests of the monthly fair use, daily raw |
+| Builder | 300 / min | 1,000,000 fair use | member depth, x402 catalog: 1,000 calls a month included over the last 90 days at up to 5,000 rows a call, summary series only, raw record routes paid per call |
+| Business | 1,200 / min | 3,000,000 fair use | member depth, commercial licence, x402 catalog: 10,000 calls a month included over the last 365 days with raw records, monthly bulk exports over the same window |
+| Scale | 3,000 / min | 10,000,000 fair use | member depth, derived redistribution, x402 catalog with no monthly ceiling over the whole archive with raw records, monthly bulk exports over the whole archive |
 
 Prices: https://bykaranteli.com/pricing
 
@@ -195,4 +195,7 @@ raw records beyond the live snapshots, bykaranteli.com also exposes pay-per-call
 x402 endpoints for anonymous agents (USDC on Solana or Base, priced per call,
 no account): <https://bykaranteli.com/developers#x402> · machine catalog:
 <https://bykaranteli.com/api/x402>. Builder, Business and Scale keys call those
-routes unpaid; each call counts as 10 requests of the monthly fair use.
+routes unpaid within the plan's catalog allowance (table above); each included
+call also counts as 10 requests of the monthly fair use. A call the plan does not
+include answers `x402_allowance_used`, `history_window` or `raw_tier_required`:
+pay it with a prepaid key in `x-api-key`, or without the account key from a wallet.

package/package.json

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