bykaranteli-mcp 1.1.1 → 1.1.2

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 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.

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/package.json

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