Module @modelcontextprotocol/ext-apps/react

React utilities for building MCP Apps.

This module provides React hooks and utilities for easily building interactive MCP Apps using React. This is optional - the core SDK (App, PostMessageTransport) is framework-agnostic and can be used with any UI framework or vanilla JavaScript.

Main Exports

useApp - React hook to create and connect an MCP App
useAutoResize - React hook for manual auto-resize control (rarely needed)

Example: Basic React App

import { useApp } from '@modelcontextprotocol/ext-apps/react';

function MyApp() {
  const { app, isConnected, error } = useApp({
    appInfo: { name: "MyApp", version: "1.0.0" },
    capabilities: {}
  });

  if (error) return <div>Error: {error.message}</div>;
  if (!isConnected) return <div>Connecting...</div>;

  return <div>Connected!</div>;
}

Interfaces

AppState
UseAppOptions

Functions

useApp
useAutoResize

References

App → App
LATEST_PROTOCOL_VERSION → LATEST_PROTOCOL_VERSION
McpUiAppCapabilities → McpUiAppCapabilities
McpUiAppCapabilitiesSchema → McpUiAppCapabilitiesSchema
McpUiHostCapabilities → McpUiHostCapabilities
McpUiHostCapabilitiesSchema → McpUiHostCapabilitiesSchema
McpUiHostContext → McpUiHostContext
McpUiHostContextChangedNotification → McpUiHostContextChangedNotification
McpUiHostContextChangedNotificationSchema → McpUiHostContextChangedNotificationSchema
McpUiHostContextSchema → McpUiHostContextSchema
McpUiInitializedNotification → McpUiInitializedNotification
McpUiInitializedNotificationSchema → McpUiInitializedNotificationSchema
McpUiInitializeRequest → McpUiInitializeRequest
McpUiInitializeRequestSchema → McpUiInitializeRequestSchema
McpUiInitializeResult → McpUiInitializeResult
McpUiInitializeResultSchema → McpUiInitializeResultSchema
McpUiMessageRequest → McpUiMessageRequest
McpUiMessageRequestSchema → McpUiMessageRequestSchema
McpUiMessageResult → McpUiMessageResult
McpUiMessageResultSchema → McpUiMessageResultSchema
McpUiOpenLinkRequest → McpUiOpenLinkRequest
McpUiOpenLinkRequestSchema → McpUiOpenLinkRequestSchema
McpUiOpenLinkResult → McpUiOpenLinkResult
McpUiOpenLinkResultSchema → McpUiOpenLinkResultSchema
McpUiResourceTeardownRequest → McpUiResourceTeardownRequest
McpUiResourceTeardownRequestSchema → McpUiResourceTeardownRequestSchema
McpUiResourceTeardownResult → McpUiResourceTeardownResult
McpUiResourceTeardownResultSchema → McpUiResourceTeardownResultSchema
McpUiSandboxProxyReadyNotification → McpUiSandboxProxyReadyNotification
McpUiSandboxProxyReadyNotificationSchema → McpUiSandboxProxyReadyNotificationSchema
McpUiSandboxResourceReadyNotification → McpUiSandboxResourceReadyNotification
McpUiSandboxResourceReadyNotificationSchema → McpUiSandboxResourceReadyNotificationSchema
McpUiSizeChangeNotification → McpUiSizeChangeNotification
McpUiSizeChangeNotificationSchema → McpUiSizeChangeNotificationSchema
McpUiToolInputNotification → McpUiToolInputNotification
McpUiToolInputNotificationSchema → McpUiToolInputNotificationSchema
McpUiToolInputPartialNotification → McpUiToolInputPartialNotification
McpUiToolInputPartialNotificationSchema → McpUiToolInputPartialNotificationSchema
McpUiToolResultNotification → McpUiToolResultNotification
McpUiToolResultNotificationSchema → McpUiToolResultNotificationSchema
PostMessageTransport → PostMessageTransport
RESOURCE_URI_META_KEY → RESOURCE_URI_META_KEY