@modelcontextprotocol/ext-apps - v0.3.1

@modelcontextprotocol/ext-apps

This repo contains the SDK and specification for MCP Apps Extension (SEP-1865).

MCP Apps are a proposed standard inspired by MCP-UI and OpenAI's Apps SDK to allow MCP Servers to display interactive UI elements in conversational MCP clients / chatbots.

Overview

This SDK serves two audiences:

App Developers

Build interactive UIs that run inside MCP-enabled chat clients.

SDK for Apps: @modelcontextprotocol/ext-apps — API Docs
React hooks: @modelcontextprotocol/ext-apps/react — API Docs

Host Developers

Embed and communicate with MCP Apps in your chat application.

SDK for Hosts: @modelcontextprotocol/ext-apps/app-bridge — API Docs

There's no supported host implementation in this repo (beyond the examples/basic-host example).

We have contributed a tentative implementation of hosting / iframing / sandboxing logic to the MCP-UI repository, and expect OSS clients may use it, while other clients might roll their own hosting logic.

Installation

npm install -S @modelcontextprotocol/ext-apps

Or edit your package.json manually:

{
  "dependencies": {
    "@modelcontextprotocol/ext-apps": "^0.0.1"
  }
}

Examples

Start with these foundational examples to learn the SDK:

examples/basic-server-vanillajs — MCP server + MCP App using vanilla JS
examples/basic-server-react — MCP server + MCP App using React
examples/basic-server-vue — MCP server + MCP App using Vue
examples/basic-server-svelte — MCP server + MCP App using Svelte
examples/basic-server-preact — MCP server + MCP App using Preact
examples/basic-server-solid — MCP server + MCP App using Solid
examples/basic-host — MCP host application supporting MCP Apps

The examples/ directory contains additional demo apps showcasing real-world use cases.

To run all examples together:

npm install
npm start

Then open http://localhost:8080/.