mcp_toolkit

6.0.0 (2026-10-02)

⚠ BREAKING CHANGES

• mcp_toolkit: bootstrapFlutter drops additionalEntries and initializeFlutterToolkitEntries — compose via addEntries (or initialize + addEntries + runApp for fully custom sets) before bootstrap. WebMCP auto-registration is removed from core; register WebMcpProjection(policy:).entriesChanged via addEntryListener. Core deps are intentcall_core + intentcall_schema only — platform tiers are opt-in.

Features

• discovery: name discovered targets and select one by its label (5eea4bb)
• discovery: name discovered targets and select one by its label. Made by @dpsy in #137 (ca05479)
• dogfood shared registry for coding agents and OS agents (a5e586b)
• dtd handshake (cb4a6af)
• flutter mcp harness (8e38699)
• flutter MCP harness — ToolkitDriver, IntentDriverRouter, showcase consolidation (4fc4c27)
• flutter MCP harness — ToolkitDriver, IntentDriverRouter, showcase consolidation (#146) (4fc4c27)
• focus_widget: give a widget keyboard focus by ref and prove it (7028e44)
• harness: add FlutterRunTarget and Dart showcase launcher (dc4c0ce)
• harness: add IntentDriverRouter for hint-routed driver invocation (cb0059d)
• harness: ChromeAppTarget anti-backgrounding flags; complete the automation-catalog action surface (55127f9)
• harness: pin intentcall_core/schema to ^1.0.0 — published packages need real floors (7eabf7c)
• harness: the invoke tier — registry-native surface actions (ADR-0017) (1407c9d)
• harness: the invoke tier — registry-native surface actions (ADR-0017) (eb06954)
• harness: ToolkitDriver, IntentDriverRouter, and universal contracts (4efe561)
• interaction: focus a widget by ref and prove where focus landed. Made by @dipsy #141 (7243a03)
• mcp_toolkit: let an app name its running instance (efb595d)
• mcp_toolkit: projections SPI — composition-first platform surfaces, decoupled intentcall platform/cli (5ec7134)
• mcp_toolkit: shared extension names and navigator auto-resolution (ef270a1)
• semantic_snapshot: narrow a snapshot by identifier prefix, subtree and fields (de92c81)
• semantic_snapshot: narrow a snapshot by identifier prefix, subtree and fields. Made by dipsy #143 (6dc511d)
• spec-driven external dev sessions (spec v2) — dependency inversion (06dbcb9)
• wait_for: say why the predicate never matched (b8b74d4)

Bug Fixes

• await websocket upgrade and guard sink close in VM connect (40b4b11)
• capture: count the errors a snapshot carries, not the cap requested (f610327)
• capture: say where the captured images went (5ddb091)
• ci: eval gates survive an invisible flutter_harness sibling (211217a)
• ci: give drift and eval gates their delegation targets and siblings (e8bcb5d)
• ci: move sibling overrides to gitignored pubspec_overrides.yaml (d31f984)
• ci: point codegen drift check at showcase/flutter_test_app (8b645fb)
• ci: pub get in CLI checkouts before delegation; harness sibling for the integration job (2f990e3)
• ci: run gates on Flutter 3.47.5 — 3.44.2's flutter_test pins meta 1.18.0 (83ec41b)
• discovery: auto-attach when one app answers on two endpoints (23efbce)
• discovery: cap how many ports a --scan-ports value expands to (9c27569)
• discovery: count a --scan-ports range by the ports it adds (327cd37)
• discovery: probe configured and common ports on every scan (0228b7c)
• discovery: probe configured and common ports on every scan. Made by #136 (59c1f8d)
• discovery: re-read processes before merging endpoints into one target (55a10a8)
• do not block VM service connection on DTD handshake failure (d3b444f)
• enter_text: type the caller's text, spaces and all (ef26271)
• evaluate: name the result cap in UTF-16 code units (06bfada)
• evaluate: read a truncated String result back in full and say so (fd7df06)
• evaluate: read a truncated String result back in full and say so. Made by @dipsy #142 (0e43fa9)
• harness: fail pending LogTap waiters on close; await verified child death (fd6310a)
• interaction: address review edge cases (f9efe16)
• interaction: address second review (1970b93)
• interaction: make tool results report their observed effect. Made by @dipsy #139 (c9b94c6)
• interaction: open a drag with small moves so the press point survives (43eaafc)
• interaction: open a drag with small moves so the press point survives (#145) (b3e278c)
• interaction: read a pop off the stack, and answer the rest of the review (d4bdc7c)
• interaction: report what a gesture did, and say why it refused (88747e3)
• press_key: name both dispatch phases in the unhandled hint (43d720e)
• press_key: name the failure code the tool actually returns (eb44e62)
• press_key: send modifiers as real keys and leave none held (c0e048c)
• press_key: send modifiers as real keys and leave none held. Made by dipsy (8a3e7a5)
• reveal_search: explain a miss per matchBy and name the identifiers nearby (61125e4)
• scroll: describe what scroll does, and drop a branch nothing reaches (ae1c04f)
• scroll: link the Flutter types the scroll guard names (848651c)
• scroll: move the list the ref belongs to, by the distance asked (127609c)
• scroll: scroll the list, not the card that carries a pan gesture (df8f2de)
• semantic_snapshot: carry the filters over the MCP path and encode fields as JSON (7b2aa3d)
• semantic_snapshot: fail the command when the snapshot was refused (4ef98e9)
• semantic_snapshot: read the fields list off the wire map (10cee4e)
• server: intentcall CLI discovery walks up from package dirs; absolute project roots (f7175d6)
• wait_for: honor stable wall time and reject impossible budgets (d1103b1)

Documentation

• ADR 0014 external dev sessions; configuration reference; changelog entries (cba40a9)
• control: tell a node's role from what it accepts (6289039)
• dev-session delegation roadmap — root cause + do/don't for oka late-attach reloads (210f1e6)
• focus_widget: count the new tool in the audit and name its refusals (eeff3fe)
• harness: document flutter_mcp_harness and E2E scenarios guide (b4818c0)
• index ADR 0014 in decisions index (a42354b)
• integration smoke findings — stale-daemon discovery conflict, zero-delta reload semantics (1f39a32)
• mcp_toolkit: fold Unreleased into 5.2.0 heading (f5905a2)
• skills: name an instance with setAppIdentity, not a tool of that name (1b6bc03)
• skills: sync proof-of-effect contracts (f421bc5)

5.1.0 (2026-08-23)

Features

• logo (bfeae14)

Bug Fixes

• contracts: address second review round on mcp-registry checks (333d788)
• contracts: harden mcp-registry checks per review (6b0e32b)

Documentation

• ADR 0013 — MCP Registry publish hardening + fmt.check.mcp-registry gate (299e4f4)
• ADR 0013 — MCP Registry publish hardening + fmt.check.mcp-registry gate (0e14e4d)

5.0.4 (2026-08-23)

Bug Fixes

• mcp-registry: drop registryBaseUrl from OCI package entry (fdb87d3)
• mcp-registry: drop registryBaseUrl from OCI package entry (2e6365a)

5.0.3 (2026-08-23)

Bug Fixes

• mcp-registry: resolve deps inside pinned image, drop lockfile enforcement (381f13b)
• mcp-registry: resolve deps inside pinned image, drop lockfile enforcement (3f7d6a1)

5.0.2 (2026-08-23)

Bug Fixes

• contracts: check flutter availability in skill assets drift script (b891998)
• contracts: match corrected Dockerfile.registry path in check_mcp_registry (9d1cde0)
• contracts: match corrected Dockerfile.registry path in check_mcp_registry (dfcd371)
• mcp-registry: build image from monorepo context with Flutter SDK (6c952a7)

5.0.1 (2026-08-22)

Bug Fixes

• ci: use explicit path for Dockerfile.registry in build-push action (b3c8310)
• ci: use explicit path for Dockerfile.registry in build-push action (7cb7b67)

5.0.0 (2026-08-22)

⚠ BREAKING CHANGES

• agentkit: remove MCPCallEntry from mcp_toolkit

Features

• add steward hosted dependency gate (3b91408)
• agentkit: complete in-repo integration gate (Bar D follow-up) (58df0fe)
• agentkit: complete Phase 2 transport-free tool handlers (76e0209)
• agentkit: complete Phase 3 adapters and transport-free resources (111c0bf)
• agentkit: consolidate MCP attach via AgentRuntime (Phase 5-B) (8eaeb1b)
• agentkit: enhance input schema validation and dynamic registry functionality (8a6bcee)
• agentkit: enhance Phase 7 extract and integration tooling (bdfe2a0)
• agentkit: migrate agent-entries CLI and docs (0910443)
• agentkit: native platform sync emitters (0633da3)
• agentkit: Phase 1 core, MCP adapter, and Phase 3 stubs (007fa5e)
• agentkit: Phase 5-C authoring and optional @agenttool codegen (e340db8)
• agentkit: registry-backed app errors resource template (7677239)
• agentkit: remove MCPCallEntry from mcp_toolkit (9823430)
• agentkit: server fmt tool via @agenttool codegen (d835a02)
• agentkit: web platform sync (WebMCP JS + manifest + Dart path) (f3614b0)
• capability_core: migrate debug_dump_* tools (gated on dumps_supported) (397b1eb)
• capability_core: migrate enter_text, scroll, long_press, swipe, drag, hover, press_key to CoreCapability (0613295)
• capability_core: migrate fill_form with pattern-A handler (9e71dd0)
• capability_core: migrate get_screenshots, capture_ui_snapshot with onSuccess multi-content translation (0042aeb)
• capability_core: migrate hot_restart_flutter, evaluate_dart_expression, hot_reload_and_capture (1cff622)
• capability_core: migrate navigation, log, semantic, inspection tools (T4-C) (0ebe466)
• capability_core: migrate tap_widget as the pattern reference (9c6ac55)
• capability_core: migrate wait_for with pattern-A handler (97ae074)
• capability_core: scaffold package with empty CoreCapability (eed7099)
• capability-core: T4-D-3 — migrate 5 Flutter inspector tools (79b0268)
• cli/codegen_snippets: bundle Flutter main.dart init snippet (38e6b51)
• cli/init_mode_detector: pure mode-decision logic (d4293b4)
• cli/init_mode: InitMode enum + parse (977b78e)
• cli/init_target: InitTarget enum (2f26f43)
• cli/init_writers: write skills + manifests per target (191ac83)
• cli/mode_prelude: substitute prelude marker by mode (0157c01)
• cli: codegen-init command emits Flutter main.dart snippet (99e21ac)
• cli: expose 'init' subcommand (b46a394)
• cli: runInit dispatches to per-target writers (b349ad9)
• contracts: restore Apple runner compile gate (b48c92a)
• contracts: tool-surface snapshot pinned to expected_tool_surface.txt (be97780)
• core_capability: rename MCP tool prefix core_ → fmt_ (5c18563)
• enhance visual capture capabilities for macOS and web (8d5b199)
• gestures: platform-appropriate pointer kind for drag (d80ff25)
• gestures: platform-appropriate pointer kind for drag. Made by hi @dipsy in #117 (f062b3e)
• initial native capture (3ff2d73)
• kernel: define Capability + CapabilityContext + HostService contracts (494656c)
• kernel: expose FakeCommandRunner via testing library (I2) (2995f2a)
• kernel: id + prefix validators with full test coverage (9dfeefa)
• kernel: scaffold mcp_capability_kernel package (69ae09c)
• live_edit_models: scaffold pure-Dart shared models package (020e848)
• mcp_capability_core: rewrite tap_widget handler to use CommandRunner (f0c2ccf)
• mcp_capability_kernel: add CommandRunner HostService interface (c8cd135)
• mcp_server_dart: wire DefaultCommandRunner into McpHost; migrate type files to re-export mcp_shared_core (e2d6f48)
• mcp_shared_core: scaffold pure-Dart package with CoreCommand hierarchy and value types (24bb65c)
• mcp_toolkit: expose isSelected flag in semantic snapshot nodes (64a35af)
• mcp_toolkit: pump frames manually while the host window is backgrounded (729519e)
• mcp_toolkit: pump frames manually while the host window is backgrounded. Contributed by https://github.com/dipsy (thank you!) (8264cde)
• mcp: harden boundary validation across agentkit and gateways (2e00439)
• p1: handle_dialog (dismiss) tool (5832b93)
• p1: MCPToolkitBinding.setNavigatorKey opt-in API (822f376)
• p1: navigate tool (push/pop/popUntil) (4f63d74)
• p1: press_key tool + ControlFlowService (9b5009b)
• p1: scaffold press_key, handle_dialog, navigate commands (fe13ceb)
• p1: server executors + handlers + registrations (0fe69db)
• p2: hover tool via PointerHoverEvent (e798554)
• p2: scaffold fill_form and hover commands (a031e2e)
• p2: server executors + handlers + registrations (daf27e6)
• plugin: add Codex plugin manifest (d389604)
• plugin: add Cursor plugin manifest (f1f9322)
• plugin: add MCP server config for Cursor + Codex (1c4b8b9)
• plugin: revise setup skill for post-v3.0.0 surface (620a58e)
• plugin: scaffold 5 skill files with frontmatter (95bf869)
• plugin: write control skill body (bfec8d9)
• plugin: write debug skill body (b7be59e)
• plugin: write guide skill body (49bee46)
• plugin: write inspect skill body (2e2b132)
• plugin: write setup skill body (9cd8a85)
• promo: consolidate promo branch work (eca2764)
• promote hosted dependency steward gate (82868e8)
• server: flip --use-capability-kernel default to on (the cut) (849c812)
• server: McpHost capability registrar with prefix + collision enforcement (2098282)
• server: wire --use-capability-kernel flag with McpHost dispatch (default off) (44b476b)
• server: wire CoreCapability into server binary via capability kernel flag (0f577c1)
• server: wire kernel dispatch bridge + gate legacy tools on !flag (ae9139a)
• shared_core: add CoreResult.toErrorEnvelopeJson + tests (I1) (9d5b489)
• skill_assets: bundle skill bodies into mcp_server_dart (e41bc77)
• wait_for: expose via interaction_toolkit MCP entry (2c541da)
• wait_for: noText predicate (06e48ce)
• wait_for: register command + error codes (no behavior) (3383168)
• wait_for: server executor + handler + tool registration (f44c03a)
• wait_for: stable predicate (98f85d6)
• wait_for: text predicate + peekSemanticSnapshot (e0350ce)
• wait_for: WaitPredicateService time predicate (5a6b222)
• wait: add a node predicate to wait_for (f20b712)
• wait: add a node predicate to wait_for. Made by @dipsy #121 (cb749d7)
• web CDP capture and cross-platform platform view showcase (3771315)

Bug Fixes

• add FMT_MODE_PRELUDE to boundary-audit skill and sync assets (81f788c)
• add missing closing parenthesis in dynamic tools registration (72f4c90)
• agentkit: align fmt tool docs and tests after Phase 6g (059e501)
• agentkit: drop path dep on flutter_mcp_toolkit_core for publish (32d6307)
• agentkit: restore dynamic registry VM guard imports (91762e5)
• agentkit: restore xsoulspace_lints dependency in pubspec.yaml files (4f398fc)
• agents (2124310)
• agetn (08e3c29)
• align release checks with Flutter SDK pins (175ca58)
• capability_core: align scroll/swipe schemas with legacy (number distance, no direction enum) (f9e264d)
• changelog (fbdcf74)
• cli: clean StateError handling for init auto-detect; rename serverInfo to flutter-mcp-toolkit-server (34f5a8c)
• cli: validate-runtime flutter_layer fallback with platform views (d69eeaf)
• codegen-init: add correct pubspec dependency (dbbb32d)
• codegen-init: add correct pubspec dependency (0fb5230)
• codegen-init: use published mcp_toolkit package name (9d46ba3)
• codegen-init: use published mcp_toolkit package name (#1) (a53a908)
• contracts: point error_code_playbook checker at mcp_shared_core (c4df607)
• contracts: repair error_code_playbook check path + backfill playbook (a0e2d4b)
• dart (2e5568d)
• deps (5ac04bc)
• docs (468a76e)
• docs (890b2b9)
• docs: release 3.0.4 — docs.page branding and SEO (4fc98cc)
• errors summarization (9252699)
• format (1da5f5d)
• formatting (35a7e94)
• gestures: keep synthetic pointers off the platform mouse device (4fe9886)
• gestures: keep synthetic pointers off the platform mouse device. Made by @dipsy #120 (9fc64e9)
• gestures: release the synthetic device after a scroll too (62a96e9)
• https://github.com/drown0315 broken link (48fe450)
• json (c67e8fe)
• kernel: code review fixes (final params, config tests, barrel imports, immutable) (981a2ff)
• lints (288ce18)
• lints (8e2ea60)
• live edit (5facbd7)
• mcp_toolkit: don't double-dispatch tap on desktop when semantic action succeeds (ab6fc27)
• mcp_toolkit: preserve mid-frame microtask phase in suspended pump (3d6ee73)
• mcp_toolkit: tap double-dispatch on desktop + expose isSelected in semantic snapshot (af2da1a)
• mcp_toolkit: VM isolateId causes tool validation error (37fcaa8)
• mcp-registry: address PR 123 review comments (7866c28)
• mdc (7fa2976)
• p2: fill_form actually stops on first toolkit-side failure (4173a74)
• perf changelog (7eef42e)
• plugin (85e8f78)
• promo (54d981c)
• pub.dev (5a17df2)
• pubspec (bb8f573)
• readme (b95e8b3)
• readme (0aa1c00)
• release: bump Dockerfile SDK pin to dart:3.11.0-sdk (887f88f)
• release: exercise release token for 4.0.0-dev.3 (142e2b4)
• release: include package changelogs in release sync (cd7dbfd)
• release: ship macOS binaries for Apple Silicon only (b0d3422)
• release: sync generated release touchpoints (a552b30)
• release: sync package changelogs for pub publish (6dfca08)
• server: address PR #115 review comments (d2cea26)
• server: address PR 115 review comments (7f140dc)
• server: clean up Windows machine discovery process trees (11d5d02)
• server: clean up Windows machine discovery process trees. Made by @wenyue in #115 (b510de0)
• server: complete host_flag_smoke_test deletion + tighten catch clauses (27a81a4)
• server: handle already-exited root in Windows tree terminator (aa076e7)
• server: harden Windows machine discovery cleanup (4810a33)
• server: return capture_ui_snapshot images as ImageContent (043dc7a)
• server: return capture_ui_snapshot images as ImageContent. Made by https://github.com/dipsy (3667891)
• server: T2 review fixes (seal tests, partial-state rollback, dispose isolation, doc updates) (b45a706)
• server: update tools/list assertions for prefixed names (post-cut) (4103744)
• shared cor (baaf163)
• sync skill_assets.g.dart after 3.0.4 plugin bump (a618201)
• tool: detect repo root from a linked worktree in build_skill_assets (87c5cc8)
• tool: detect repo root from a linked worktree in build_skill_assets (3ea5433)
• toolkit: resolveCenter/resolveBounds return logical (not physical) coords (340e729)
• use deterministic dogfood tracker merge (3e07d3a)

Documentation

• add agentkit architecture design spec (371aa16)
• add agentkit Phase 1 implementation plan (f56c83a)
• Add Ask DeepWiki badge to README (6975f88)
• add chrstphe as a contributor for doc, and platform (9b6fd6b)
• add CONTRIBUTING maintainer section for binary releases (2c93235)
• add dipsy as a contributor for code, and maintenance (fea5eab)
• add dipsy as a contributor for code, maintenance, and bug (99d669e)
• add drown0315 as a contributor for code, maintenance, and bug (192cba5)
• add druyang as a contributor for code, maintenance, and bug (3da354e)
• add tekboxs as a contributor for code, and maintenance (0cab8cd)
• add v2 → v3 migration guide (d514710)
• add v3.0.0 spec + 4 implementation plans (c7c94aa)
• add wenyue as a contributor for code, and maintenance (41fc0e6)
• agentkit: add ecsly client DX patterns to spec and plan (f2a56da)
• agentkit: add phase6 pre-extract row to tracker (5578777)
• agentkit: add self-closing implementer/closer loop (0ff6f44)
• agentkit: align tracker and rollout after phase 4 (c4d61ba)
• agentkit: archive phase plans and refresh rollout for phase 6. (a269a26)
• agentkit: drop engineering-loop from self-closing loop (3ba7916)
• agentkit: Phase 6 Bar D spec and implementation plan. (eb30405)
• agentkit: Phase 6 platform scope — Web C, skip HarmonyOS. (a86c513)
• agentkit: Phase 6g skills and skill_assets for AgentCallEntry (893ffee)
• agentkit: Phase 6h complete_in_repo gate and closure (910d182)
• agentkit: split descriptor vs RegisteredAgentIntent (2aafb7e)
• ai_agents: redirect execution_playbook to plugin skills (a6be2dc)
• ai_agents: rewrite overview around the plugin (28c6c9d)
• append steward cascading governance instructions (880bfa4)
• architecture cleanup, intentcall, flutter mcp toolkit purpose (b1609bf)
• changelog: document v3.0.0 capability-prefix breaking change (dee690e)
• code: update lingering core_ tool-name references in code comments (fe5cece)
• contributing: add section on editing skills (26e2e2a)
• core: document DragPointerKind members and parser contract (a834cdb)
• core: remove built_in_tools + error_code_playbook (migrated to skills) (4c96a83)
• mcp_server_dart: update CHANGELOG + README for v3.0.0 names (f3842d1)
• mcp_toolkit: update README for AgentCallEntry API (5fda437)
• p1: mark P1 shipped in roadmap (3ed54d1)
• p2: close audit gap matrix + persist DPR bug as todo (94b98ca)
• p2: mark P2 shipped, note select_option deferral in audit (465d172)
• p3: defer network introspection — move spec to todo/ (7a49850)
• p3: network introspection design (48248b3)
• p4: consolidation research — defer set A/C, drop set B from candidates (2cc95e0)
• persist steward proof summaries (339b20f)
• plan: scope down v3.0.0 — defer live_edit to post-release (afc06ba)
• plugin: add plugin source README (3e2ef37)
• plugin: update flutter-mcp plugin surfaces for core_* tool names (a6251f7)
• prepare runtime text input steward proof (87c493c)
• readme: rewrite hero around the four-step install (14c8fb2)
• record bounded steward h5 adoption (bf21f6f)
• record steward adoption evidence (fd0c059)
• refresh direct steward proof summaries (638b970)
• refresh steward h5 proof summary (d74a524)
• remove deleted-page entries from navigation (1703a92)
• remove manual install/client-setup docs (superseded by install.sh + init) (f4bc18d)
• remove per-agent setup docs (superseded by 'flutter-mcp-toolkit init <agent>') (200834b)
• server: document --use-capability-kernel requirement on McpHost services (I3) (ae71960)
• start_here: refresh migration_v2_to_v3 for v3.0.0 names (bb8c74f)
• start_here: refresh names + reference init command (5b48c5c)
• start_here: replace step 1 with four-step install (ca73616)
• update .all-contributorsrc (35101e0)
• update .all-contributorsrc (1ccbbce)
• update .all-contributorsrc (57e2178)
• update .all-contributorsrc (1f670f2)
• update .all-contributorsrc (a24a9ff)
• update .all-contributorsrc (33c1495)
• update .all-contributorsrc (2bfae74)
• update CLAUDE.md + ARCHITECTURE.md for v3.0.0 names (465d7c9)
• update GitNexus project details and enhance harness engineering lifecycle documentation (9245d8f)
• update README.md (3d4399f)
• update README.md (c055f5a)
• update README.md (a15e2bc)
• update README.md (d078171)
• update README.md (54bbf4d)
• update README.md (52fd2d5)
• update README.md (faf051e)
• update repo docs for v3.0.0 capability-kernel cut (d08ce16)
• update star history chart to README (46e5d89)
• update video walkthroughs with improved titles and punctuation (7c47074)
• wait_for: mark P0 shipped in roadmap (db5fa06)

4.0.0-dev.8 (2026-07-31)

Features

• mcp_toolkit: pump frames manually while the host window is backgrounded (729519e)
• mcp_toolkit: pump frames manually while the host window is backgrounded. Contributed by https://github.com/dipsy (thank you!) (8264cde)

Bug Fixes

• mcp_toolkit: preserve mid-frame microtask phase in suspended pump (3d6ee73)
• server: return capture_ui_snapshot images as ImageContent (043dc7a)
• server: return capture_ui_snapshot images as ImageContent. Made by https://github.com/dipsy (3667891)
• tool: detect repo root from a linked worktree in build_skill_assets (87c5cc8)
• tool: detect repo root from a linked worktree in build_skill_assets (3ea5433)

Documentation

• Add Ask DeepWiki badge to README (6975f88)
• add chrstphe as a contributor for doc, and platform (9b6fd6b)
• add dipsy as a contributor for code, maintenance, and bug (99d669e)
• add wenyue as a contributor for code, and maintenance (41fc0e6)
• update .all-contributorsrc (35101e0)
• update .all-contributorsrc (1ccbbce)
• update .all-contributorsrc (57e2178)
• update README.md (3d4399f)
• update README.md (c055f5a)
• update README.md (a15e2bc)

4.0.0-dev.7 (2026-07-18)

Features

• mcp_toolkit: expose isSelected flag in semantic snapshot nodes (64a35af)

Bug Fixes

• mcp_toolkit: don't double-dispatch tap on desktop when semantic action succeeds (ab6fc27)
• mcp_toolkit: tap double-dispatch on desktop + expose isSelected in semantic snapshot (af2da1a)

Documentation

• add dipsy as a contributor for code, and maintenance (fea5eab)
• update .all-contributorsrc (1f670f2)
• update README.md (d078171)
• update star history chart to README (46e5d89)

4.0.0-dev.6 (2026-07-05)

Bug Fixes

• add FMT_MODE_PRELUDE to boundary-audit skill and sync assets (81f788c)
• add missing closing parenthesis in dynamic tools registration (72f4c90)

Documentation

• architecture cleanup, intentcall, flutter mcp toolkit purpose (b1609bf)

4.0.0-dev.5 (2026-06-21)

Bug Fixes

• align release checks with Flutter SDK pins (175ca58)

Bug Fixes

• release: sync package changelogs for pub publish (6dfca08)

Changed

• Raised package Dart SDK floor to >=3.12.0 <4.0.0.
• Added Flutter SDK floor >=3.44.0 <4.0.0 for Flutter package support.

BREAKING CHANGES

• Removed MCPCallEntry from the public API. Use AgentCallEntry (re-exported by mcp_toolkit from hosted intentcall_core) for all dynamic tool/resource registration.
• Removed mcp_call_entry_bridge.dart and MCPCallEntryAgentBridge.toAgentCallEntry().
• MCPToolkitBinding.addEntries, bootstrapFlutter additionalEntries, addMcpTool, and AgentClientInstall.once now take AgentCallEntry / Set<AgentCallEntry>.
• Built-in toolkits use mcpToolkitTool / mcpToolkitResource helpers when you still author with MCPToolDefinition / MCPCallHandler + MCPCallResult.

Migration

See intentcall Phase 6 migration and run:

flutter-mcp-toolkit migrate agent-entries --check lib/

Major release. Three pillars:

1. Capability kernel — the server's tool surface is now composed from Capability instances registered into an McpHost. The kernel applies the capability prefix and bridges into dart_mcp's ToolsSupport.
2. Playwright-style interaction layer — prefixed tools that let an AI agent drive a running Flutter app the way a user does, with semantic refs and a snapshot/staleness contract.
3. Plugin-first install — a Claude Code marketplace plugin bundles skills, agent, and MCP server into one install.sh step; CLI gains init <agent> for Cursor / Codex / etc.

The locked v3.0.0 surface is checked in at tool/contracts/expected_tool_surface.txt and pinned by mcp_server_dart/test/tool_surface_snapshot_test.dart.

Plugin layout

• Renamed bundled Cursor/Codex skill custom-toolkit-tools → flutter-mcp-toolkit-custom-tools (directory plugin/skills/…, frontmatter name, and SkillAssets id). Update any prompts or automation that referenced the old skill id; run make sync-skills after pulling.
• Renamed Claude subagent file plugin/agents/flutter-inspector.md → plugin/agents/flutter-mcp-toolkit-runtime.md with name: flutter-mcp-toolkit-runtime so the agent aligns with flutter-mcp-toolkit-* surfaces and no longer shares a slug with the legacy MCP mcpServers key flutter-inspector.
• Consolidated: Claude Code marketplace, Cursor/Codex manifests, MCP config, installer, version pin, flutter-mcp + flutter-mcp-cli-runtime-validation skills, and the flutter-mcp-toolkit-runtime agent now live under plugin/ only. .claude-plugin/marketplace.json source is ./plugin. Removed the duplicate flutter_mcp_plugin/ tree.
• plugin/ (Claude / Cursor / Codex marketplace): canonical plugin/mcp.json uses MCP key flutter-mcp-toolkit; tool/contracts/check_plugin_surfaces.sh accepts flutter-mcp-toolkit or legacy flutter-inspector and requires flutter-mcp-toolkit-server in command.

Docs

• Install/migration docs (llm_install.md, mcp_server_dart/README.md, docs/start_here/migration_v2_to_v3.mdx), plugin spec §5–§6.1, and plugin/skills/flutter-mcp/SKILL.md: clarify flutter-inspector as legacy mcpServers id vs Claude subagent flutter-mcp-toolkit-runtime; regenerated skill_assets.g.dart.
• Plugin skills (plugin/skills/…): validate-runtime now documents --vm-service-uri, automatic flutter_layer retry after failed desktop_window capture, and captureFallbackUsed; port-conflict example uses current flutter run flags; covers binaries, mcpServers keys, validate-runtime, and links to canonical configs.
• mcp_server_dart/README.md: Cline / Cursor / Claude examples use flutter-mcp-toolkit + updated Cursor deeplink; removed stale --no-resources / flutter_inspector_mcp guidance.
• mcp_toolkit package README: golden-path note for validate-runtime targeting / fallback.

BREAKING

MCP tool names are now prefixed by capability id

All MCP tools surface under the fmt_ capability prefix (Flutter MCP Toolkit). Calls to legacy unprefixed names return tool_not_found. The CLI catalog vocabulary stays bare for intrinsic tools — flutter-mcp-toolkit exec --name tap_widget still works; MCP publishes fmt_tap_widget. Dynamic-registry commands use their full fmt_* spelling in both CLI and MCP. See docs/start_here/migration_v2_to_v3.mdx for the smallest-possible-diff guide.

v2 (legacy)	v3 (MCP tools/call name)
tap_widget	fmt_tap_widget
enter_text	fmt_enter_text
reveal_search	fmt_reveal_search
scroll	fmt_scroll
long_press	fmt_long_press
swipe	fmt_swipe
drag	fmt_drag
hover	fmt_hover
press_key	fmt_press_key
semantic_snapshot	fmt_semantic_snapshot
wait_for	fmt_wait_for
fill_form	fmt_fill_form
navigate	fmt_navigate
handle_dialog	fmt_handle_dialog
connect_debug_app	fmt_connect_debug_app
discover_debug_apps	fmt_discover_debug_apps
get_vm	fmt_get_vm
get_extension_rpcs	fmt_get_extension_rpcs
hot_reload_flutter	fmt_hot_reload_flutter
hot_restart_flutter	fmt_hot_restart_flutter
hot_reload_and_capture	fmt_hot_reload_and_capture
evaluate_dart_expression	fmt_evaluate_dart_expression
get_recent_logs	fmt_get_recent_logs
get_view_details	fmt_get_view_details
get_app_errors	fmt_get_app_errors
get_screenshots	fmt_get_screenshots
capture_ui_snapshot	fmt_capture_ui_snapshot
inspect_widget_at_point	fmt_inspect_widget_at_point
debug_dump_layer_tree (--dumps)	fmt_debug_dump_layer_tree
debug_dump_semantics_tree (--dumps)	fmt_debug_dump_semantics_tree
debug_dump_render_tree (--dumps)	fmt_debug_dump_render_tree
debug_dump_focus_tree (--dumps)	fmt_debug_dump_focus_tree
listClientToolsAndResources	fmt_list_client_tools_and_resources
runClientTool	fmt_client_tool
runClientResource	fmt_client_resource

The dynamic-registry host trio (fmt_list_client_tools_and_resources, fmt_client_tool, fmt_client_resource) uses the same fmt_* names on MCP and in exec --name. Resource URIs (visual://localhost/...) are unchanged.

Server and CLI binaries renamed

• flutter_inspector_mcp → flutter-mcp-toolkit-server (the MCP server).
• flutter_mcp_cli → flutter-mcp-toolkit (the CLI).
• The MCP serverInfo.name advertised on initialize is now flutter-mcp-toolkit-server.

Update any mcpServers config entry, shell alias, Docker invocation, or CI script that referenced the old names. The new root install.sh updates PATH for you on first run.

Strict wire surface

• All MCP tool/resource errors emit a single envelope: code, message, details, descriptor, recovery. Code paths that parsed top-level category / retryable / exitCode must read error.descriptor instead.
• Typed parsing hard cut: no string-encoded object/list/bool coercions.
• Tool argument schemas default to additionalProperties: false unless explicitly opened.
• connection.targetId now requires full VM websocket URIs (ws://.../ws). Legacy host:port ids are rejected with migration guidance to URI ids or connection.uri.
• Top-level host / port / uri aliases on tool arguments are rejected; pass them inside the nested connection object.

Added

Capability kernel

• packages/server_capability_kernel/ — pure-Dart contracts: Capability, CapabilityContext, HostService, CommandRunner, prefix validators, and a testing library shipping FakeCommandRunner / FakeCapabilityContext.
• packages/server_capability_core/ — the bundled fmt capability. Registers all 27 Playwright-style tools plus 4 --dumps tools when dumps_supported=true. No Flutter dependency on the server side.
• packages/core/ — pure-Dart command hierarchy (CoreCommand, CoreResult.toErrorEnvelopeJson) and value types shared between server, CLI, and capability core.
• McpHost registry on the server applies the <capabilityId>_ prefix with collision enforcement. DartMcpDispatchBridge publishes prefixed tools into dart_mcp's ToolsSupport.

Playwright-style interaction layer

• New interaction tools that let an AI agent drive a running Flutter app the way a user does:
  • semantic_snapshot returns a compact JSON accessibility tree of interactive widgets with stable ref strings (s_0, s_1, ...) and a monotonically incrementing snapshot_id.
  • tap_widget, long_press, enter_text, scroll, swipe, and drag target widgets by ref. Each tool uses a two-tier dispatch: semantic actions first (SemanticsOwner.performAction), then synthetic pointer events via GestureBinding.instance.handlePointerEvent when no semantic action is available. Responses include a via field (semantic_action | pointer_events | editable_state | pointer_scroll_event).
  • All interaction tools accept an optional snapshotId; if it doesn't match the current snapshot the call returns a stale_snapshot envelope with providedSnapshotId and currentSnapshotId.
  • scroll direction follows the Playwright convention (direction = which content to reveal).
  • enter_text falls back to EditableTextState.userUpdateTextEditingValue so TextInputFormatters and onChanged fire correctly.
• hot_reload_and_capture fuses hot reload, screenshot, semantic snapshot, and app errors into a single response for the agent edit/preview loop.
• evaluate_dart_expression runs a Dart expression against the root library in the running isolate (e.g. AgentState.instance.counter) and returns {result, kind, classRef}.
• get_recent_logs exposes a 200-entry ring buffer of recent print / debugPrint output captured from the running app.

flutter-mcp-toolkit init <agent>

• New init subcommand auto-detects mode and writes per-target skills, agent files, and manifests for Claude Code, Cursor, Codex, and other supported agents in one call.
• codegen-init emits the Flutter main.dart snippet that bootstraps the toolkit on the app side (MCPToolkitBinding.initialize() / initializeFlutterToolkit()).
• Replaces the per-agent manual setup docs that shipped in v2.

Claude Code marketplace plugin (plugin/)

• Plugin manifests (.claude-plugin/, .cursor-plugin/, .codex-plugin/), mcp.json, install.sh, EXPECTED_SERVER_VERSION, and a marketplace entry under .claude-plugin/marketplace.json.
• Skills shipped include flutter-mcp-toolkit-{guide,setup,inspect,control,debug}, flutter-mcp-toolkit-custom-tools, flutter-mcp, and flutter-mcp-cli-runtime-validation.
• flutter-mcp-toolkit-runtime agent.
• Skill bodies are bundled into the server (skill_assets.g.dart) so the CLI can ship them as part of init. make sync-skills regenerates; CI fails PRs that don't.

Showcase redesign

• flutter_test_app rebuilt as a single-page showcase (ShowcaseScreen) where every interaction tool has a named target with a Semantics identifier (greeting_input_field, feature_toggle_switch, brightness_slider, scroll_demo_list, hot_reload_marker, emit_log_button, trigger_error_button, last_log_display, ...).
• Integration-test identifiers (about_demo_heading, counter_demo_heading, counter_demo_icon, stateful_counter_increment_button) are preserved.
• AgentState singleton lets agents read and mutate showcase state through evaluate_dart_expression.
• Section heading semantics are isolated for cleaner snapshots.

Install and release

• Root install.sh for one-command install/upgrade on darwin-arm64, darwin-x64, linux-x64. Updates PATH.
• Release artifact builder with tarball + checksum generation: tool/release/build_release_artifacts.sh.
• Tagged release workflow: .github/workflows/release.yml.

Contract quality gates (make check-contracts)

• tool/contracts/check_sdk_parity.sh — Docker base image vs pubspec.
• tool/contracts/check_error_code_playbook.sh — error-code surface coverage.
• tool/contracts/check_docs_drift.sh — CLI help vs docs.
• tool/contracts/check_plugin_surfaces.sh — plugin manifest shape.
• tool/contracts/check_tool_prefix.sh — single canonical prefix across every shipped doc; CHANGELOG migration table covers the locked tool surface.
• CI: .github/workflows/contract_gates.yml.
• macOS integration smoke runner: tool/integration/classify_macos_integration_run.sh.

CLI safety + observability

• flutter-mcp-toolkit doctor [--json] [--target <path>] [--timeout-ms <n>] for CI preflight before VM-dependent operations.
• Safe-write flags for snapshot create and bundle create: --check, --diff, --backup, --no-overwrite. Bundle publishing is now staged and atomic; the destructive pre-delete is gone.
• Connection UX:
  • Startup stays non-blocking when multiple targets are present.
  • First VM-dependent call auto-attaches when target resolution is unambiguous; ambiguity surfaces as connection_selection_required with availableTargets and retry guidance.
  • Optional strict nested connection object across every VM-dependent MCP tool and dynamic-registry tool.
  • Resource URI query-based connection targeting (targetId, mode, host, port, uri, forceReconnect).
• Flutter web auto-discovery:
  • Machine discovery via flutter attach --machine with optional project / device context.
  • Merged machine + port-scan discovery using URI-id selection payloads.
• Runtime discovery flags for the CLI and MCP server:
  • --flutter-project-dir
  • --flutter-device
  • --flutter-discovery-timeout-ms
• CLI / daemon alignment:
  • exec --args and daemon command/execute / watch/start accept the same optional params.args.connection.
  • snapshot create supports per-step args.commands[i].args.connection.
  • Preconnect no longer returns synthetic vm_not_connected for ambiguous multi-target paths; ambiguity surfaces as connection_selection_required.
  • Explicit requested-session attach stays strict; implicit stale active-session attach falls back to auto target resolution.
  • connect and session_start reject mixed native selector args with nested connection.

Changed

• The --use-capability-kernel flag is gone; the kernel is the only registration path. The legacy unprefixed registration mixin was deleted in T9.
• README rewritten around the four-step install (install.sh → init <agent> → run app → call tools).
• ARCHITECTURE.md rewritten around the capability kernel and the shared-core packages. New ADRs in docs/decisions/:
  • 0001_capability_kernel_and_tool_prefix.mdx
  • 0002_v3_scope_and_consolidation_deferrals.mdx
• Docs reorganized under docs/start_here/, docs/decisions/, docs/ai_agents/, docs/superpowers/, docs/guides/.
• Dockerfile pinned to dart:3.11.0-sdk.

Fixed

• resolveCenter / resolveBounds return logical (not physical) coordinates — DPR fix that unblocked tap / long-press on high-DPI screens.
• fill_form actually stops on first toolkit-side failure.
• wait_for timeout payload shape pinned by tests; malformed payloads route correctly.
• popUntil guard and bad-route logging in the toolkit.
• semantic_snapshot surfaces scrollable nodes (widgets that advertise scrollUp/Down/Left/Right) so agents can pass an explicit ref to scroll for the deterministic semantic-action path.
• scroll direction-to-SemanticsAction mapping realigned with the Playwright "direction = reveal" convention: direction: "down" now maps to SemanticsAction.scrollUp (finger up, reveals content below), so the Tier 1 path succeeds on real Flutter scrollables at the top of their range.

Flutter Web interaction support

Interaction tools are Tier 1 first on web and degrade predictably when Tier 1 isn't available:

• semantic_snapshot, evaluate_dart_expression, get_recent_logs, hot_reload_flutter, and hot_reload_and_capture work unchanged on web.
• tap_widget, long_press, and scroll (with ref) work when the target node exposes the matching SemanticsAction. The action shows up in the node's actions array in semantic_snapshot.
• enter_text works via SemanticsAction.setText or the EditableTextState.userUpdateTextEditingValue fallback (both work on web).
• swipe(ref, direction) on web redirects to the matching scroll semantic action when ref is a scrollable that exposes it; success responses return via: "semantic_action_fallback" with a note field explaining the redirect.
• scroll without a ref walks the semantics tree for a matching scrollable and uses Tier 1.
• When no Tier 1 path exists (tap / long-press on nodes without the matching action, swipe on a non-scrollable or no-ref target, drag, scroll without any scrollable in tree), web returns a structured web_gesture_not_supported envelope with a hint pointing the agent at the right workaround (snapshot for a different ref, add a Semantics wrapper, or use evaluate_dart_expression).

Removed

• Per-agent manual setup docs — superseded by flutter-mcp-toolkit init <agent>.
• Manual install / client-setup docs — superseded by install.sh + init.
• docs/core/built_in_tools and docs/core/error_code_playbook — migrated into the plugin's debug and guide skills.
• docs/getting_started/ and docs/troubleshooting/ — content moved under docs/start_here/.
• memory-bank/ legacy AI memory directory.
• mcp_toolkit/devtools_mcp_extension/.

Deferred (post-3.0.0)

• Network introspection — see todo/p3_network_introspection.md.
• select_option form action.
• P4 consolidation set A / C from the audit.

Version alignment

• mcp_server_dart: 3.0.0
• mcp_toolkit: 3.0.0

Migration: v2.x → v3.0.0

• Add fmt_ to every MCP tools/call name. See docs/start_here/migration_v2_to_v3.mdx.
• Update binary names in your mcpServers config and any wrapper scripts: flutter_inspector_mcp → flutter-mcp-toolkit-server, flutter_mcp_cli → flutter-mcp-toolkit.
• Replace error parsing that expected top-level category / retryable / exitCode with reads against error.descriptor.
• Stop sending string-encoded typed values; pass real JSON types only.
• Switch any targetId of the form host:port to the full ws://.../ws URI, or pass connection.uri.
• Move top-level host / port / uri arguments into the nested connection object.
• For write-producing commands, prefer --check --diff first in automation. If overwrite must be blocked, set --no-overwrite and handle write_blocked.
• Use flutter-mcp-toolkit doctor --json in CI preflight before VM-dependent operations.

• Dart SDK updated to 3.10.0 with all dependencies updated to the latest versions

• now VM service auto-reconnect when Flutter app restarts. Huge thank you to @jkitching for PR! https://github.com/Arenukvern/mcp_flutter/pull/73

0.3.0

BREAKING CHANGES:

Dart SDK: 3.8.0

• chore: dart_mcp: ^0.3.3
• chore: from_json_to_json: ^0.3.0
• chore: lints: ^6.0.0
• chore: xsoulspace_lints: ^0.1.2

0.2.3

• perf: added more checks for [MCPCallEntry.resourceUri]

0.2.0

• Added addMcpTool function to add a single MCP tool to the MCP toolkit.

BREAKING CHANGES

• Replaced MCPCallEntry with two constructors to create MCPCallEntry for resources and tools:
  • MCPCallEntry.resource to create MCPCallEntry for resources.
  • MCPCallEntry.tool to create MCPCallEntry for tools. This change simplifies the syntax by removing the need to write name of tool twice.
  • Now MCPToolDefinition has inputSchema as required parameter with ObjectSchema from dart_mcp package for better type safety. For example:

      definition: MCPToolDefinition(
        name: 'calculate_fibonacci',
        description: 'Calculate the nth Fibonacci number and return the sequence',
        inputSchema: ObjectSchema(
          properties: {
            'n': IntegerSchema(
              description: 'The position in the Fibonacci sequence (0-100)',
              minimum: 0,
              maximum: 100,
            ),
          },
          required: ['n'],
        ),
      ),
    

0.1.2

• Added kDefaultMaxErrors and maxErrors constants to ErrorMonitor class to limit number of errors stored.
• Added kDebugMode check to MCPToolkitBinding.initialize method.
• Added kDebugMode check to MCPToolkitExtensions.initializeServiceExtensions method.
• Added kDebugMode check to MCPToolkitExtensions.registerServiceExtension method to prevent adding entries in release mode.

0.1.1

• Fixed documentation.

0.1.0

• Initial release.