@battlegrid/mcp-server 32.0.40 → 32.0.43

package/README.md

@@ -38,6 +38,70 @@ Seeing package `31.x` alongside handshake `battlegrid@33.x` — the package **be
 
 **What this changes for you:** nothing about how you call anything. Upgrading the package no longer waits on a server deploy, and a server deploy no longer strands you on a package that names the wrong contract — reconnect and the announcement follows. **Contract breaking-change notes are no longer keyed to package versions**, since a contract move is no longer a release here; the v11-and-earlier notes below are kept as history, and the live vocabulary is always discovery.
 
+## Contract history — v137.3 (the bar's traded notional in USD)
+
+**Additive at v137.3: three metrics and one chart-axis family.** v137.3 is the contract on top of v137.2. Nothing a client
+sends is refused that v137.2 accepted. Reconnect the proxy, or restart it, so discovery reads the widened vocabulary.
+
+### Widened input — new metrics
+
+- **`QUOTE_VOL`** (`quoteVol`): the bar's traded notional in USD, the sum of each trade's price × size from the live tape.
+- **`BUY_QUOTE_VOL` and `SELL_QUOTE_VOL`** (`buyQuoteVol`, `sellQuoteVol`): the same, per taker side. The total is
+  always the two sides added.
+- **Each ranks exchange-wide**: one dollar is one dollar on every coin. The metric-key enum and the ranked-metric enum
+  widen on every input and output that carries them.
+- **A bar holding a minute the live tape did not cover reads each one absent, never zero.** An MDS restart opens such a
+  minute, so the bars around one read absent for now.
+
+### Widened output enum
+
+- **The chart-axis family gains `notional`**, the three metrics' own scale, on the output that carries it
+  (`get_agent_coin_qualification`'s `axisFamily`).
+
+### Digest move
+
+- **`vocabularyDigest` and the authoring catalog digest move** with the three metrics. A client caching vocabulary
+  against either re-reads `list_strategy_vocabulary`.
+
+## Contract history — v137.2 (the anchored VWAP family with σ bands, and week and month profiles)
+
+**Additive at v137.2: sixty-six metrics and five studies, one value withdrawn, and the metric vocabulary named once per
+schema.** v137.2 is the contract on top of v137.1. Nothing a client sends is refused that v137.1 accepted. Reconnect the
+proxy, or restart it, so discovery reads the widened vocabulary.
+
+### Widened input — new metrics and studies
+
+- **The anchored VWAP family**, each computed over the column's own timeframe as TradingView's `ta.vwap(hlc3)` computes it
+  on that chart: `VWAP_WEEK` (`vwapW`, from Monday 00:00 UTC), `VWAP_MONTH` (`vwapM`), `VWAP_TRADING_SESSION` (`vwapTs`),
+  `VWAP_ROLLING_1H`, `VWAP_ROLLING_4H` and `VWAP_ROLLING_24H` (`rvwap1h`, `rvwap4h`, `rvwap24h`), and `VWAP_SWING_HIGH`
+  and `VWAP_SWING_LOW` (`avwapSwHi`, `avwapSwLo`, anchored at the latest decided swing pivot).
+- **±1/2/3σ bands** `<LINE>_UB1..3` and `<LINE>_LB1..3` on `VWAP` and on each of the six new calendar and rolling lines
+  (42 metrics): `line ± k·σ`, with σ the volume-weighted standard deviation over the same bars. Each takes every transform
+  a price level takes, `levelInteraction` included.
+- **Week and month profiles**, summed from each period's UTC-day profiles on one grid: `WEEK_TPO_POC`/`VAH`/`VAL` and
+  `MONTH_TPO_POC`/`VAH`/`VAL` (the current period), `PRIOR_WEEK_TPO_*` and `PRIOR_MONTH_TPO_*`, and the previous
+  completed period's high and low, `PWH`/`PWL` and `PMH`/`PML`. A prior level read across its period's roll is absent.
+- **The studies** `vwap`, `weekProfile`, `priorWeek`, `monthProfile` and `priorMonth` join the vocabulary. The metric-key
+  enum widens on every input and output that carries it.
+- **Ranking.** The eight new VWAP lines rank exchange-wide by distance; the bands do not.
+
+### Changed values — the same schema serves a different number
+
+- **`VWAP` on `1d` reads null.** A UTC-day VWAP on a bar as long as the UTC day is only that bar's own typical price. On
+  every other timeframe `VWAP` is unchanged. Each anchored line is likewise absent on a timeframe whose bar is as long as
+  its anchor's period.
+
+### Schema respelling
+
+- **The metric vocabulary is one named shape, `metricKey`**, published once in each schema's root `$defs` and referenced
+  as `#/$defs/metricKey` wherever a metric is named, where it was inlined at each site. What a schema accepts does not
+  move; every authoring schema shrinks. `toolCount` stays 149.
+
+### Digest move
+
+- **`vocabularyDigest` and the authoring catalog digest move** with the sixty-six metrics and five studies. A client
+  caching vocabulary against either re-reads `list_strategy_vocabulary`.
+
 ## Contract history — v137.1 (a condition exit's evidence and slippage)
 
 **Additive at v137.1: one owner output field, and one served value moves.** v137.1 is the contract on top of v137.

package/dist/index.d.ts

@@ -47,7 +47,7 @@ import { Client, StreamableHTTPClientTransport } from '@modelcontextprotocol/cli
  * being asked. Move it for a change to THIS package — a proxy fix, a dependency bump, a docs
  * correction. Never move it to track the server.
  */
-export declare const PACKAGE_VERSION = "32.0.40";
+export declare const PACKAGE_VERSION = "32.0.43";
 export declare const DEFAULT_URL = "https://mcp.battlegrid.trade/mcp";
 export interface EnvConfig {
     apiKeys: string[];

package/dist/index.js

@@ -49,7 +49,7 @@ import { Client, SdkHttpError, StreamableHTTPClientTransport } from '@modelconte
  * being asked. Move it for a change to THIS package — a proxy fix, a dependency bump, a docs
  * correction. Never move it to track the server.
  */
-export const PACKAGE_VERSION = '32.0.40';
+export const PACKAGE_VERSION = '32.0.43';
 export const DEFAULT_URL = 'https://mcp.battlegrid.trade/mcp';
 const MAX_RETRIES = 3;
 const RETRY_DELAYS_MS = [2000, 4000, 8000];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@battlegrid/mcp-server",
-  "version": "32.0.40",
+  "version": "32.0.43",
   "description": "BattleGrid MCP server — play crypto prediction games from AI agents",
   "type": "module",
   "main": "dist/index.js",

package/skills/EXPORT.json

@@ -1,6 +1,6 @@
 {
   "generator": "battlegrid-app/server/scripts/export-mcp-skills.mjs",
-  "contractVersion": "136.1.0",
+  "contractVersion": "137.2.0",
   "files": {
     "battlegrid-agent-management/SKILL.md": "91d1be4de1e33d54e1852c970af66ad176068fd16c30b4326e49053b7a35eb32",
     "battlegrid-agent-management/references/agent-stage-examples.md": "dffcc353d61dfc7b5bb6a2b3077fc6bf8c760a34c287cafb3b59b99306f24195",
@@ -18,7 +18,7 @@
     "battlegrid-strategy-examples/SKILL.md": "cbbc7a7271aaa9f530a11d91511f4bf35a9632aa3ab67ecd996975c65ae72625",
     "battlegrid-strategy-examples/references/playbooks.md": "59996c37eea08e7ce398e49304171939e55c968400a1603597d6737faf9e1771",
     "battlegrid-strategy-examples/references/recipes.md": "e1fbd1a3d1b2ef1408fef8642032c3e131954aedec6bdcefa3af6a655948e392",
-    "battlegrid-strategy-examples/references/tradingview-ports.md": "00f2ba287ff8fadf356273f61ad19630cceb3a706018c2088be40570ff1a899d",
+    "battlegrid-strategy-examples/references/tradingview-ports.md": "bc63e26b16458fd17b7bc567541fc9889ee857b444ccb2d3f011545635758d8f",
     "battlegrid-trade-analysis/SKILL.md": "140d847f24e98845736d4f0c2e72b318a4d235413f72f072d2fe6d0daa5f64db",
     "battlegrid-trade-proposal/SKILL.md": "bf8f3794478cdecc989020bd775c3c91744f72b440b1a90f88f6700c9a61ca24"
   }

package/skills/battlegrid-strategy-examples/references/tradingview-ports.md

@@ -61,7 +61,9 @@ rules about the columns themselves, not about porting — they live in the skill
   column, never as the substitute for the gate.
 - **VWAP reversion** → `dist_VWAP` band + `dist_VWAP_rank_far lte 5` for board-relative
   stretch; required `NOT [ADX14_state in ["trending","extreme"]]` veto; scalp geometry +
-  aggressive timeDecay (VWAP anchors daily at 00:00 UTC).
+  aggressive timeDecay (`VWAP` anchors daily at 00:00 UTC; `VWAP_WEEK`, `VWAP_MONTH`, `VWAP_TRADING_SESSION` and
+  the rolling `VWAP_ROLLING_1H`/`4H`/`24H` are the other anchors, each with ±1/2/3σ bands `_UB<k>`/`_LB<k>` — a
+  band-touch entry reads `CLOSE × spread(VWAP_LB2)` rather than a hand-computed σ).
 - **Donchian / Turtle breakout** (`close > ta.highest(high, 20)[1]`) → `dist_donchianHiPrior20 crossesAbove 0`
   over `DONCHIAN_UPPER_PRIOR × distance` (the breakout bar; `dist_donchianHiPrior20 gt 0` holds on every
   close of the run) + `RVOL20 gte 1.5`; turtle exits = trend preset (trail from 1R, giveback 50). Mirror with
@@ -117,8 +119,8 @@ rules about the columns themselves, not about porting — they live in the skill
   `MACD_LINE × crossDetect`, and the signal-line cross is `MACD_HIST × crossDetect`, the histogram being
   line minus signal), the 15-bar rate of change (`ROC15`), the Donchian break memory
   (`DONCHIAN_BROKEN_HI`/`DONCHIAN_BROKEN_LO`), daily pivots
-  (`PIVOT_P`/`PIVOT_R1`–`R3`/`PIVOT_S1`–`S3`), Williams %R (`WILLR14`), Stochastic RSI
-  (`STOCH_RSI14`), the TTM squeeze (`KC_SQUEEZE`), Connors RSI-2 (`RSI2`), the 8/9/21/50 EMAs
+  (`PIVOT_P`/`PIVOT_R1`–`R3`/`PIVOT_S1`–`S3`), Williams %R (`WILLR14`), Stoch RSI
+  (`STOCH_RSI_K`/`STOCH_RSI_D` — TradingView's "Stoch RSI" %K and %D at 3, 3, 14, 14, on 0–100), the TTM squeeze (`KC_SQUEEZE`), Connors RSI-2 (`RSI2`), the 8/9/21/50 EMAs
   (`EMA8`/`EMA9`/`EMA21`/`EMA50` — `ta.ema(close, 8)` is `EMA8`, its distance `dist_EMA8`), literal
   previous-UTC-day levels (`PDH`/`PDL`/`PDO`), fractal swing structure
   (`SWING_FRACTAL_HIGH`/`SWING_FRACTAL_LOW`/`SWING_FRACTAL_LABEL`, the prior pivots