bykaranteli-mcp 1.1.0 → 1.1.2

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 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.
 
+## [1.1.2] - 2026-11-09
+
+68 tools. Text only, no behaviour change.
+
+### Added
+
+- The server now sends `instructions` in its `initialize` answer: one paragraph a client model reads before its first call. It says that every market-data tool is read-only and the account tools that write are marked, that a free key is for evaluation and personal scripts while a bot, a dashboard or a polling agent that runs continuously takes a plan, that a tool is called no more often than its data refreshes, and that a 429 answer carries `retry-after`. The hosted endpoint has sent the same paragraph since 7 Nov 2026; the release check compares the two.
+
+## [1.1.1] - 2026-11-03
+
+68 tools. Text only, no behaviour change.
+
+### Changed
+
+- `get_liqmap`: the description and the `symbol` parameter now name the stock and commodity perps the map covers (XAU gold, XAG silver, CL WTI crude, BZ Brent, NATGAS, COPPER, XPT platinum, XPD palladium, stocks by ticker), so an assistant asked for the gold or oil liquidation map picks the tool and the right contract code.
+
 ## [1.1.0] - 2026-10-24
 
 68 tools.

package/README.md

@@ -117,7 +117,7 @@ Requires Node.js 20 or newer (1.0.0; the 0.x releases ran on 18). The server spe
 | `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?" |
 | `get_quantum_exposure` | "How much Bitcoin is quantum-vulnerable?", "What is the P2PK exposure?" |
-| `get_liqmap` | "Where are the BTC liquidation clusters?", "Where would leveraged longs get liquidated?" |
+| `get_liqmap` | "Where are the BTC liquidation clusters?", "Where would leveraged longs get liquidated?", "Where are the gold (XAU) or crude oil (CL) liquidation clusters?" |
 | `get_market_profile` | "Where is the BTC point of control today?", "What was yesterday's value area?", "Which naked POCs are still untested?" |
 | `get_options_chain` | "How did BTC open interest move by strike today?", "Where is ETH ATM IV hour by hour?", "Which expiry gained the most open interest in 24h?" |
 | `get_hl_positions` | "Where do Hyperliquid whales get liquidated on BTC?", "How much tracked notional sits below price?", "Does the model agree with the tracked positions?" |

package/dist/index.js

@@ -24,8 +24,13 @@ const MAX_TOOL_INPUT_ELEMENTS = 2_000;
  * 0.x releases served it; a client that opens with a 2026-07-28 per-request envelope (`server/discover` is the
  * modern probe) is served on that revision, with the same tools. The factory is called once per connection, plus
  * once for a discarded probe instance, so it registers the tools afresh each time. */
+/* initialize.instructions (1.1.2, owner rule 2026-11-07): the one paragraph a client model reads before its first call,
+ * the same text the hosted endpoint sends (web/src/lib/mcp-hosted.ts HOSTED_INSTRUCTIONS; ops/mcp-release-check.py
+ * compares the two). Advice a well-behaved agent follows and relays to its user, never enforcement: the plan's rate
+ * and monthly figures refuse on the server, and a client's provider does not police our terms. */
+const INSTRUCTIONS = "ByKaranteli serves recorded crypto derivatives market data (liquidations, funding, open interest, options, ETF flows, positioning, order flow); every market-data tool is read-only, and the account tools that change alerts or the watchlist are marked as writes. A free key is for evaluation and personal scripts; a bot, a dashboard or a polling agent that runs continuously takes a plan (Terminal, Builder or Business by use). Call a tool no more often than its data refreshes (the daily brief once a day). A 429 answer carries retry-after: wait that long before calling again instead of retrying.";
 function buildServer() {
-    const server = new McpServer({ name: "bykaranteli", version: VERSION }, { maxToolInputElements: MAX_TOOL_INPUT_ELEMENTS });
+    const server = new McpServer({ name: "bykaranteli", version: VERSION }, { maxToolInputElements: MAX_TOOL_INPUT_ELEMENTS, instructions: INSTRUCTIONS });
     registerByKaranteliTools(server, { version: VERSION });
     return server;
 }

package/dist/tools.js

@@ -1262,7 +1262,7 @@ export function registerByKaranteliTools(target, options) {
     });
     server.registerTool("get_liqmap", {
         title: "LiqMap: estimated liquidation clusters with real prints overlaid",
-        description: "Call this when the user asks where liquidation clusters or liquidity pools sit for a perpetual, where leveraged longs/shorts would get liquidated, or for a liquidation heatmap reading. Returns the LiqMap snapshot for one symbol: modeled liquidation levels by price, zone aggregates and real liquidation prints from every liquidation venue ByKaranteli counts (listed on bykaranteli.com/coverage). On the Free plan the 24h view; on Builder and higher plans every timeframe from 1h to 30d. By default the 30 real levels nearest the price and the 30 largest real prints; pass detail \"full\" for all of them. Pass detail \"compact\" for a shorter page or \"full\" for the whole answer.",
+        description: "Call this when the user asks where liquidation clusters or liquidity pools sit for a perpetual, where leveraged longs/shorts would get liquidated, or for a liquidation heatmap reading. Covers the crypto perps and the stock and commodity perps: gold is XAU, silver XAG, WTI crude oil CL, Brent BZ, natural gas NATGAS, copper COPPER, platinum XPT, palladium XPD, stocks their ticker (TSLA, NVDA). Returns the LiqMap snapshot for one symbol: modeled liquidation levels by price, zone aggregates and real liquidation prints from every liquidation venue ByKaranteli counts (listed on bykaranteli.com/coverage). On the Free plan the 24h view; on Builder and higher plans every timeframe from 1h to 30d. By default the 30 real levels nearest the price and the 30 largest real prints; pass detail \"full\" for all of them. Pass detail \"compact\" for a shorter page or \"full\" for the whole answer.",
         inputSchema: {
             symbol: z
                 .string()
@@ -1270,7 +1270,7 @@ export function registerByKaranteliTools(target, options) {
                 .toUpperCase()
                 .regex(/^[A-Z0-9]{2,20}$/)
                 .optional()
-                .describe("Symbol like BTCUSDT (bare BTC accepted). Default BTCUSDT."),
+                .describe("Symbol like BTCUSDT (bare BTC accepted). Commodity perps use the contract code: XAU gold, XAG silver, CL WTI crude, BZ Brent, NATGAS, COPPER, XPT platinum, XPD palladium; stocks their ticker (TSLA). Default BTCUSDT."),
             timeframe: z
                 .enum(["1h", "4h", "12h", "24h", "3d", "1w", "30d"])
                 .optional()

package/package.json

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