Changelog

v0.14.0

September 3, 2026

What's new

• MCP SDK v2: modern protocol negotiation while retaining legacy clients, correct direct-stdio resource subscriptions, consistent daemon identity across launcher directories, and scoped npm plugin loading. (#71, closes #70)
• Safer CDP connections: list_devices reports attachability and rejection reasons; reconnects stay pinned to the same Metro server and application rather than attaching to another device or auxiliary runtime. Uses the published metro-bridge ^0.2.9. (#74, closes #72)
• Managed daemon cleanup: stdio proxies hold renewable leases; crashed or disconnected clients no longer leave auto-spawned daemons running indefinitely. Explicit metro-mcp serve remains long-lived. Stale records and startup locks are cleaned safely. (#75, closes #73)
• Screenshot delivery: unique private PNG paths by default, opt-in native MCP image blocks, reliable inline cleanup, and explicit native tool-result support for plugins. (#76, closes #69)
• Focused, bounded fiber inspection: iterative traversal across renderers and roots, navigation-aware scene filtering, paginated snapshots, completeness metadata, and asynchronous Fabric/Paper point measurement, including lazy Fabric public instances on Android. The Components App follows pages and warns about incomplete results. (#77, closes #68)

Read-tool response changes

• get_component_tree returns flat paged nodes with id, parentId, and depth, plus snapshotId, traversal, and nextCursor. Follow cursors to collect the full snapshot.
• find_components returns { matches, traversal }; get_testable_elements and list_elements return { elements, traversal }.
• inspect_component and inspect_at_point include the result and traversal metadata. Check traversal.complete before interpreting an empty result as a definitive absence.
• Traversal defaults to maxDepth: 200 and maxNodes: 1200; depth can be raised to 600. Component-tree pages default to 100 nodes, with a maximum of 250 and 60-second cursors.
• take_screenshot defaults to delivery: "path". Use delivery: "inline" for a native MCP image content block.

Validation

Typecheck, 107 tests, production build, and docs build pass on the combined release tree using the published Metro Bridge dependency. Earlier live iOS and Android integration tests covered focused trees, pagination, precise point inspection, screenshots, and both MCP protocol eras; built-process tests covered daemon leases and reconnect pinning.

Full changelog: https://github.com/steve228uk/metro-mcp/compare/v0.13.2...v0.14.0

---

v0.13.2

July 29, 2026

What's Changed

• fix(network): capture requests on RN fusebox where the only requestWillBeSent carries a stack by @audrius-savickas in https://github.com/steve228uk/metro-mcp/pull/65

Full Changelog: https://github.com/steve228uk/metro-mcp/compare/v0.13.1...v0.13.2

---

v0.13.1

June 23, 2026

What's Changed

• Reduce idle CPU and heap growth in subscribed sessions by @steve228uk in https://github.com/steve228uk/metro-mcp/pull/61

Full Changelog: https://github.com/steve228uk/metro-mcp/compare/v0.13.0...v0.13.1

---

v0.13.0

June 23, 2026

What's Changed

• Stabilize Metro MCP daemon reuse and CDP proxying by @steve228uk in https://github.com/steve228uk/metro-mcp/pull/63

Full Changelog: https://github.com/steve228uk/metro-mcp/compare/v0.12.0...v0.13.0

---

v0.12.0

June 2, 2026

What's Changed

• Add shared MCP multiplexing for concurrent clients by @steve228uk in https://github.com/steve228uk/metro-mcp/pull/58

Full Changelog: https://github.com/steve228uk/metro-mcp/compare/v0.11.5...v0.12.0

---

v0.11.5

May 16, 2026

What's Changed

• fix: Use metro-bridge for doctor by @steve228uk in https://github.com/steve228uk/metro-mcp/pull/56

Full Changelog: https://github.com/steve228uk/metro-mcp/compare/v0.11.4...v0.11.5

---

v0.11.4

May 16, 2026

What's Changed

• Bump metro-bridge and release metro-mcp 0.11.4 by @steve228uk in https://github.com/steve228uk/metro-mcp/pull/55

Full Changelog: https://github.com/steve228uk/metro-mcp/compare/v0.11.3...v0.11.4

---

v0.11.3

May 13, 2026

What's Changed

• Remove postinstall hook — ship pre-built dist via CI (fixes npx/npm compatibility) by @steve228uk in https://github.com/steve228uk/metro-mcp/pull/53

Full Changelog: https://github.com/steve228uk/metro-mcp/compare/v0.11.2...v0.11.3

---

v0.11.2

May 12, 2026

What's Changed

• Refine MCP app height sizing helpers by @steve228uk in https://github.com/steve228uk/metro-mcp/pull/51

Full Changelog: https://github.com/steve228uk/metro-mcp/compare/v0.11.1...v0.11.2

---

v0.11.1

May 12, 2026

What's Changed

• Add minimum height support for MCP app resources by @steve228uk in https://github.com/steve228uk/metro-mcp/pull/50

Full Changelog: https://github.com/steve228uk/metro-mcp/compare/v0.11.0...v0.11.1

---

v0.11.0

May 12, 2026

What's Changed

• Add pinned packages support to community plugins loader by @steve228uk in https://github.com/steve228uk/metro-mcp/pull/44
• add codex by @benschac in https://github.com/steve228uk/metro-mcp/pull/45
• Update docs to include OpenCode by @steve228uk in https://github.com/steve228uk/metro-mcp/pull/47
• Adopt MCP Apps integration for interactive runtime panels by @steve228uk in https://github.com/steve228uk/metro-mcp/pull/48

New Contributors

• @benschac made their first contribution in https://github.com/steve228uk/metro-mcp/pull/45

Full Changelog: https://github.com/steve228uk/metro-mcp/compare/v0.10.0...v0.11.0

---

v0.10.0

April 13, 2026

What's Changed

• Add CLI commands for plugin scaffolding and project setup by @steve228uk in https://github.com/steve228uk/metro-mcp/pull/43

Full Changelog: https://github.com/steve228uk/metro-mcp/compare/v0.9.2...v0.10.0

---

v0.9.2

April 13, 2026

What's Changed

• Add community plugins page to docs by @steve228uk in https://github.com/steve228uk/metro-mcp/pull/40
• Fix custom plugin resolution by @steve228uk in https://github.com/steve228uk/metro-mcp/pull/42

Full Changelog: https://github.com/steve228uk/metro-mcp/compare/v0.9.1...v0.9.2

---

v0.9.1

April 12, 2026

What's Changed

• Custom plugin improvements by @steve228uk in https://github.com/steve228uk/metro-mcp/pull/39

Full Changelog: https://github.com/steve228uk/metro-mcp/compare/v0.9.0...v0.9.1

---

v0.9.0

April 11, 2026

What's Changed

• Clarify console/network/error output formats and add since parameter by @steve228uk in https://github.com/steve228uk/metro-mcp/pull/35
• Add permissions plugin for iOS Simulator and Android Emulator by @steve228uk in https://github.com/steve228uk/metro-mcp/pull/36
• Add filesystem plugin for browsing app sandbox directories by @steve228uk in https://github.com/steve228uk/metro-mcp/pull/37
• Add environment plugin for inspecting app runtime configuration by @steve228uk in https://github.com/steve228uk/metro-mcp/pull/38

Full Changelog: https://github.com/steve228uk/metro-mcp/compare/v0.8.4...v0.9.0

---

v0.8.4

April 10, 2026

What's Changed

• Improve token efficiency of tool responses by @steve228uk in https://github.com/steve228uk/metro-mcp/pull/34

Full Changelog: https://github.com/steve228uk/metro-mcp/compare/v0.8.3...v0.8.4

---

v0.8.3

April 9, 2026

What's Changed

• Fix connection issues with React Native <0.85 by @steve228uk in https://github.com/steve228uk/metro-mcp/pull/33

Full Changelog: https://github.com/steve228uk/metro-mcp/compare/v0.8.2...v0.8.3

---

v0.8.2

April 9, 2026

What's Changed

• Add MCP spec features: tool annotations, progress notifications, resource subscriptions by @steve228uk in https://github.com/steve228uk/metro-mcp/pull/32

Full Changelog: https://github.com/steve228uk/metro-mcp/compare/v0.8.1...v0.8.2

---

v0.8.1

April 8, 2026

What's Changed

• Add MCP registry publishing via GitHub Actions by @steve228uk in https://github.com/steve228uk/metro-mcp/pull/29

Full Changelog: https://github.com/steve228uk/metro-mcp/compare/v0.8.0...v0.8.1

---

v0.8.0

April 8, 2026

What's Changed

• Use default debugger URL on RN 0.85+ by @steve228uk in https://github.com/steve228uk/metro-mcp/pull/28

Full Changelog: https://github.com/steve228uk/metro-mcp/compare/v0.7.2...v0.8.0

---

v0.7.2

April 8, 2026

What's Changed

• Fix tap_element/long_press not working when testID is on a child element by @steve228uk in https://github.com/steve228uk/metro-mcp/pull/27

Full Changelog: https://github.com/steve228uk/metro-mcp/compare/v0.7.1...v0.7.2

---

v0.7.1

April 8, 2026

What's Changed

• Add codex plugin manifest by @steve228uk in https://github.com/steve228uk/metro-mcp/pull/25
• Bump version to 0.7.1 and update metro-bridge dependency by @steve228uk in https://github.com/steve228uk/metro-mcp/pull/26

Full Changelog: https://github.com/steve228uk/metro-mcp/compare/v0.7.0...v0.7.1

---

v0.7.0

April 4, 2026

What's Changed

• feat: Migrate to metro-bridge by @steve228uk in https://github.com/steve228uk/metro-mcp/pull/24

Full Changelog: https://github.com/steve228uk/metro-mcp/compare/v0.6.4...v0.7.0

---

v0.6.4

April 3, 2026

What's Changed

• fix: prevent multiple instances from competing for Metro's CDP connection by @audrius-savickas in https://github.com/steve228uk/metro-mcp/pull/23

Full Changelog: https://github.com/steve228uk/metro-mcp/compare/v0.6.3...v0.6.4

---

v0.6.3

April 2, 2026

What's Changed

• fix: resolve console.log objects fully via CDP by @audrius-savickas in https://github.com/steve228uk/metro-mcp/pull/22

New Contributors

• @audrius-savickas made their first contribution in https://github.com/steve228uk/metro-mcp/pull/22

Full Changelog: https://github.com/steve228uk/metro-mcp/compare/v0.6.2...v0.6.3

---

v0.6.2

March 31, 2026

What's Changed

• Add examples and demo to docs by @steve228uk in https://github.com/steve228uk/metro-mcp/pull/18
• Add open-graph image by @steve228uk in https://github.com/steve228uk/metro-mcp/pull/20
• fix: resolve ReferenceError in get_current_route tool by @steve228uk in https://github.com/steve228uk/metro-mcp/pull/21 reported by @efstathiosntonas

Full Changelog: https://github.com/steve228uk/metro-mcp/compare/v0.6.1...v0.6.2

---

v0.6.1

March 30, 2026

What's Changed

• Setup Github Pages by @steve228uk in https://github.com/steve228uk/metro-mcp/pull/17

Full Changelog: https://github.com/steve228uk/metro-mcp/compare/v0.6.0...v0.6.1

---

v0.6.0

March 30, 2026

What's Changed

• feat: add CDP proxy for Chrome DevTools coexistence by @steve228uk in https://github.com/steve228uk/metro-mcp/pull/13
• feat: add debugging tools — globals discovery, reload, network stats, inspect_at_point by @steve228uk in https://github.com/steve228uk/metro-mcp/pull/12
• feat: add per-device buffers for console, network, and error data by @steve228uk in https://github.com/steve228uk/metro-mcp/pull/11
• Document new tools and Chrome DevTools usage in README by @steve228uk in https://github.com/steve228uk/metro-mcp/pull/14
• fix: buffering of duplicate requests by @steve228uk in https://github.com/steve228uk/metro-mcp/pull/15

Full Changelog: https://github.com/steve228uk/metro-mcp/compare/v0.5.2...v0.6.0

---

v0.5.2

March 30, 2026

What's Changed

• Improve connection health detection with ping-based keepalive by @steve228uk in https://github.com/steve228uk/metro-mcp/pull/10

Full Changelog: https://github.com/steve228uk/metro-mcp/compare/v0.5.1...v0.5.2

---

v0.5.1

March 30, 2026

What's Changed

• Migrate from Bun-specific APIs to Node.js standard library by @steve228uk in https://github.com/steve228uk/metro-mcp/pull/9

Full Changelog: https://github.com/steve228uk/metro-mcp/compare/v0.5.0...v0.5.1

---