@modelcontextprotocol/ext-apps 1.1.0 → 1.1.2

package/README.md

@@ -4,7 +4,7 @@
   <img src="media/mcp-white.svg#gh-dark-mode-only" alt="MCP Apps" width="128">
   <h1>MCP Apps</h1>
   <p>
-    Build interactive UIs for MCP tools — charts, forms, dashboards — that render inline in any compliant chat client.
+    Build interactive UIs for MCP tools — charts, forms, dashboards — that render inline in Claude, ChatGPT and any other compliant chat client.
     <br /><br />
     <a href="#why-mcp-apps">Why</a>
     ·
@@ -80,12 +80,12 @@ it will guide you through the rest.
 ## Supported Clients
 
 <p align="center">
-  <a href="https://claude.ai"><img src="https://img.shields.io/badge/Claude-web-d97706?logo=claude&logoColor=white" alt="Claude"></a>
-  <a href="https://claude.ai/download"><img src="https://img.shields.io/badge/Claude_Desktop-app-d97706?logo=claude&logoColor=white" alt="Claude Desktop"></a>
-  <a href="https://code.visualstudio.com/insiders"><img src="https://img.shields.io/badge/VS_Code-Insiders-007ACC?logo=visualstudiocode&logoColor=white" alt="VS Code Insiders"></a>
-  <a href="https://block.github.io/goose/"><img src="https://img.shields.io/badge/Goose-Block-000000?logo=goose&logoColor=white" alt="Goose"></a>
-  <a href="https://postman.com"><img src="https://img.shields.io/badge/Postman-client-FF6C37?logo=postman&logoColor=white" alt="Postman"></a>
-  <a href="https://www.mcpjam.com/"><img src="https://img.shields.io/badge/MCPJam-client-8B5CF6" alt="MCPJam"></a>
+  <a href="https://developers.openai.com/apps-sdk/mcp-apps-in-chatgpt/"><img src="https://img.shields.io/badge/ChatGPT-docs-74aa9c?logo=openai&logoColor=white" alt="ChatGPT"></a>
+  <a href="https://claude.com/docs/connectors/building/mcp-apps/getting-started"><img src="https://img.shields.io/badge/Claude-docs-d97706?logo=claude&logoColor=white" alt="Claude"></a>
+  <a href="https://code.visualstudio.com/blogs/2026/01/26/mcp-apps-support"><img src="https://img.shields.io/badge/VS_Code-docs-007ACC?logo=visualstudiocode&logoColor=white" alt="VS Code"></a>
+  <a href="https://block.github.io/goose/docs/tutorials/building-mcp-apps/"><img src="https://img.shields.io/badge/Goose-docs-000000?logo=goose&logoColor=white" alt="Goose"></a>
+  <a href="https://learning.postman.com/docs/postman-ai/mcp-requests/interact"><img src="https://img.shields.io/badge/Postman-docs-FF6C37?logo=postman&logoColor=white" alt="Postman"></a>
+  <a href="https://www.mcpjam.com/blog/mcp-apps-example"><img src="https://img.shields.io/badge/MCPJam-docs-8B5CF6" alt="MCPJam"></a>
 </p>
 
 > [!NOTE]
@@ -97,7 +97,7 @@ it will guide you through the rest.
 ## Why MCP Apps?
 
 MCP tools return text and structured data. That works for many cases, but not
-when you need an interactive UI, like a chart, form, or video player.
+when you need an interactive UI, like a chart, form, design canvas or video player.
 
 MCP Apps provide a standardized way to deliver interactive UIs from MCP servers.
 Your UI renders inline in the conversation, in context, in any compliant host.

package/dist/src/app-bridge.d.ts

@@ -2,7 +2,7 @@ import { Client } from "@modelcontextprotocol/sdk/client/index.js";
 import { Transport } from "@modelcontextprotocol/sdk/shared/transport.js";
 import { CallToolRequest, CallToolResult, EmptyResult, Implementation, ListPromptsRequest, ListPromptsResult, ListResourcesRequest, ListResourcesResult, ListResourceTemplatesRequest, ListResourceTemplatesResult, LoggingMessageNotification, PingRequest, PromptListChangedNotification, ReadResourceRequest, ReadResourceResult, ResourceListChangedNotification, Tool, ToolListChangedNotification } from "@modelcontextprotocol/sdk/types.js";
 import { Protocol, ProtocolOptions, RequestOptions } from "@modelcontextprotocol/sdk/shared/protocol.js";
-import { type AppNotification, type AppRequest, type AppResult, type McpUiSandboxResourceReadyNotification, type McpUiSizeChangedNotification, type McpUiToolCancelledNotification, type McpUiToolInputNotification, type McpUiToolInputPartialNotification, type McpUiToolResultNotification, McpUiAppCapabilities, McpUiUpdateModelContextRequest, McpUiHostCapabilities, McpUiHostContext, McpUiHostContextChangedNotification, McpUiInitializedNotification, McpUiMessageRequest, McpUiMessageResult, McpUiOpenLinkRequest, McpUiOpenLinkResult, McpUiResourceTeardownRequest, McpUiSandboxProxyReadyNotification, McpUiRequestDisplayModeRequest, McpUiRequestDisplayModeResult, McpUiResourcePermissions } from "./types";
+import { type AppNotification, type AppRequest, type AppResult, type McpUiSandboxResourceReadyNotification, type McpUiSizeChangedNotification, type McpUiToolCancelledNotification, type McpUiToolInputNotification, type McpUiToolInputPartialNotification, type McpUiToolResultNotification, McpUiAppCapabilities, McpUiUpdateModelContextRequest, McpUiHostCapabilities, McpUiHostContext, McpUiHostContextChangedNotification, McpUiInitializedNotification, McpUiMessageRequest, McpUiMessageResult, McpUiOpenLinkRequest, McpUiOpenLinkResult, McpUiDownloadFileRequest, McpUiDownloadFileResult, McpUiResourceTeardownRequest, McpUiSandboxProxyReadyNotification, McpUiRequestDisplayModeRequest, McpUiRequestDisplayModeResult, McpUiResourcePermissions } from "./types";
 export * from "./types";
 export { RESOURCE_URI_META_KEY, RESOURCE_MIME_TYPE } from "./app";
 export { PostMessageTransport } from "./message-transport";
@@ -404,6 +404,49 @@ export declare class AppBridge extends Protocol<AppRequest, AppNotification, App
      * @see {@link McpUiOpenLinkResult `McpUiOpenLinkResult`} for the result type
      */
     set onopenlink(callback: (params: McpUiOpenLinkRequest["params"], extra: RequestHandlerExtra) => Promise<McpUiOpenLinkResult>);
+    /**
+     * Register a handler for file download requests from the View.
+     *
+     * The View sends `ui/download-file` requests when the user wants to
+     * download a file. The params contain an array of MCP resource content
+     * items — either `EmbeddedResource` (inline data) or `ResourceLink`
+     * (URI the host can fetch). The host should show a confirmation dialog
+     * and then trigger the download.
+     *
+     * @param callback - Handler that receives download params and returns a result
+     *   - `params.contents` - Array of `EmbeddedResource` or `ResourceLink` items
+     *   - `extra` - Request metadata (abort signal, session info)
+     *   - Returns: `Promise<McpUiDownloadFileResult>` with optional `isError` flag
+     *
+     * @example
+     * ```ts
+     * bridge.ondownloadfile = async ({ contents }, extra) => {
+     *   for (const item of contents) {
+     *     if (item.type === "resource") {
+     *       // EmbeddedResource — inline content
+     *       const res = item.resource;
+     *       const blob = res.blob
+     *         ? new Blob([Uint8Array.from(atob(res.blob), c => c.charCodeAt(0))], { type: res.mimeType })
+     *         : new Blob([res.text ?? ""], { type: res.mimeType });
+     *       const url = URL.createObjectURL(blob);
+     *       const link = document.createElement("a");
+     *       link.href = url;
+     *       link.download = res.uri.split("/").pop() ?? "download";
+     *       link.click();
+     *       URL.revokeObjectURL(url);
+     *     } else if (item.type === "resource_link") {
+     *       // ResourceLink — host fetches or opens directly
+     *       window.open(item.uri, "_blank");
+     *     }
+     *   }
+     *   return {};
+     * };
+     * ```
+     *
+     * @see {@link McpUiDownloadFileRequest `McpUiDownloadFileRequest`} for the request type
+     * @see {@link McpUiDownloadFileResult `McpUiDownloadFileResult`} for the result type
+     */
+    set ondownloadfile(callback: (params: McpUiDownloadFileRequest["params"], extra: RequestHandlerExtra) => Promise<McpUiDownloadFileResult>);
     /**
      * Register a handler for display mode change requests from the view.
      *