> ## Documentation Index
> Fetch the complete documentation index at: https://mcp-use.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

<AgentInstructions>

## Submitting Feedback

If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback:

POST https://mcp-use.com/docs/feedback

```json
{
  "path": "/inspector/changelog",
  "feedback": "Description of the issue"
}
```

Only submit feedback when you have something specific and actionable to report.

</AgentInstructions>

# Inspector Updates

> New updates and improvements to the MCP Inspector

<Update label="v5.0.0" description="May 2026">
  <Frame>
    <img src="https://mcp-use.com/api/og/release?v=5.0.0&title=OpenRouter%2C%20pre-registered%20OAuth%20%26%20telemetry%20env&date=2026-05&lang=inspector" alt="Release 5.0.0" />
  </Frame>

  ## OpenRouter, pre-registered OAuth & telemetry env

  Major release paired with `mcp-use` v1.27.0: OpenRouter and OpenAI-compatible providers in chat configuration, pre-registered OAuth client credentials in the connection dialog, and `MCP_USE_ANONYMIZED_TELEMETRY` honored in browser telemetry.

  * **New**: OpenRouter as a first-class chat provider — a single OpenRouter API key fronts upstream OpenAI / Anthropic / Google models; internally reuses the OpenAI provider with an override base URL and the required `HTTP-Referer` / `X-Title` headers (`#1403`)
  * **New**: "OpenAI Compatible" entry in the chat provider dropdown — point inspector chat at any OpenAI-compatible API (LM Studio, Ollama, OpenRouter, etc.) with a required Base URL field and an optional API key; the standard OpenAI provider is unchanged (`#1437`)
  * **New**: `Client ID`, `Client Secret`, and `Scope` fields in the Authentication dialog wired through `addServer` / `updateServer` for pre-registered OAuth flows against providers that strip `registration_endpoint` from metadata (`#1400`)
  * **Fix**: Browser telemetry honors `MCP_USE_ANONYMIZED_TELEMETRY=false` — the inspector server mirrors the env var into `window.__MCP_USE_ANONYMIZED_TELEMETRY__` before the client bundle loads, so a single env var disables both `mcp-use`'s in-browser `posthog-js` and the inspector's own client telemetry (`#1443`)
  * **Update**: Updated mcp-use to v1.27.0
</Update>

<Update label="v3.0.2" description="April 2026">
  ## E2E alignment for Settings dropdown

  Patch release updating Playwright coverage for the command palette Settings entry after the navbar refactor; paired with `mcp-use` v1.25.2.

  * **Fix**: Command palette e2e test targets the Settings option via the dropdown trigger introduced in the inspector settings UX (`#1428`)
  * **Update**: Updated mcp-use to v1.25.2
</Update>

<Update label="v3.0.1" description="April 2026">
  ## OAuth single-tab flow, embed fixes & Hono detection

  Patch release fixing OAuth redirect flows, embedded `ChatTab` UI leaks, and Hono duck-type detection in `mountInspector`; paired with `mcp-use` v1.25.1.

  * **Fix**: OAuth authorization now opens in the current tab (`useRedirectFlow: true`, `preventAutoAuth: true`) and the callback navigates the same tab back — users no longer end up with two inspector tabs (`#1391`)
  * **Fix**: Store connection config in `sessionStorage` before OAuth redirect so auto-reconnect works after the callback without a `?autoConnect` param (`#1404`)
  * **Fix**: OAuth callback redirects back to the inspector with error parameters on failure (user denies, server error) instead of showing a raw error page; surfaced as a persistent app-level toast (`#1381`)
  * **Fix**: `mountInspector(app)` detects Hono via duck-typing (`.fetch(Request) => Response`) instead of `instanceof`, resolving crashes when the host and inspector resolve different Hono module records (`#1417`)
  * **Fix**: MCP App widget z-index — removed explicit `z-20`/`z-10` from sandboxed iframe wrappers so widgets scroll beneath the chat header instead of painting over it (`#1407`)
  * **Fix**: Free-tier upgrade UI (`Model & usage` dialog, model badge) is now opt-in via `enableFreeTierUpgrade` on `ChatTab` (default `false`) and is hidden for host-app embeds that manage their own session (`#1399`)
  * **Fix**: Suppress duplicate model chrome (landing pill, `ChatHeader` badge) when host passes `managedLlmConfig` + `hideModelBadge`; chat no longer auto-switches to client-side streaming when `localLlmConfig` exists in localStorage and the host owns the chat stream (`#1418`)
  * **Documentation**: `--no-open` CLI flag added to the inspector CLI reference (`#1397`)
  * **Update**: Updated mcp-use to v1.25.1
</Update>

<Update label="v3.0.0" description="April 2026">
  <Frame>
    <img src="https://mcp-use.com/api/og/release?v=3.0.0&title=Inline%20elicitation%20%26%20social%20meta%20tags&date=2026-04&lang=inspector" alt="Release 3.0.0" />
  </Frame>

  ## Inline elicitation & social meta tags

  Major release paired with `mcp-use` v1.25.0: chat-initiated elicitation requests render inline in the chat thread, hosted inspector links get rich previews, and the peer dependency on `mcp-use` tracks the 1.25 OAuth refactor.

  * **New**: Elicitation requests triggered from the Chat tab render inline in the chat thread instead of routing users through a toast to the Elicitation tab; Tools-tab triggers keep the existing toast flow, and the Elicitation tab remains available as an audit view (`#1336`)
  * **New**: Links to the hosted inspector now render rich previews on Slack, X/Twitter, LinkedIn, Discord, and other platforms (`#1376`)
  * **Update**: Peer dependency on `mcp-use` moves to `>=1.25.0-canary.9` to pick up the OAuth DCR-direct refactor
  * **Update**: Updated mcp-use to v1.25.0
</Update>

<Update label="v2.2.0" description="April 2026">
  <Frame>
    <img src="https://mcp-use.com/api/og/release?v=2.2.0&title=Hosted%20chat%2C%20LLM%20providers%20%26%20chat%20export&date=2026-04&lang=inspector" alt="Release 2.2.0" />
  </Frame>

  ## Hosted chat runtime, LLM providers & chat export

  Minor release paired with `mcp-use` v1.24.2: first-party inspector LLM streaming (no LangChain on the chat path), copy/export chat, runtime hosted-chat URL, hosted free-tier chat, and cloud env tooling via the CLI (`#1372`).

  * **New**: First-party LLM providers for inspector chat (Anthropic, OpenAI, Google) with shared message formatting, SSE streaming, and tool loops — the inspector no longer depends on LangChain for chat (`#1372`)
  * **New**: "Copy Chat" and "Export Chat" in the chat header — markdown to clipboard; download as JSON or Markdown with tool calls in order (`#1324`)
  * **New**: Free tier chat on the hosted inspector (`#1368`)
  * **New**: Hosted chat URL from runtime config — inspector server reads `MANUFACT_CHAT_URL` and injects `window.__MANUFACT_CHAT_URL__`; `InspectorProvider` prefers that value and falls back to `VITE_MANUFACT_CHAT_URL` for local dev (`#1370`)
  * **Fix**: OAuth login popup — drop `noopener` and redirect `callbackURL` to `/inspector/oauth-popup-closed.html` so the popup self-closes instead of loading the full inspector (`#1370`)
  * **Update**: Updated mcp-use to v1.24.2
</Update>

<Update label="v2.1.0" description="April 2026">
  ## Navbar, theme & debug controls

  Minor release with MCP Apps debug theme toggle and navbar/settings UX improvements; dependency bump to `mcp-use` v1.24.1.

  * **New**: Theme toggle button in MCP Apps debug controls toolbar
  * **Enhancement**: Navbar — chat tab first with label and separator; `alwaysExpanded` on tab triggers so the active label stays visible when collapsed; Deploy links to manufact.com/signup with inspector referrer; tunnel control between Add to Client and Deploy with updated styling and mobile visibility; theme toggle, command palette, and GitHub under a settings dropdown; "Report a Bug" prefills a GitHub issue with the inspector label
  * **Update**: Updated mcp-use to v1.24.1
</Update>

<Update label="v2.0.0" description="April 2026">
  <Frame>
    <img src="https://mcp-use.com/api/og/release?v=2.0.0&title=Subpath%20OAuth%2C%20chat%20UX%20%26%20tab%20persistence&date=2026-04&lang=inspector" alt="Release 2.0.0" />
  </Frame>

  ## Subpath OAuth, chat UX & tab persistence

  Major release paired with `mcp-use` v1.24.0: correct OAuth redirects when the inspector is served under `/inspector`, clearer chat streaming UI, and restored tab state after reload.

  * **Fix**: `McpClientProvider` receives `defaultCallbackUrl` so OAuth redirects target `/inspector/oauth/callback` (matches React Router `basename`); removes the authentication dialog "Redirect URL" field that was not wired to the live connection
  * **Fix**: Hide the thinking indicator when the assistant message already has rendered parts so the spinner does not linger after streaming completes
  * **Enhancement**: Persist the active inspector tab across page refresh
  * **Update**: Updated mcp-use to v1.24.0
</Update>

<Update label="v1.0.1" description="April 2026">
  ## Embedded inspector without LangChain

  Patch release fixing server routes that imported `telFetch` from the root `mcp-use` package.

  * **Fix**: Import `telFetch` from `mcp-use/telemetry/tel-fetch` so shared routes do not load the root entry (which eagerly pulls the agent graph); resolves embedded inspector failures when `langchain` is not installed
  * **Update**: Updated mcp-use to v1.23.1
</Update>

<Update label="v1.0.0" description="April 2026">
  <Frame>
    <img src="https://mcp-use.com/api/og/release?v=1.0.0&title=Stream%20Protocol%2C%20Aliases%20%26%20Chat%20Tooling&date=2026-04&lang=inspector" alt="Release 1.0.0" />
  </Frame>

  ## Stream protocol, aliases & chat tooling

  Major release with MCP stream support in chat, connection UX improvements, and dependency hardening.

  * **New**: MCP data stream protocol support in `ChatTab` and `useChatMessages`
  * **Enhancement**: `disabledTools` prop on `ChatTab` and `useChatMessages` for finer tool control
  * **New**: Editable MCP server aliases in connection settings; `updateServerMetadata()` from `McpClientProvider` updates display names without a full reconnect; shared `getServerDisplayName` across dashboard tiles, server dropdown, header actions, command palette, server info modal, and server icon
  * **Fix**: Alias-only edits no longer trigger a full reconnect; IME composition no longer submits the connection form when pressing Enter mid-composition
  * **Enhancement**: Persist tabs on refresh; sync URL `tab` query param when switching tabs so state survives reload
  * **Enhancement**: Tool-invocation serialization, screenshots, and message list refs for integrations such as manufact.build
  * **Update**: Removed unused `transportType` / `setTransportType` props from `ConnectionSettingsForm`
  * **Fix**: Tighter `pnpm` overrides and lockfile refresh for `pnpm audit`; `lodash` override in the mcp-apps scaffold template for standalone installs
  * **Update**: Vite 8.0.5, Hono 4.12.12, `@hono/node-server` 1.19.13
  * **Update**: Updated mcp-use to v1.23.0
</Update>

<Update label="v0.26.1" description="March 2026">
  ## Dependency & bundling alignment

  Patch release aligning how `@mcp-use/inspector` packages `mcp-use` for bundling and shared types.

  * **Fix**: Restore `mcp-use` as both a `dependency` and `peerDependency` — tsup bundles non-React subpaths with transitive deps; `peerDependency` preserves shared `mcp-use`/`react` types with the host app
  * **Update**: Updated mcp-use to v1.22.3
</Update>

<Update label="v0.26.0" description="March 2026">
  ## Peer Dependency Alignment & MCP UI v7

  Minor release aligning inspector dependency strategy for shared type safety and upgrading MCP UI client rendering internals.

  * **Fix**: Moved `mcp-use` from `dependencies` to `peerDependencies` in `@mcp-use/inspector` so consumers reuse a single `mcp-use` type instance (prevents pnpm duplicate-type TS2322 conflicts)
  * **Enhancement**: Upgraded `@mcp-ui/client` from v6 to v7
  * **Enhancement**: Replaced removed legacy `UIResourceRenderer` path with sandboxed iframe rendering for legacy `ui://` resources
  * **Enhancement**: Removed remote-dom usage to align with upstream `@mcp-ui/client` v7 changes
  * **Update**: Updated mcp-use to v1.22.2
</Update>

<Update label="v0.25.1" description="March 2026">
  ## Chat History Tool Results & ErrorBoundary Customization

  Patch release improving chat history reconstruction so tool calls/results (including `structuredContent`) persist across turns, plus ErrorBoundary fallback/reporting hooks.

  * **Fix**: Preserve tool invocation context across chat turns — reconstruct assistant messages as `AIMessage` tool calls plus `ToolMessage` results; keep `structuredContent` and strip `_meta` before sending to the model
  * **Enhancement**: Chat message conversion supports tool results and multimodal content more reliably
  * **Enhancement**: `ErrorBoundary` now supports `fallback` (node or `(error) => node`) and `onError` for reporting (default UI unchanged)
  * **Update**: Updated mcp-use to v1.22.1
</Update>

<Update label="v0.25.0" description="March 2026">
  ## Tunnel Controls & Vite 8

  Minor release with tunnel management for `mcp-use dev`, Vite 8 build stack, and elicit payload alignment with the MCP spec.

  * **New**: Start/stop the `mcp-use dev` tunnel from the Inspector
  * **Enhancement**: Vite 8.0 with Rolldown bundler and `@vitejs/plugin-react` 6 in the inspector build
  * **Fix**: Elicit — send `content` instead of `data` per the MCP spec; aligns with `createElicitMethod` validation on the client
  * **Update**: Updated mcp-use to v1.22.0
</Update>

<Update label="v0.24.5" description="March 2026">
  ## Dependency Updates

  Patch release with dependency updates.

  * **Fix**: Dependabot security alerts — updated vulnerable dependencies (hono, dompurify, etc.)
  * **Update**: Updated mcp-use to v1.21.5
</Update>

<Update label="v0.24.4" description="March 2026">
  ## Dependency Update

  Patch release with dependency update.

  * **Update**: Updated mcp-use to v1.21.4
</Update>

<Update label="v0.24.3" description="March 2026">
  ## Sandbox Host Fix

  Patch release fixing sandbox host derivation for cloud-embedded inspector pages.

  * **Fix**: Sandbox host derivation for cloud-embedded pages — apex hosts (e.g. manufact.com) now resolve to `sandbox-inspector.{domain}` instead of `sandbox-{domain}`
  * **Update**: Updated mcp-use to v1.21.3
</Update>

<Update label="v0.24.2" description="March 2026">
  ## Embedded Inspector Proxy Fix

  Patch release fixing auto-connect when inspector is served from MCP server (Python, custom servers).

  * **Fix**: Skip proxy when inspector origin matches MCP server origin — no longer routes through missing `/inspector/api/proxy` on embedded servers
  * **Fix**: Detect proxy availability via runtime config injection (`__MCP_PROXY_URL__`); disable autoProxyFallback when no proxy is available
  * **Update**: Updated mcp-use to v1.21.2
</Update>

<Update label="v0.24.1" description="March 2026">
  ## Chat Components & Dark Mode Fixes

  Patch release with exported chat component enhancements and proxy header handling.

  * **Fix**: Tools selection and attachment button icons invisible in dark mode
  * **Enhancement**: Strip infra headers from proxied requests
  * **New**: Initial messages support for exported chat components (`ChatTab`, `useChatMessages`)
  * **Update**: Updated mcp-use to v1.21.1
</Update>

<Update label="v0.24.0" description="March 2026">
  ## Inspector Embedding & MCP Apps

  Minor release with embedding support and logger improvements.

  * **New**: Inspector embedding support — build fix and `InspectorProvider` for embedded usage
  * **New**: MCP Apps support in `clientInfo.capabilities` — inspector advertises `io.modelcontextprotocol/ui`
  * **Enhancement**: Logger middleware filters noisy API endpoints (telemetry, RPC stream/log)
  * **Fix**: `--no-open` flag respected in standalone dev mode (was always opening browser)
  * **Update**: Updated mcp-use to v1.21.0
</Update>

<Update label="v0.23.1" description="February 2026">
  ## Dependency Update

  Patch release with dependency update.

  * **Update**: Updated mcp-use to v1.20.5
</Update>

<Update label="v0.23.0" description="February 2026">
  ## Embedded Chat Improvements

  Minor release improving embedded chat experience.

  * **Enhancement**: Improved embedded chat
  * **Update**: Updated mcp-use to v1.20.4
</Update>

<Update label="v0.22.3" description="February 2026">
  ## Standalone Deployment Fix

  Patch release fixing version import in standalone deployment.

  * **Fix**: Standalone deployment was importing the version from the wrong path
  * **Update**: Updated mcp-use to v1.20.3
</Update>

<Update label="v0.22.2" description="February 2026">
  ## Connection & Widget Display Improvements

  Patch release with useAutoConnect, MCPAppsRenderer, and chat agent fixes.

  * **Fix**: useAutoConnect now retains tile visibility on connection failure
  * **Enhancement**: MCPAppsRenderer and OpenAIComponentRenderer — improved border handling and status display; `prefersBorder` default set to false; status labels above widget in inline mode
  * **Enhancement**: ToolResultDisplay z-index for proper sticky layering
  * **Enhancement**: `exposeResourcesAsTools` and `exposePromptsAsTools` options in MCPAgentOptions; inspector chat tab sets both to `false` so agent only exposes actual MCP tools
  * **Update**: Updated mcp-use to v1.20.2
</Update>

<Update label="v0.22.1" description="February 2026">
  ## Widget Status Texts & CSP Fixes

  Patch release with invoking/invoked status display and CSP handling improvements.

  * **New**: Display of `invoking` and `invoked` status texts in MCPAppsRenderer, OpenAIComponentRenderer, ToolResultDisplay, ToolResultRenderer
  * **Enhancement**: MCPAppsDebugControls adjusts violation indicators based on CSP mode
  * **Fix**: sandbox-proxy strips existing CSP meta tags before injecting permissive CSP
  * **Update**: Updated mcp-use to v1.20.1
</Update>

<Update label="v0.22.0" description="February 2026">
  <Frame>
    <img src="https://mcp-use.com/api/og/release?v=0.22.0&title=Iframe%20Console%20%26%20CSP%20Panel&date=2026-02&lang=inspector" alt="Release 0.22.0" />
  </Frame>

  ## Iframe Console & CSP Panel

  Minor release with Iframe Console enhancements and CSP violation handling.

  * **New**: Iframe Console with expandable logs, level filter, search, resizable height
  * **New**: Widget debug context for chat
  * **Enhancement**: MCP Apps debug controls (tool props JSON view, required props hint, SEP-1865 semantics)
  * **New**: CDN build
  * **Fix**: useSyncExternalStore first-render handling; reconnect logic; Tools tab sends only explicitly set fields; resource annotations include `_meta`
  * **New**: CSP violations panel with clear action; widget re-execution on CSP mode change; CSP mode for Apps SDK
  * **Update**: Updated mcp-use to v1.20.0
</Update>

<Update label="v0.21.1" description="February 2026">
  ## Dependency Update

  Patch release with dependency update.

  * **Update**: Updated mcp-use to v1.19.3
</Update>

<Update label="v0.21.0" description="February 2026">
  <Frame>
    <img src="https://mcp-use.com/api/og/release?v=0.21.0&title=Bulk%20Paste%20%26%20Tool%20Definition%20Enhancements&date=2026-02&lang=inspector" alt="Release 0.21.0" />
  </Frame>

  ## Bulk Paste & Tool Definition Enhancements

  Minor release adding bulk paste functionality and enhanced tool definition handling.

  * **New**: Bulk paste functionality in ToolsTab - paste JSON or JavaScript object syntax directly
  * **New**: Auto-fill dialog to confirm updates when pasted data would overwrite existing values
  * **Enhancement**: ToolExecutionPanel now copies full tool definition
  * **Enhancement**: Added utility functions for parsing and converting JavaScript object syntax to JSON
  * **Enhancement**: Visual feedback for auto-filled fields in ToolInputForm
  * **Update**: Updated mcp-use to v1.19.2
</Update>

<Update label="v0.20.1" description="February 2026">
  ## MCPApps & Widget Improvements

  Patch release improving widget loading and iframe handling.

  * **Enhancement**: Improved MCPAppsRenderer loading logic and widget handling
  * **Enhancement**: Enhanced useWidget for better iframe lifecycle management
  * **Update**: Updated mcp-use to v1.19.1
</Update>

<Update label="v0.20.0" description="February 2026">
  <Frame>
    <img src="https://mcp-use.com/api/og/release?v=0.20.0&title=Chat%20Quick%20Questions%20%26%20Enhanced%20UX&date=2026-02&lang=inspector" alt="Release 0.20.0" />
  </Frame>

  ## Chat Quick Questions & Enhanced UX

  Minor release with chat quick questions and followups, improved loading states, and developer experience enhancements.

  ### Chat Enhancements

  * **New**: Support for `chatQuickQuestions` and `chatFollowups` in ChatTab components

  ### Loading & Error Handling

  * **Enhancement**: MCPAppsRenderer shows loading spinner with `isReady` state management
  * **Enhancement**: Replaced shimmer with Spinner component for better initial widget load UX
  * **Enhancement**: Added skeleton loading state for widgets
  * **Enhancement**: Global error listeners and improved error logging in widget components

  ### Developer Experience

  * **New**: Copy all logs to clipboard feature
  * **Enhancement**: Enhanced theme handling in OpenAIComponentRenderer
  * **Enhancement**: ToolsList displays metadata and icons differentiating MCP/OpenAI tool types
  * **Fix**: Allow permissive CSP frame ancestors by default
  * **Fix**: Correct MIME type for mcp\_apps resource counting

  ### Dependencies

  * **Update**: Updated mcp-use to v1.19.0
</Update>

<Update label="v0.19.0" description="February 2026">
  <Frame>
    <img src="https://mcp-use.com/api/og/release?v=0.19.0&title=Tool%20Arguments%20%26%20Streaming%20Input&date=2026-02&lang=inspector" alt="Release 0.19.0" />
  </Frame>

  ## Tool Arguments, Streaming Input & Elicitation Enum Support

  Minor release with tool argument handling, streaming input support, and elicitation enum variants.

  * **New**: Tool argument type coercion and schema resolution (boolean, array, object); ToolsTab and ToolInputForm use new schema utilities; validation server tool and E2E tests for typed arguments
  * **New**: Partial tool input handling for streaming arguments in MCPAppsRenderer; MessageList and ToolResultRenderer support streaming states; useChatMessagesClientSide handles streaming tool call arguments; useWidget types for partial/streaming state
  * **New**: Elicitation support for SEP-1330 enum schema variants (single-select, multi-select); client and server handling; Elicitation tab docs and tests
  * **Fix**: Readiness state reset when widget URL changes in OpenAIComponentRenderer; improved tool output and response metadata handling for pending-to-ready transitions
  * **Update**: Updated mcp-use to v1.18.0
</Update>

<Update label="v0.18.9" description="February 2026">
  ## Log Noise Reduction

  Patch release reducing dev server log noise and aligning dependencies.

  * **Fix**: Reduced noisy logs in the dev server
  * **Update**: Updated mcp-use to v1.17.4
</Update>

<Update label="v0.18.8" description="February 2026">
  ## Widget Readiness & Iframe Global Sync Fixes

  Patch release focused on widget iframe lifecycle reliability and state update safety.

  * **Fix**: Reset widget readiness state when widget URL changes so new iframes re-initialize correctly
  * **Enhancement**: Improved tool output and response metadata transitions from pending to ready states
  * **Enhancement**: Queued iframe global updates until OpenAI globals are available for more reliable widget synchronization
  * **Fix**: Added animation frame cleanup logic to prevent memory leaks during component unmount
  * **Update**: Updated mcp-use to v1.17.3
</Update>

<Update label="v0.18.7" description="February 2026">
  ## Chat Conversion & Error Copy Fixes

  Patch release improving chat message conversion and copy behavior.

  * **Fix**: Copy button now copies actual error text instead of `null`
  * **Fix**: Chat message conversion now falls back to `parts` when `content` is empty, with improved attachment handling
  * **Enhancement**: Chat request streaming now uses external history for better context handling and to avoid duplicated messages
  * **Update**: Updated mcp-use to v1.17.2
</Update>

<Update label="v0.18.6" description="February 2026">
  ## Dependency Update

  Patch release aligned with mcp-use dependency updates.

  * **Update**: Updated mcp-use to v1.17.1
</Update>

<Update label="v0.18.5" description="February 2026">
  ## Iframe Embedding & Reverse Proxy Support

  Patch release with iframe embedding configuration, reverse proxy improvements, and widget rendering fixes.

  * **New**: `MCP_INSPECTOR_FRAME_ANCESTORS` environment variable to control which origins can embed the inspector in iframes via CSP `frame-ancestors`
  * **New**: `mountInspector` accepts `devMode` and `sandboxOrigin` options for deployment flexibility
  * **New**: Runtime config injection (`__MCP_DEV_MODE__`, `__MCP_SANDBOX_ORIGIN__` window globals) without rebuild
  * **Enhancement**: Server-side widget fetches convert external proxy URLs to localhost for correct content retrieval
  * **Enhancement**: Simplified widget asset URL rewriting for improved reverse proxy reliability
  * **Fix**: Infinite re-render loop in `MCPAppsRenderer` caused by excessive `useEffect` dependencies
  * **Update**: Updated mcp-use to v1.17.0
</Update>

<Update label="v0.18.4" description="February 2026">
  <Frame>
    <img src="https://mcp-use.com/api/og/release?v=0.18.4&title=E2E%20Testing%20%26%20Refresh%20Features&date=2026-02&lang=inspector" alt="Release 0.18.4" />
  </Frame>

  ## E2E Testing & Refresh Features

  Patch release with comprehensive E2E testing infrastructure and enhanced UI functionality.

  ### E2E Testing Infrastructure

  * **New**: Comprehensive Playwright-based E2E test suite with full coverage for chat, connections, HMR, widgets, and command palette
  * **New**: GitHub Actions workflow (`.github/workflows/inspector-e2e.yml`) for automated E2E testing across multiple modes
  * **New**: Test fixtures for authentication servers (OAuth mock, API key, custom headers)
  * **New**: Test helpers for connection, authentication, and debugger tools
  * **New**: Test matrix for parameterized test scenarios across multiple inspector modes (mix, prod, builtin)
  * **New**: Widget examples for conformance testing (weather-display, status-card, display-info, apps-sdk-only-card)
  * **Enhancement**: Comprehensive E2E testing documentation in `tests/e2e/README.md`

  ### Testability Improvements

  * **Enhancement**: Added `data-testid` attributes across 40+ UI components for reliable element selection
  * **Enhancement**: Enhanced component accessibility for automated testing including connection forms, server list, command palette, chat interface, tool execution panels, resources/prompts/tools tabs, and elicitation/sampling displays

  ### UI Enhancements

  * **New**: Refresh buttons with loading states for Tools, Resources, and Prompts tabs
  * **New**: `ListTabHeader` component with refresh functionality and spinning icon animation
  * **Enhancement**: Manual refresh capability for primitives without reconnecting to server
  * **Fix**: Inspector now detects when `server=` query parameter contains a URL that's not already connected and automatically redirects to use `autoConnect=` instead
  * **Enhancement**: Added comprehensive URL parameters documentation page to inspector reference

  ### Widget Improvements

  * **Fix**: Widget pending state now correctly emulated to reflect ChatGPT behavior
  * **Enhancement**: MCPAppsRenderer and OpenAIComponentRenderer handle tool output and metadata more effectively
  * **Enhancement**: Immediate rendering of widgets even when results are pending
  * **Enhancement**: MessageList and ToolResultRenderer support immediate rendering of widget tools
  * **Enhancement**: Widget props support in ToolResultDisplay

  ### Server Improvements

  * **Enhancement**: Changed default port from 3001 to 3000 for production builds (dev still uses 3001)
  * **Enhancement**: Skip telemetry (PostHog/Scarf) when `NODE_ENV=test` or `MCP_USE_ANONYMIZED_TELEMETRY=false`
  * **New**: `start-auth-servers.ts` utility for running authentication test servers

  ### Dependencies

  * **Update**: Updated mcp-use to v1.16.4
</Update>

<Update label="v0.18.3" description="February 2026">
  ## Dependency Update

  Patch release with dependency updates.

  * **Update**: Updated mcp-use to v1.16.3
</Update>

<Update label="v0.18.2" description="January 2026">
  ## Inspector Fixes

  Patch release with widget behavior fix and improved URL handling.

  * **Fix**: Widget pending state now correctly emulated to reflect ChatGPT behavior
  * **Fix**: Inspector now detects when `server=` query parameter contains a URL that's not already connected and automatically redirects to use `autoConnect=` instead
  * **Update**: Updated mcp-use dependency to v1.16.2
</Update>

<Update label="v0.18.1" description="January 2026">
  ## Dependency Update

  Patch release aligned with mcp-use v1.16.1.

  * **Update**: Updated mcp-use dependency to v1.16.1
</Update>

<Update label="v0.18.0" description="January 2026">
  <Frame>
    <img src="https://mcp-use.com/api/og/release?v=0.18.0&title=Chat%20Prompts%20%26%20Multimodal%20Support&date=2026-01&lang=inspector" alt="Release 0.18.0" />
  </Frame>

  ## Chat Prompts & Multimodal Support

  Minor release introducing prompts in chat and multimodal image support for vision-capable LLMs.

  ### Chat Prompts

  * **New**: Prompts in Chat - type / to open a prompt, run it, and include its result in the thread before sending
  * **Note**: Prompts with arguments are not yet supported in this release

  ### Multimodal Support

  * **New**: Image attachment support in Inspector chat
  * **New**: Upload and send images to vision-capable LLMs (GPT-4o, Claude, Gemini) using the paperclip button
  * **Enhancement**: MCP prompts that return images are now properly displayed instead of showing raw JSON
  * **Enhancement**: Full multimodal support for image content in chat interface

  ### Dependencies

  * **Update**: Updated mcp-use to v1.16.0
</Update>

<Update label="v0.17.3" description="January 2026">
  ## Theme URL Parameter Fix

  Patch release enabling dark mode through URL parameter.

  * **Fix**: Enable dark mode through theme URL parameter
  * **Update**: Aligned with mcp-use v1.15.3
</Update>

<Update label="v0.17.2" description="January 2026">
  ## HMR File Watcher Fix

  Patch release fixing file watcher resource exhaustion in containerized environments.

  * **Fix**: HMR file watcher exhausting inotify limits by properly ignoring node\_modules
  * **Fix**: Prevented ENOSPC errors in containerized environments caused by watching files inside `node_modules/`
  * **Update**: Aligned with mcp-use v1.15.2
</Update>

<Update label="v0.17.1" description="January 2026">
  ## Dependency Update

  Patch release with dependency updates.

  * **Update**: Updated mcp-use to v1.15.1
</Update>

<Update label="v0.17.0" description="January 2026">
  <Frame>
    <img src="https://mcp-use.com/api/og/release?v=0.17.0&title=MCP%20Apps%20Support%20%26%20Landing%20Pages&date=2026-01&lang=inspector" alt="Release 0.17.0" />
  </Frame>

  ## MCP Apps Support & Landing Pages

  Major release introducing MCP Apps support with dual-protocol widget rendering and enhanced inspector capabilities.

  ### MCP Apps Support

  * **New**: Dual-protocol support enabling widgets to work with both MCP Apps and ChatGPT Apps SDK
  * **New**: `MCPAppsRenderer` component for advanced debugging and visualization
  * **New**: `MCPAppsDebugControls` component for widget debugging
  * **New**: Sandboxed iframe support with console logging and safe area insets for isolated widget rendering
  * **New**: Widget adapters (MCP Apps, Apps SDK) with protocol helpers for seamless cross-protocol compatibility

  ### Landing Pages

  * **New**: HTML landing page support for MCP server endpoints
  * **New**: Connection instructions for Claude Code, Cursor, VS Code, VS Code Insiders, and ChatGPT
  * **Enhancement**: Browser host normalization for server connections

  ### Bug Fixes & Security

  * **Fix**: MCP server landing now shows the external URL instead of the internal URL
  * **Fix**: Zod JIT compilation to prevent CSP violations in sandboxed environments
  * **Security**: Fixed vulnerabilities in dependencies

  ### Dependencies

  * **Update**: Updated mcp-use to v1.15.0
</Update>

<Update label="v0.16.2" description="January 2026">
  ## UI Enhancements & Connection Handling

  Patch release with improved UI components, widget security enhancements, and better connection management.

  ### UI Enhancements

  * **Enhancement**: CustomHeadersEditor with improved focus management and title prop support
  * **Enhancement**: Standardized proxy configuration - renamed `customHeaders` to `headers` in InspectorDashboard and ServerConnectionModal for consistency

  ### Widget Security

  * **Enhancement**: Widget security headers with frame domain support
  * **Enhancement**: Added `frame_domains` to widgetCSP interface for iframe embed control
  * **Enhancement**: Updated getWidgetSecurityHeaders to include frame\_domains in CSP for OpenAI compatibility
  * **Enhancement**: CSP handling in OpenAIComponentRenderer prioritizes metadata from tool results and resources

  ### Connection Handling

  * **Enhancement**: Improved server connection handling with new handleReconnect function
  * **Enhancement**: UI elements reflect connection states more accurately with better hover effects and error displays
  * **Enhancement**: Enhanced error handling for unauthorized connections with clearer user feedback
  * **Enhancement**: State management for connecting servers in InspectorDashboard

  ### Dependencies

  * **Update**: Aligned with mcp-use v1.14.2 improvements
</Update>

<Update label="v0.16.1" description="January 2026">
  ## Tool Output Display Fix

  Patch release with tool output display improvement.

  * **Fix**: Inspector tool output now displays at full height for better content visibility
  * **Update**: Aligned with mcp-use v1.14.1
</Update>

<Update label="v0.16.0" description="January 2026">
  <Frame>
    <img src="https://mcp-use.com/api/og/release?v=0.16.0&title=RPC%20Message%20Management%20%26%20LangChain%20Fixes&date=2026-01&lang=inspector" alt="Release 0.16.0" />
  </Frame>

  ## RPC Message Management & LangChain Fixes

  Release with enhanced RPC message handling and critical bug fixes for Anthropic integration.

  ### RPC Message Management

  * **New**: Copy functionality for RPC messages in Prompts, Resources, and Tools tabs
  * **New**: Reusable `RpcPanel` component for consistent RPC message handling across tabs
  * **New**: Export functionality for RPC messages
  * **Enhancement**: Improved panel management with refactored ResizablePanel components

  ### Resource Properties Management

  * **New**: Custom properties support for resources - dynamically configure resource properties
  * **New**: `PropsSelect` component for intuitive property selection and management
  * **New**: `PropsConfigDialog` with AI-powered property suggestions using Claude
  * **New**: `SchemaFormField` component for rendering JSON schema-based forms
  * **New**: `usePropsLLM` hook leveraging Claude for intelligent property suggestions
  * **New**: `useResourceProps` hook for managing resource props state

  ### Inspector Improvements

  * **Enhancement**: Extracted MCP prompts logic into reusable `useMCPPrompts` hook
  * **Enhancement**: Server metadata display with website URLs and icons
  * **Enhancement**: Better tool management - cleared selected tools when removed from list
  * **Enhancement**: Enhanced `JSONDisplay` with improved line wrapping and font size for better readability
  * **Enhancement**: `ToolExecutionPanel` now includes collapsible description section
  * **Enhancement**: Integrated JSON metadata visualization in tool execution panel
  * **Enhancement**: `McpUIRenderer` and `OpenAIComponentRenderer` support `customProps` parameter
  * **Enhancement**: `ResourceResultDisplay` with dynamic property configuration UI
  * **Enhancement**: Enhanced Prism theme support for better code highlighting
  * **Enhancement**: Updated `useMcp` hook to expose `mcpServerUrl` for resource operations

  ### Bug Fixes

  * **Fix**: Resolved Anthropic `tool_use.id` required error with LangChain 1.3.10 update
  * **Fix**: Proper tool\_call ID generation ensuring unique IDs for all tool\_use blocks
  * **Fix**: Improved backward compatibility by checking both 'headers' and 'customHeaders'

  ### Dependencies

  * **Update**: `@langchain/anthropic` to 1.3.10
  * **Update**: `@langchain/core` to 1.1.15
  * **Update**: `langchain` to 1.2.10
  * **Update**: `react-resizable-panels` to 4.4.1
</Update>

<Update label="v0.15.3" description="January 2026">
  ## Dependency Update

  Patch release with dependency updates.

  * **Enhancement**: Updated mcp-use dependency to latest version
</Update>

<Update label="v0.15.2" description="January 2026">
  ## OAuth Proxy URL Handling Improvements

  Patch release with improved OAuth proxy URL handling and connection logic.

  * **Enhancement**: Improved OAuth proxy URL derivation from callback URLs
  * **Enhancement**: Better handling of root path callbacks in OAuth flow
  * **Enhancement**: Clearer separation between OAuth proxy URLs and connection URLs
  * **Fix**: Maintains valid OAuth tokens across sessions by not clearing OAuth storage before connecting
</Update>

<Update label="v0.15.1" description="January 2026">
  ## URL Validation & LocalStorage Enhancements

  Patch release with URL validation improvements and localStorage functionality.

  * **Enhancement**: Automatically prepends "https\://" to URLs without protocol for better user experience
  * **Enhancement**: Improved URL validation logic in InspectorDashboard and ServerConnectionModal
  * **Enhancement**: Added localStorage clearing functionality for MCP-related items to help with troubleshooting
  * **Fix**: Enhanced localStorage checks to verify both existence and functional methods before usage
  * **Fix**: Clear stale OAuth storage before connecting to ensure fresh authentication flow
</Update>

<Update label="v0.15.0" description="January 2026">
  <Frame>
    <img src="https://mcp-use.com/api/og/release?v=0.15.0&title=Chat%20Stop%20Functionality&date=2026-01&lang=inspector" alt="Release 0.15.0" />
  </Frame>

  ## Chat Stop Functionality

  Minor release adding the ability to stop ongoing chat responses in the inspector.

  ### Chat Functionality

  * **New**: Stop functionality for chat responses - users can now abort streaming responses
  * **New**: Export stop function from `useChatMessagesClientSide` hook connected to `abortControllerRef`
  * **New**: `abortControllerRef` added to `useChatMessages` hook for proper abort control
  * **Enhancement**: Stop button connected to abort streaming responses for better user control

  ### UI & Authentication

  * **Enhancement**: Simplified authentication button logic in InspectorDashboard
  * **Enhancement**: Updated multi-server example to link directly to authentication URL
  * **Fix**: Updated dependency `hono` to 4.11.4
</Update>

<Update label="v0.14.6" description="January 2026">
  ## Dependency Update

  Patch release with dependency updates.

  * **Enhancement**: Updated mcp-use dependency to latest version
</Update>

<Update label="v0.14.5" description="January 2026">
  ## OAuth & Metadata Enhancements

  Minor release with OAuth proxy support, metadata caching, and favicon improvements.

  ### OAuth & Client Info

  * **Enhancement**: Enhanced OAuth proxy to support gateway/proxy scenarios (e.g., Supabase MCP servers)
  * **Enhancement**: Client info support with branding displayed on OAuth consent pages
  * **Enhancement**: Server metadata caching for immediate display on reconnect - improves UX by showing server info instantly
  * **Enhancement**: Improved logging middleware for API routes with better debugging visibility
  * **Enhancement**: Enabled OAuth proxy logging for better flow visibility

  ### Favicon Detection

  * **Enhancement**: Enhanced favicon detector to try all subdomain levels (e.g., mcp.supabase.com → supabase.com → com)
  * **Enhancement**: Detection of default vs custom favicons using JSON API response
  * **Enhancement**: Prefer non-default favicons when available

  ### Bug Fixes

  * **Fix**: Remove import from "mcp-use" which causes langchain import in server
  * **Enhancement**: Enhanced synchronization for tools, prompts, and resources during HMR
</Update>

<Update label="v0.14.4" description="January 2026">
  ## Connection Fix

  Patch release fixing autoconnect configuration parsing.

  * **Fix**: Autoconnect now correctly parses config objects in addition to string URLs
</Update>

<Update label="v0.14.3" description="January 2026">
  ## Security Fixes & OAuth Improvements

  Patch release addressing multiple security vulnerabilities and fixing OAuth flow issues.

  ### Security Fixes

  * **Security**: Fixed 13 vulnerabilities (3 moderate, 10 high)
  * **Security**: Updated `langchain` to 1.2.3 (fixes serialization injection vulnerability)
  * **Security**: Updated `@langchain/core` to 1.1.8 (fixes serialization injection vulnerability)
  * **Security**: Updated `react-router` to 7.12.0 (fixes XSS and CSRF vulnerabilities)
  * **Security**: Added overrides for `qs` and `preact` vulnerabilities

  ### OAuth & Connection Improvements

  * **Fix**: Resolved OAuth flow looping issue by removing duplicate fallback logic
  * **Enhancement**: Simplified connection handling with consolidated state management
  * **Enhancement**: Enhanced OAuth authentication flow with improved connection settings
  * **Enhancement**: Improved auto-connect functionality with better proxy handling and error management
  * **Enhancement**: Enhanced theme toggling with dropdown menu for better UX and accessibility
  * **Enhancement**: Updated OAuth flow management in browser provider and callback handling
</Update>

<Update label="v0.14.2" description="January 2026">
  <Frame>
    <img src="https://mcp-use.com/api/og/release?v=0.14.2&title=Automatic%20Proxy%20Fallback%20%26%20Reconnect&date=2026-01&lang=inspector" alt="Release 0.14.2" />
  </Frame>

  ## Automatic Proxy Fallback & Reconnect

  Minor release with automatic proxy fallback, OAuth proxy support, and reconnect functionality.

  ### Breaking Changes (with Deprecation Warnings)

  * **Breaking**: Renamed `customHeaders` to `headers` across all APIs. Old name still works but shows deprecation warnings.
  * **Breaking**: Renamed `samplingCallback` to `onSampling` for consistency. Old name still works but shows deprecation warnings.

  ### New Features

  * **New**: Reconnect functionality for failed connections - reconnect button in InspectorDashboard UI
  * **New**: Reconnect option in dropdown menu for failed connections
  * **New**: Configurable clientInfo support for MCP connection initialization with full metadata
  * **New**: Automatic Proxy Fallback - automatically retries failed connections through proxy
  * **New**: OAuth Proxy Support with oauthProxyUrl configuration

  ### Improvements

  * **Enhancement**: Better detection of OAuth discovery failures, CORS errors, and connection issues
  * **Enhancement**: OAuth provider uses original target URL for discovery, not proxy URL
  * **Enhancement**: HttpConnector automatic reconnection disabled, shifting responsibility to higher-level logic for better control

  ### Bug Fixes

  * **Fix**: Custom headers now correctly included when copying connection configuration from saved tiles
  * **Fix**: Headers correctly read from localStorage where stored in proxyConfig.customHeaders
</Update>

<Update label="v0.14.1" description="January 2026">
  ## Security Update

  Patch release with security fixes and build improvements.

  * **Security**: Updated `@modelcontextprotocol/sdk` to 1.25.2 (fixes ReDoS vulnerability in UriTemplate regex patterns)
  * **Fix**: Updated building script to correctly export types for inspector/client components
</Update>

<Update label="v0.14.0" description="January 2026">
  ## Multi-Server Support & Browser Compatibility

  Release with multi-server management, improved UI responsiveness, and enhanced browser compatibility.

  ### Breaking Changes

  * **Breaking**: Removed `winston` dependency. The logging system now uses a simple console logger that works in both browser and Node.js environments.

  ### Multi-Server Support

  * **New**: Multi-server management with `McpClientProvider` to manage multiple MCP server connections
  * **New**: Dynamic addition and removal of servers in React applications
  * **New**: Pluggable storage system with `LocalStorageProvider` and `MemoryStorageProvider` for flexible server configuration persistence
  * **Enhancement**: Refactored `useMcp` hook for better multi-server support
  * **Enhancement**: Removed obsolete `McpContext` (replaced with `McpClientProvider`)

  ### UI & UX Improvements

  * **Enhancement**: Improved UI responsiveness with enhanced mobile and tablet layouts and adaptive component visibility
  * **Enhancement**: Better server management with refactored server connection handling, improved icon display, and status tracking
  * **Enhancement**: Enhanced debugging with detailed logging in Layout and useAutoConnect components for better monitoring of server connection states
  * **Enhancement**: Simplified connection settings by removing deprecated transport types
  * **Enhancement**: Improved server icon support and component interactions
  * **Enhancement**: Added embedded mode support
  * **New**: Support for passing tab as query parameter for direct navigation
  * **New**: Prompt rendering support with enhanced display
  * **New**: Add to Client dropdown for quickly adding MCP servers to Cursor, VS Code, Claude Desktop, and CLI tools

  ### Browser Compatibility

  * **Enhancement**: Enhanced inspector components for better browser compatibility
  * **Enhancement**: Better configuration handling and MCP proxy integration
  * **Enhancement**: Improved browser-based MCP client with better connection handling

  ### Bug Fixes

  * **Fix**: Query URL handling in built mode now preserves arguments correctly
  * **Fix**: Server connection retrieval in `OpenAIComponentRenderer` to directly access connections array
  * **Fix**: Add client SDKs to add to client dropdown
  * **Fix**: Respect query tab parameter when existing server is already connected
</Update>

<Update label="v0.13.2" description="December 2025">
  ## Documentation Updates - **Enhancement**: Updated examples and documentation

  to use preferred methods and APIs
</Update>

<Update label="v0.13.1" description="December 2025">
  ## Bug Fixes - **Fix**: Widget props not picked up when using Zod schemas
</Update>

<Update label="v0.13.0" description="December 2025">
  ## Session Management & Architecture Improvements

  Release aligned with mcp-use v1.11.0, featuring session management architecture and improved inspector capabilities.

  ### Breaking Changes

  * **Breaking**: WebSocket transport support removed. Use streamable HTTP or SSE transports instead.
  * **Breaking**: LangChain adapter moved from main entry point to `mcp-use/adapters` subpath.

  ### Session Management

  * **Enhancement**: Support for pluggable session management architecture with Redis support
  * **Enhancement**: Improved session persistence and connection handling
  * **Enhancement**: Better support for distributed deployments with cross-server notifications

  ### Inspector Features

  * **Enhancement**: Enhanced connection handling with automatic 404 handling and re-initialization
  * **Enhancement**: Improved tool, resource, and prompt management
  * **Enhancement**: Better integration with session management architecture
  * **Enhancement**: Enhanced debugging capabilities with better error handling

  ### Widget Support

  * **Enhancement**: Improved widget rendering and debugging for ChatGPT Apps
  * **Enhancement**: Better widget data handling and state management
  * **Enhancement**: Enhanced OpenAI component renderer with improved functionality

  ### UI Improvements

  * **Enhancement**: Better connection settings UI
  * **Enhancement**: Improved server management interface
  * **Enhancement**: Enhanced tool result display and formatting
</Update>

<Update label="v0.12.6" description="December 2025">
  ## Dependency Updates - **Enhancement**: Updated dependencies
</Update>

<Update label="v0.12.5" description="December 2025">
  ## Dependency Updates - **Enhancement**: Updated dependencies
</Update>

<Update label="v0.12.4" description="December 2025">
  ## Dependency Updates - **Enhancement**: Updated dependencies
</Update>

<Update label="v0.12.3" description="December 2025">
  ## Bug Fixes - **Fix**: Deno 3 compatibility fixes
</Update>

<Update label="v0.12.2" description="December 2025">
  ## Bug Fixes - **Fix**: Updated Zod error handling
</Update>

<Update label="v0.12.1" description="December 2025">
  ## Bug Fixes - **Fix**: Zod import in official SDK - **Enhancement**: Added

  repository metadata in package.json
</Update>

<Update label="v0.12.0" description="December 2025">
  ## Elicitation Support & API Improvements

  Release aligned with mcp-use v1.10.0, featuring elicitation support and enhanced inspector capabilities.

  ### Breaking Changes

  * **Breaking**: Server API renamed `createMCPServer()` factory function to `MCPServer` class constructor
  * **Breaking**: Session API replaced `session.connector.tools`, `session.connector.callTool()`, etc. with direct methods: `session.tools`, `session.callTool()`, etc.
  * **Breaking**: OAuth environment variables standardized to `MCP_USE_OAUTH_*` prefix

  ### New Features

  * **New**: Elicitation support in inspector - servers can request user input through clients
  * **New**: Client Capabilities API with `ctx.client.can()` and `ctx.client.capabilities()`
  * **New**: Session Notifications API with `ctx.sendNotification()` and `ctx.sendNotificationToSession()`
  * **New**: Session Info API with `ctx.session.sessionId` to access current session ID
  * **New**: Resource Template Flat Structure support with `uriTemplate` directly on definition
  * **New**: Resource Template Callback Signatures supporting multiple signatures

  ### Improvements

  * **Enhancement**: Enhanced type inference for resource template callbacks
  * **Enhancement**: Client capabilities tracking during initialization
  * **Enhancement**: Major documentation refactoring and restructuring
  * **Enhancement**: Edge runtime support improvements
  * **Enhancement**: Transport bug fixes
</Update>

<Update label="v0.11.0" description="December 2025">
  ## Elicitation Support - **New**: Added support for elicitation in inspector,

  enabling servers to request user input through clients - **Fix**: Transport
  bug fixes
</Update>

<Update label="v0.10.1" description="November 2025">
  ## Dependency Updates - **Enhancement**: Updated dependencies
</Update>

<Update label="v0.10.0" description="November 2025">
  ## Sampling Support - **New**: Added sampling support in inspector with LLM

  sampling capabilities - **Fix**: Long running sampling requests no longer
  timeout after 60 seconds - **Enhancement**: Better handling of extended
  sampling operations
</Update>

<Update label="v0.9.2" description="November 2025">
  ## Dependency Updates - **Enhancement**: Updated dependencies
</Update>

<Update label="v0.9.1" description="November 2025">
  ## Bug Fixes - **Fix**: Fixed bin entry issue for pnpm installation -

  **Enhancement**: Standardized import statement formatting across multiple
  files
</Update>

<Update label="v0.9.0" description="November 2025">
  ## OAuth Authentication System

  Release with complete OAuth 2.0 support and enhanced inspector capabilities.

  ### New Features

  * **New**: Complete OAuth 2.0 authentication framework with built-in providers (Auth0, WorkOS, Supabase, Keycloak)
  * **New**: OAuth middleware and routes for server-side OAuth flow handling
  * **New**: OAuth callback component in inspector for authentication flows
  * **New**: Context storage with async local storage for request-scoped context
  * **New**: Response helpers for standardized HTTP responses and error handling
  * **New**: Runtime detection utilities for Node.js, Bun, and Deno environments

  ### Inspector Enhancements

  * **Enhancement**: Enhanced useMcp hook with improved connection management and OAuth support
  * **Enhancement**: Enhanced inspector dashboard with OAuth configuration UI
  * **Enhancement**: Better authentication flow handling with OAuth integration
  * **Enhancement**: Improved auto-connect with enhanced connection recovery
  * **Enhancement**: Enhanced HTTP connectors with OAuth token handling

  ### UI Improvements

  * **Fix**: Fixed scrolls in tools, resources, and prompts tab
  * **Fix**: Fixed models and API keys box in inspector chat
  * **Fix**: Fixed rendering of table, inline-code, code and images in inspector chat
  * **Fix**: Fixed padding of RPC panels
  * **New**: Added enum input display for tools
  * **Enhancement**: Bundle minification (9.7mb → 4.2 mb)

  ### Bug Fixes

  * **Fix**: Switched to fork SDK to fix Zod errors on Deno runtime
  * **Fix**: Optimized dependencies
</Update>

<Update label="v0.8.3" description="October 2025">
  ## Dependency Updates - **Enhancement**: Updated dependencies
</Update>

<Update label="v0.8.2" description="October 2025">
  ## Dependency Updates - **Enhancement**: Updated dependencies
</Update>

<Update label="v0.8.1" description="October 2025">
  ## Bug Fixes - **Fix**: Fixed auto-connect proxy fallback behavior - **Fix**:

  Fixed connection config updates not applying when connection already exists -
  **Enhancement**: Auto-switch (proxy fallback) now automatically enabled during
  auto-connect flow - **Enhancement**: Improved error messages for connection
  failures
</Update>

<Update label="v0.8.0" description="October 2025">
  ## Notifications, Sampling & OpenAI Apps SDK Integration

  Release with bidirectional notifications, LLM sampling, and comprehensive OpenAI Apps SDK support.

  ### New Features

  * **New**: Bidirectional notification support between clients and servers
  * **New**: LLM sampling capabilities allowing MCP tools to request completions from connected clients
  * **New**: Widget build ID support for cache busting in widget UI resources
  * **New**: Inspector notifications tab with real-time display
  * **New**: Server capabilities modal showing supported MCP features
  * **New**: RPC message logging support in inspector

  ### OpenAI Apps SDK Integration

  * **New**: McpUseProvider component combining React setup (StrictMode, ThemeProvider, BrowserRouter, ErrorBoundary)
  * **New**: WidgetControls component with debug overlay and view controls (fullscreen, PIP)
  * **New**: useWidget hook for type-safe React adapter to OpenAI Apps SDK API
  * **New**: ErrorBoundary component for graceful error handling
  * **New**: Image component handling data URLs and public file paths
  * **New**: ThemeProvider for consistent theme management
  * **New**: WidgetInspectorControls for inspector-specific debugging
  * **New**: Console proxy toggle for iframe console logs
  * **New**: Product search result widget template with carousel and accordion components
  * **New**: Folder-based widget support with automatic detection
  * **New**: Public folder support for static assets

  ### Inspector Enhancements

  * **Enhancement**: Enhanced OpenAIComponentRenderer with better height calculation and theme support
  * **Enhancement**: Enhanced ToolResultDisplay with multiple content types (text, image, audio, resource links)
  * **Enhancement**: Resizable panels with collapse support
  * **Enhancement**: Better widget security headers and CSP configuration
  * **Enhancement**: Enhanced widget data handling and state management

  ### Improvements

  * **Enhancement**: Refactored HTTP transport to reuse sessions across requests
  * **Enhancement**: Session management with tracking and automatic cleanup
  * **Enhancement**: Roots support in connectors and session API
  * **Enhancement**: Enhanced search\_tools with metadata
  * **Enhancement**: Improved SSR configuration with proper Vite settings

  ### Bug Fixes

  * **Fix**: Fixed iframe height calculation issues
  * **Fix**: Fixed theme flashing on widget load
  * **Fix**: Fixed CSP header generation for dev mode
  * **Fix**: Fixed asset loading in dev widget proxy
  * **Fix**: Fixed console logging in iframe
  * **Fix**: Fixed widget state inspection
  * **Fix**: Fixed resizable panel collapse behavior
</Update>

<Update label="v0.7.1" description="October 2025">
  ## Bug Fixes & Improvements - **Fix**: Fixed auto-connect proxy fallback

  behavior - **Fix**: Fixed connection config updates not applying when
  connection already exists - **Enhancement**: Auto-switch (proxy fallback) now
  automatically enabled during auto-connect flow - **Enhancement**: Improved
  error messages for connection failures
</Update>

<Update label="v0.7.0" description="October 2025">
  ## Code Mode Support - **New**: Code Mode feature allowing agents to execute

  code using MCP tools - **Enhancement**: Enhanced MCPClient with code execution
  configuration - **Enhancement**: Comprehensive tests for code execution
  functionality
</Update>

<Update label="v0.6.1" description="October 2025">
  ## Bug Fixes - **Fix**: Various bug fixes and improvements
</Update>

<Update label="v0.6.0" description="October 2025">
  ## Edge Runtime Support - **Major**: Migrated to Hono framework for edge

  runtime support - **New**: Runtime detection for Deno and Node.js environments

  * **New**: Enhanced inspector dashboard with improved connection handling -
    **Enhancement**: Better auto-connection logic with error handling and retry
    mechanisms
</Update>

<Update label="v0.5.3" description="October 2025">
  ## Bug Fixes & Improvements - **Fix**: Various bug fixes and stability

  improvements - **Enhancement**: Dependency updates
</Update>

<Update label="v0.5.2" description="October 2025">
  ## Bug Fixes & Improvements - **Fix**: Various bug fixes and stability

  improvements - **Enhancement**: Dependency updates
</Update>

<Update label="v0.5.1" description="October 2025">
  ## Bug Fixes - **Fix**: Various bug fixes and improvements
</Update>

<Update label="v0.5.0" description="October 2025">
  ## LangChain 1.0.0 Support - **Major**: Support for LangChain 1.0.0 - **Fix**:

  Model type compatibility for LangChain 1.0.0 - **Enhancement**: Set CLI and
  inspector as dependencies
</Update>

<Update label="v0.4.13" description="October 2025">
  ## Dependency Updates - **Enhancement**: Updated dependencies
</Update>

<Update label="v0.4.12" description="October 2025">
  ## Dependency Updates - **Enhancement**: Updated dependencies
</Update>

<Update label="v0.4.11" description="October 2025">
  ## Dependency Updates - **Enhancement**: Updated dependencies
</Update>

<Update label="v0.4.10" description="October 2025">
  ## Dependency Updates - **Enhancement**: Updated dependencies
</Update>

<Update label="v0.4.9" description="October 2025">
  ## Dependency Updates - **Enhancement**: Updated dependencies
</Update>

<Update label="v0.4.8" description="October 2025">
  ## Dependency Updates - **Enhancement**: Updated dependencies
</Update>

<Update label="v0.4.7" description="October 2025">
  ## Dependency Updates - **Enhancement**: Updated dependencies
</Update>

<Update label="v0.4.6" description="October 2025">
  ## Dependency Updates - **Enhancement**: Updated dependencies
</Update>

<Update label="v0.4.5" description="October 2025">
  ## Bug Fixes - **Fix**: Fixed inspector chat formatting
</Update>

<Update label="v0.4.4" description="October 2025">
  ## Bug Fixes - **Fix**: Fixed inspector chat - **Fix**: Fixed inspector shadow
</Update>

<Update label="v0.4.3" description="October 2025">
  ## Major Refactoring & Apps SDK Support

  Major refactoring with improved architecture and enhanced Apps SDK support.

  ### Major Refactoring

  * **Refactor**: Server architecture refactored with major improvements to routing and middleware
  * **Refactor**: Removed legacy `mcp-inspector.ts` file in favor of modular architecture
  * **Refactor**: Added new `cli.ts` for improved command-line interface handling
  * **Refactor**: Added `utils.ts` and `shared-utils-browser.ts` for better code organization
  * **Refactor**: Enhanced `shared-routes.ts` with improved route handling and error management

  ### Apps SDK Support

  * **Enhancement**: Enhanced widget data handling and state management
  * **New**: Added `readResource` method in MCPInspector for fetching resources based on server ID
  * **Enhancement**: Enhanced OpenAI component renderer to utilize serverId and readResource
  * **Enhancement**: Improved safe data serialization for widget state management

  ### UI/UX Improvements

  * **Enhancement**: Enhanced ConnectionSettingsForm with copy configuration feature
  * **Enhancement**: Updated OpenAIComponentRenderer to dynamically adjust iframe height
  * **Enhancement**: Improved resource display with duration metrics and enhanced badge styling
  * **Enhancement**: Enhanced LayoutHeader with dynamic badge styling
  * **Fix**: Fixed scrollable tool parameters for better user experience
  * **Enhancement**: Added mobile-responsive hiding features

  ### Bug Fixes

  * **Fix**: Fixed inspector mounting logic by simplifying server URL handling
  * **Fix**: Fixed linting issues across multiple components
  * **Fix**: Fixed server configuration for improved stability
</Update>

<Update label="v0.4.2" description="October 2025">
  ## Auto-Connection & Multi-Server Support - **New**: Auto-connection

  functionality - inspector now automatically connects to MCP servers on startup

  * **New**: Multi-server support - enhanced support for connecting to multiple
    MCP servers simultaneously - **New**: Client-side chat functionality with
    improved message handling - **New**: Resource handling with enhanced chat
    components - **Enhancement**: Streamlined routing with refactored server and
    client routing - **Enhancement**: Enhanced connection handling with improved
    auto-connection logic - **Enhancement**: Better UI components with updated
    Layout, ChatTab, and ToolsTab components - **Fix**: Fixed connection handling
    in InspectorDashboard - **Fix**: Improved error messages in useMcp hook
</Update>

<Update label="v0.4.1" description="October 2025">
  ## Bug Fixes - **Fix**: Minor fixes and improvements
</Update>

<Update label="v0.4.0" description="October 2025">
  ## Major Refactor & Apps SDK Initial Integration

  Major refactor aligning inspector with mcp-use TypeScript package and initial Apps SDK integration.

  ### Major Refactoring

  * **Refactor**: Migrated from CommonJS to ESM format
  * **Refactor**: Added input validation for port and URL
  * **Refactor**: Improved error handling and logging
  * **Refactor**: Added `open` package for cross-platform browser launching
  * **Refactor**: Reorganized component structure (moved to `src/client/components/`)
  * **Refactor**: Refactored ChatTab to use streaming API and custom hooks
  * **Refactor**: Enhanced InspectorDashboard with auto-connect functionality
  * **Refactor**: Improved CommandPalette with better item selection
  * **Refactor**: Updated routing to use query parameters

  ### New Components

  * **New**: Chat components: `AssistantMessage`, `UserMessage`, `ToolCallDisplay`, `MCPUIResource`, `MessageList`
  * **New**: UI components: `aurora-background`, `text-shimmer`, `sheet`, `switch`, `kbd`, `shimmer-button`, `status-dot`
  * **New**: Form components: `ConnectionSettingsForm`, `ServerDropdown`
  * **New**: Tool components: `ToolExecutionPanel`, `ToolResultDisplay`, `SaveRequestDialog`
  * **New**: Resource components: `ResourceResultDisplay`, `ResourcesList`

  ### Apps SDK Integration

  * **New**: OpenAI Apps SDK integration with UI resource type
  * **New**: Enhanced MCP-UI adapter for Apps SDK metadata
  * **New**: Resource URI format supporting `ui://widget/` scheme

  ### Bug Fixes

  * **Fix**: Fixed CLI binary format and package configuration
  * **Fix**: Changed CLI build format from CommonJS to ESM
  * **Fix**: Added input validation for port and URL arguments
  * **Fix**: Improved error logging in API routes
  * **Fix**: Fixed async/await bugs in static file serving
</Update>