Skip to content

v1.2.0 - Stateless MCP

Choose a tag to compare

@i1rr i1rr released this 20 Nov 03:09

MCP 1.2.0 requires stateless HTTP protocol 2026-07-28 in the Unity Editor and development players.

Breaking client requirements

The 2025-era initialization/session protocols are removed, including protocol session storage and reload persistence, session capacity/reclaim settings, HTTP DELETE termination, and JSON-RPC wire batches. Older requests and session headers are rejected before tool dispatch with upgrade guidance. The explicit batch_execute tool remains available.

Before connecting with Codex 0.169.0-alpha.11.1, enable modern mode in private project configuration and reconnect:

[features]
mcp_2026_07_28 = true

This Codex build marks the flag under development. Other clients must support and select 2026-07-28; client product names alone do not establish compatibility. Claude Code was not exercised for this release.

Protocol callbacks now receive immutable request context. String-session callbacks and DeferredResult.SessionId are removed. Explicit test, import, UI and recording handles retain their application lifetimes. Deferred streaming, cancellation and interrupted-operation recovery remain request-scoped.

The Dashboard shows bounded request activity without legacy client sessions. HTTP and UDP discovery advertise only the stateless version. See the client migration instructions.

Local validation

  • Exact signed archive: 494 Editor tests and 49 graphical runtime tests passed, zero failures/skips, Windows / Unity 6000.6.9f1 / D3D11.
  • Clean package-only installation: version 1.2.0, Unity signature Valid / Custom Logic, 21 focused and 153 full tools. Native Codex modern discovery and old-protocol/session rejection verified.
  • Implementation checks also passed: 8 native socket tests, SDK create/read/delete and deferred frame waiting, fresh reconnect, reload/subscription interruption and disconnect cleanup, and IL2CPP development/release builds with live development-player protocol checks. No cloud validation was dispatched.

Distribution

  • Signed Unity registry: https://i1rr.github.io/unity-MCP, scope i1rr-unity-mcp.
  • Immutable Git dependency: https://github.com/i1rr/unity-MCP.git#v1.2.0.
  • Commit: 284f6ed1185f3733594f86894607a81a956afcbe.
  • Signed archive SHA-256: 792f3bc018f541c1caf7a4fcc584ac8da2269ea1e4b1ea15c3ecb8394aacdbd1.

Existing consumer projects are not upgraded by this publication.