2.2.0

modelcontextprotocol/inspector2.2.0Aug 12, 2026by cliffhall

AI Summary

Introduces the v2 shared core architecture, upgrades the MCP SDK, and improves cross-platform compatibility.

Key Highlights

Shared `@inspector/core` runtime for Web, CLI, and TUI clients.
MCP SDK upgrade to version 2.0.0.
Enhanced keyring handling with lazy loading on unsupported platforms.
Comprehensive documentation including v1 to v2 migration guide.

Breaking Changes

CLI flags changed: `--config` is now a read-only session file, `--catalog` is the writable server list.
Node.js version requirement increased to >= 22.19.0.
v1 sub-packages (`inspector-client`, `inspector-server`, `inspector-cli`) are deprecated.

New Features

Shared core architecture
v1 to v2 migration guide

Full Release Notes

## What's Changed
* ci: sync the release workflow on v2/main with main's verbatim by @cliffhall in https://github.com/modelcontextprotocol/inspector/pull/1904
* fix: ship clients/web/static so the MCP Apps sandbox proxy loads by @cliffhall in https://github.com/modelcontextprotocol/inspector/pull/1934
* fix: surface list-fetch failures instead of swallowing them by @cliffhall in https://github.com/modelcontextprotocol/inspector/pull/1954
* fix: construct AsyncEntry inside the try so keychain degradation engages (#1848) by @cliffhall in https://github.com/modelcontextprotocol/inspector/pull/1945
* fix: load @napi-rs/keyring lazily so an unsupported platform degrades instead of crashing (#1905) by @cliffhall in https://github.com/modelcontextprotocol/inspector/pull/1948
* fix: render a tool result's structuredContent in the Tools screen (#1908) by @cliffhall in https://github.com/modelcontextprotocol/inspector/pull/1975
* fix(docker): publish on loopback by default; make a mounted state dir writable by @cliffhall in https://github.com/modelcontextprotocol/inspector/pull/1974
* fix(web): keep the text being typed in a schema number field (#1888) by @cliffhall in https://github.com/modelcontextprotocol/inspector/pull/1972
* docs: rules for issue triage and board hygiene by @cliffhall in https://github.com/modelcontextprotocol/inspector/pull/1932
* fix: key tool rows by source position so duplicate names filter correctly by @cliffhall in https://github.com/modelcontextprotocol/inspector/pull/1961
* ci: gate claude.yml on same-repo PRs and pin actions to commit SHAs by @cliffhall in https://github.com/modelcontextprotocol/inspector/pull/1966
* chore(deps): align zod across installs and guard against version skew by @cliffhall in https://github.com/modelcontextprotocol/inspector/pull/1962
* chore: declare the MCP SDK packages only at the repo root (#1970) by @cliffhall in https://github.com/modelcontextprotocol/inspector/pull/1971
* fix: forward the negotiated Mcp-Protocol-Version through the remote proxy by @cliffhall in https://github.com/modelcontextprotocol/inspector/pull/1963
* fix: settle the deliberately in-flight tool calls in the progress tests by @cliffhall in https://github.com/modelcontextprotocol/inspector/pull/1958
* chore(storybook): drop the redundant setProjectAnnotations setup file by @cliffhall in https://github.com/modelcontextprotocol/inspector/pull/1968
* fix: open the modern listen stream whenever the filter is non-empty (#1920) by @cliffhall in https://github.com/modelcontextprotocol/inspector/pull/1967
* fix: prime SSE streams so Firefox resolves the events fetch by @cliffhall in https://github.com/modelcontextprotocol/inspector/pull/1946
* docs: add the v1 → v2 migration guide by @cliffhall in https://github.com/modelcontextprotocol/inspector/pull/1960
* chore(smoke): run the web smokes against a throwaway catalog by @cliffhall in https://github.com/modelcontextprotocol/inspector/pull/1978
* fix(tui): bundle React-rendering deps so a consumer install can't split React by @cliffhall in https://github.com/modelcontextprotocol/inspector/pull/1983
* fix(test): wait for the dead transport instead of sleeping 300ms by @cliffhall in https://github.com/modelcontextprotocol/inspector/pull/1987
* fix(test): clear leaked timers so one cannot fail an unrelated CI run by @cliffhall in https://github.com/modelcontextprotocol/inspector/pull/1986
* docs: document the DCO signoff requirement by @cliffhall in https://github.com/modelcontextprotocol/inspector/pull/1982
* chore: upgrade the MCP TypeScript SDK from 2.0.0-beta.5 to 2.0.0 by @cliffhall in https://github.com/modelcontextprotocol/inspector/pull/1989
* docs: six-month Inspector roadmap (Aug 2026 → Feb 2027) by @cliffhall in https://github.com/modelcontextprotocol/inspector/pull/1981
* chore: merge v2/main for the v2.2.0 milestone release by @cliffhall in https://github.com/modelcontextprotocol/inspector/pull/1993


**Full Changelog**: https://github.com/modelcontextprotocol/inspector/compare/2.1.0...2.2.0