@battlegrid/mcp-server 31.2.97 → 31.2.98

package/README.md

@@ -24,6 +24,36 @@ 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 — v109 (a player's picks are entered through their entry draft)
+
+**Breaking at v109: `submit_market_grid` and `update_market_grid` are removed.** v109 is the contract on
+top of v108. A player's picks for a session live in their Market Grid entry draft — the same draft their
+builder on the session page writes as they pick — and an entry is placed or changed by committing it.
+
+### Rejected input — something you send is no longer accepted
+
+- **`submit_market_grid` and `update_market_grid`** leave discovery with no alias. A call gets the
+  standard unknown-tool refusal. Play is stage → get → commit:
+  `stage_market_grid_entry_draft({ request: { sessionId, draftVersion, axes } })` with one
+  `CELL_n: { cell: { coinId, prediction } }` per grid position (`CELL_0` is the captain) and a
+  `RATIONALE` carrying the reasoning, confidence, model name and per-cell pick reasoning the removed
+  tools required; `get_market_grid_entry_draft` for the diff, diagnostics and impact; then
+  `commit_market_grid_entry_draft({ request: { sessionId, draftVersion, expectedRevision } })` on the
+  player's word. `random_submit_market_grid` and `submit_agent_grid` are unchanged.
+
+### Added tools
+
+- **`get_market_grid_entry_draft`, `stage_market_grid_entry_draft`, `discard_market_grid_entry_draft`
+  and `list_market_grid_entry_drafts`** (`mcp:read`) read and stage the player's picks for free: no
+  entry, fee, deposit or LLM access. **`commit_market_grid_entry_draft`** (`mcp:wager`) enters a session
+  the player has not entered, charging the session's entry fee (the read's `impact.entryFee`), or
+  replaces a live entry's picks for no fee.
+
+### Refusal vocabulary
+
+- **An entry that already exists is a revision `CONFLICT`** naming the live entry's revision, with
+  `nextAct: get_draft`: read the draft again and commit over the revision it returns.
+
 ## Contract history — v108 (conditions are the only entry gate; signal rules are removed)
 
 **Breaking at v108: signal rules, the aggregate-score gate and the required-count gate are removed.**

package/SKILL.md

@@ -85,7 +85,8 @@ as a rebind. **`battlegrid-radar-deployment`** carries putting an agent on stand
 
 Predict UP or DOWN for each coin in the pool; exactly one coin is your **Captain** (2x score
 multiplier). **The arc lives in `battlegrid-arena-play`** — activate it to find a session, read its
-market context, compose a grid with real per-coin reasoning, submit it, and read the results.
+market context, stage picks with real per-coin reasoning into the player's entry draft (the same draft
+their builder writes), read it back, commit it on the player's word, and read the results.
 **`battlegrid-market-analysis`** carries the market read that informs the picks, and
 **`battlegrid-trade-analysis`** carries reading back how you have done.
 
@@ -93,7 +94,7 @@ The `play-market-grid` prompt (discover via `prompts/list`) provides a guided en
 
 ## Retired operations
 
-`create_strategy`, the plan tools (`compile_strategy_plan`, `stage_strategy_plan`, `apply_strategy_plan`), `update_strategy_signal_rule`, the signal-rule tools (`simulate_aggregate_score`, `list_strategy_signals`, `get_strategy_signal_definition`, `derive_strategy_rule_view`, `get_coin_signal_preview`), and the direct agent writers (`create_intelligence_agent`, `update_intelligence_agent`, `rebind_intelligence_agent`) are **retired** — they are absent from discovery and cannot be invoked. Stage into the entity's draft, read it back, and commit the version you read; a strategy's entry gate is its conditions (a required or verdict-carrying condition — a strategy with none never trades, and its draft warns `NO_ENTRY_CONDITION`), its ATR floor `minAtrPct` is part of the `TRADE_LEVEL_POLICY` axis, and a strategy binding is the agent draft's `STRATEGY_BINDING` axis. A deployment preview's `previewToken`, and the `confirm` on a deployment commit, resume, delete or draft discard, are retired the same way: a strict input refuses either key. Do not attempt flat legacy payloads; the server enforces a closed-world request root and the proxy never reconstructs them.
+`create_strategy`, the plan tools (`compile_strategy_plan`, `stage_strategy_plan`, `apply_strategy_plan`), `update_strategy_signal_rule`, the signal-rule tools (`simulate_aggregate_score`, `list_strategy_signals`, `get_strategy_signal_definition`, `derive_strategy_rule_view`, `get_coin_signal_preview`), the direct agent writers (`create_intelligence_agent`, `update_intelligence_agent`, `rebind_intelligence_agent`), and the direct grid writers (`submit_market_grid`, `update_market_grid`) are **retired** — they are absent from discovery and cannot be invoked. Stage into the entity's draft, read it back, and commit the version you read; a strategy's entry gate is its conditions (a required or verdict-carrying condition — a strategy with none never trades, and its draft warns `NO_ENTRY_CONDITION`), its ATR floor `minAtrPct` is part of the `TRADE_LEVEL_POLICY` axis, a strategy binding is the agent draft's `STRATEGY_BINDING` axis, and a player's Market Grid picks are the entry draft's `CELL_n` and `RATIONALE` axes. A deployment preview's `previewToken`, and the `confirm` on a deployment commit, resume, delete or draft discard, are retired the same way: a strict input refuses either key. Do not attempt flat legacy payloads; the server enforces a closed-world request root and the proxy never reconstructs them.
 
 ## Common errors
 

package/dist/index.d.ts

@@ -49,7 +49,7 @@ import { type Implementation, type Prompt, type Resource } from '@modelcontextpr
  * 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 = "31.2.97";
+export declare const PACKAGE_VERSION = "31.2.98";
 export declare const DEFAULT_URL = "https://mcp.battlegrid.trade/mcp";
 export interface EnvConfig {
     apiKeys: string[];

package/dist/index.js

@@ -52,7 +52,7 @@ import { ListToolsRequestSchema, CallToolRequestSchema, ListPromptsRequestSchema
  * 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 = '31.2.97';
+export const PACKAGE_VERSION = '31.2.98';
 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": "31.2.97",
+  "version": "31.2.98",
   "description": "BattleGrid MCP server — play crypto prediction games from AI agents",
   "type": "module",
   "main": "dist/index.js",