leehack · Oct 19, 2026 · Oct 19, 2026
diff --git a/README.md b/README.md
@@ -15,8 +15,8 @@ extensions, host UI behavior, an authorization-server implementation, JSON
 Schema external-reference resolution, and custom JSON Schema vocabularies.
 
 > [!IMPORTANT]
-> This release is `mcp_dart 2.4.3`. The separately versioned stable CLI remains
-> `mcp_dart_cli 0.2.1`, which requires `mcp_dart ^2.4.2`.
+> This release is `mcp_dart 2.4.3`. The separately versioned CLI is
+> `mcp_dart_cli 0.2.2`, which requires `mcp_dart ^2.4.3`.
 > Current source passes every scored requirement in the official alpha.11 MCP
 > `2025-11-25` and `2026-07-28` client and server sets, including all 25
 > required 2026 authorization scenarios, plus bidirectional published
@@ -41,7 +41,7 @@ The public maintenance contract is documented in the
 | Package | Minimum Dart SDK |
 | --- | --- |
 | `mcp_dart 2.4.3` | 3.4 |
-| `mcp_dart_cli 0.2.1` | 3.12 |
+| `mcp_dart_cli 0.2.2` | 3.12 |
 
 SDK-only generated projects retain the SDK's Dart 3.4 minimum. CLI projects
 use Dart 3.12 because the CLI and its toolchain target that release.
@@ -72,8 +72,8 @@ The snippets below use the current stable SDK line. Package versions
 remain separate from protocol profiles: `McpProtocol.stable` names the SDK's
 default compatibility policy.
 
-The SDK and CLI are versioned independently. The stable CLI's `^2.4.2`
-constraint accepts SDK versions from 2.4.2 up to, but not including, 3.0.0.
+The SDK and CLI are versioned independently. The stable CLI's `^2.4.3`
+constraint accepts SDK versions from 2.4.3 up to, but not including, 3.0.0.
 
 ### AI agent skills
 
@@ -165,13 +165,13 @@ Applications upgrading from the stable 2.2 line should also follow the
 Install the matching stable CLI:
 
 ```bash
-dart pub global activate mcp_dart_cli 0.2.1
+dart pub global activate mcp_dart_cli 0.2.2
 mcp_dart create my_server
 cd my_server
 mcp_dart inspect
 ```
 
-The `0.2.1` CLI creates a project with `mcp_dart: ^2.4.2`. The inspector
+The `0.2.2` CLI creates a project with `mcp_dart: ^2.4.3`. The inspector
 launches the generated stdio server itself. After leaving the interactive
 inspector, you can run a single tool directly:
 

diff --git a/ROADMAP.md b/ROADMAP.md
@@ -10,8 +10,9 @@ through the
 
 ## Current baseline
 
-- SDK 2.4.3 release preparation adds packaged agent skills and documentation
-  fixes. Published stable releases remain `mcp_dart 2.4.2` and
+- Published SDK 2.4.3 adds packaged agent skills and documentation fixes.
+  CLI 0.2.2 release preparation adds support for `build` 5.x while retaining
+  compatibility with 4.x. The published stable CLI remains
   `mcp_dart_cli 0.2.1` until publication is verified.
 - SDK 2.4.2 fixes unbounded incoming stdio and IO stream buffering. See
   [GHSA-92g6-8c2f-55w5](https://github.com/leehack/mcp_dart/security/advisories/GHSA-92g6-8c2f-55w5)

diff --git a/doc/quick-reference.md b/doc/quick-reference.md
@@ -15,7 +15,7 @@ dependencies:
 import 'package:mcp_dart/mcp_dart.dart';
 ```
 
-The 2.4.3 SDK requires Dart 3.4 or later. The stable 0.2.1 CLI requires
+The 2.4.3 SDK requires Dart 3.4 or later. The stable 0.2.2 CLI requires
 Dart 3.12 or later.
 
 ## Protocol profile

diff --git a/llms.txt b/llms.txt
@@ -4,7 +4,7 @@
 (MCP) servers, clients, and hosts.
 
 - SDK release: `2.4.3`
-- CLI stable: `0.2.1`
+- CLI stable: `0.2.2`
 - SDK minimum: Dart 3.4
 - CLI minimum: Dart 3.12
 - Repository: https://github.com/leehack/mcp_dart
@@ -212,7 +212,7 @@ https://github.com/leehack/mcp_dart/tree/main/example/authentication
 Install the coordinated stable CLI:
 
 ```bash
-dart pub global activate mcp_dart_cli 0.2.1
+dart pub global activate mcp_dart_cli 0.2.2
 ```
 
 Common commands:

diff --git a/packages/mcp_dart_cli/CHANGELOG.md b/packages/mcp_dart_cli/CHANGELOG.md
@@ -1,3 +1,9 @@
+## 0.2.2
+
+- Support `build` 5.x while retaining compatibility with 4.x. The Dart 3.12
+  minimum is unchanged.
+- Require `mcp_dart ^2.4.3` for the CLI and newly generated projects.
+
 ## 0.2.1
 
 - Require `mcp_dart ^2.4.2` for the CLI and newly generated projects.

diff --git a/packages/mcp_dart_cli/README.md b/packages/mcp_dart_cli/README.md
@@ -11,17 +11,17 @@ Install the stable CLI with a Dart SDK allowed by that release:
 dart pub global activate mcp_dart_cli
 ```
 
-The `0.2.1` release requires Dart 3.12.
+The `0.2.2` release requires Dart 3.12.
 
 Install the coordinated MCP `2026-07-28` CLI:
 
 ```bash
-dart pub global activate mcp_dart_cli 0.2.1
+dart pub global activate mcp_dart_cli 0.2.2
 ```
 
 For coordinated releases, automation publishes the SDK first and waits for it
 to resolve from pub.dev before publishing the CLI. CLI-only releases validate
-against the already published minimum SDK, currently `mcp_dart 2.4.2`.
+against the already published minimum SDK, currently `mcp_dart 2.4.3`.
 
 Without Dart, install the latest stable standalone binary:
 
@@ -46,7 +46,7 @@ cd my_server
 mcp_dart serve
 ```
 
-The 0.2.1 CLI writes `mcp_dart: ^2.4.2`, the SDK version tested with this
+The 0.2.2 CLI writes `mcp_dart: ^2.4.3`, the SDK version tested with this
 CLI. You can also supply a local
 Mason brick, Git URL, GitHub shorthand, or tree URL:
 

diff --git a/packages/mcp_dart_cli/example/example.md b/packages/mcp_dart_cli/example/example.md
@@ -11,7 +11,7 @@ First, install the CLI globally:
 dart pub global activate mcp_dart_cli
 
 # Coordinated MCP 2026-07-28 release
-dart pub global activate mcp_dart_cli 0.2.1
+dart pub global activate mcp_dart_cli 0.2.2
 ```
 
 ## Creating a Project

diff --git a/packages/mcp_dart_cli/lib/src/version.dart b/packages/mcp_dart_cli/lib/src/version.dart
@@ -1,7 +1,7 @@
-const packageVersion = '0.2.1';
+const packageVersion = '0.2.2';
 
 /// SDK constraint written by this CLI when it creates a project.
-const generatedSdkConstraint = '^2.4.2';
+const generatedSdkConstraint = '^2.4.3';
 
 /// Immutable template paired with this CLI release.
 const defaultTemplateUrl =

diff --git a/packages/mcp_dart_cli/pubspec.yaml b/packages/mcp_dart_cli/pubspec.yaml
@@ -1,6 +1,6 @@
 name: mcp_dart_cli
 description: Command-line tools for creating Dart MCP servers and inspecting, tracing, or testing Model Context Protocol servers and clients in any language.
-version: 0.2.1
+version: 0.2.2
 repository: https://github.com/leehack/mcp_dart
 homepage: https://github.com/leehack/mcp_dart/tree/main/packages/mcp_dart_cli
 issue_tracker: https://github.com/leehack/mcp_dart/issues
@@ -26,7 +26,7 @@ dependencies:
   build: ">=4.0.3 <6.0.0"
   mason: ^0.1.2
   mason_logger: ^0.3.3
-  mcp_dart: ^2.4.2
+  mcp_dart: ^2.4.3
   meta: ^1.17.0
   path: ^1.9.1
   pub_updater: ">=0.5.0 <0.7.0"

diff --git a/packages/templates/simple/__brick__/pubspec.yaml b/packages/templates/simple/__brick__/pubspec.yaml
@@ -9,7 +9,7 @@ environment:
 dependencies:
   args: ^2.6.0
   logging: ^1.3.0
-  mcp_dart: ^2.4.2
+  mcp_dart: ^2.4.3
 
 dev_dependencies:
   # Dart 3.4 resolves lints 4.0; Dart 3.8+ can use the latest lints 6 release.

diff --git a/tool/release/mcp_2026_07_28_release_metadata.json b/tool/release/mcp_2026_07_28_release_metadata.json
@@ -1,6 +1,6 @@
 {
   "sdkStableVersion": "2.4.3",
-  "cliStableVersion": "0.2.1",
+  "cliStableVersion": "0.2.2",
   "protocolVersion": "2026-07-28",
   "legacyInitializationProtocolVersion": "2025-11-25",
   "coreSpecification": {