modelcontextprotocol/ext-apps
Watch
1
0
Fork
You've already forked ext-apps
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Mirror of https://github.com/modelcontextprotocol/ext-apps — Official repo for spec & SDK of MCP Apps protocol - standard for UIs embedded AI chatbots, served by MCP servers
185 commits 1 branch 37 tags 25 MiB
  • TypeScript 76.4%
  • MDX 19.3%
  • JavaScript 4.3%
Find a file
Exact
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Olivier Chafik 9d21d8bc08
 release: 0.0.6 (#112) 
* release: fix NPM_SECRET reference

* release: 0.0.5

* Add repository field to package.json

Required for npm provenance verification to link the package
to the GitHub repository.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* release: 0.0.6

---------

Co-authored-by: Claude <noreply@anthropic.com>
2025-12-09 20:17:22 +01:00
.github/workflows release: 0.0.5 (fix release config again) (#110) 2025-12-09 20:07:26 +01:00
.husky Add basic-host and basic-server-react examples 2025-12-04 14:28:27 -06:00
docs Add checkpoints and callouts to quickstart guide (#93) 2025-12-09 16:16:28 +01:00
examples Add QR code Python MCP server example (#105) 2025-12-09 19:20:08 +01:00
specification/draft fix: change size-changed to be in correct tense (#83) 2025-12-08 12:14:56 +01:00
src Add RESOURCE_MIME_TYPE constant (#108) 2025-12-09 19:10:56 +01:00
.gitattributes Track package-lock.json for deterministic builds (#44) 2025-12-01 20:06:32 +00:00
.gitignore Add Three.js marketing example server 2025-12-08 21:19:42 +00:00
.prettierignore Add basic-server-vanillajs example 2025-12-04 14:28:27 -06:00
build.bun.ts npm run prettier:fix 2025-11-23 03:15:06 +00:00
CONTRIBUTING.md release: 0.0.3, switched to npm trusted publishing (#101) 2025-12-09 00:52:52 +01:00
LICENSE add license (#96) 2025-12-08 21:51:19 +01:00
package-lock.json release: 0.0.6 (#112) 2025-12-09 20:17:22 +01:00
package.json release: 0.0.6 (#112) 2025-12-09 20:17:22 +01:00
README.md Update README.md (#107) 2025-12-09 19:20:37 +01:00
tsconfig.json Initial commit 2025-11-21 11:56:27 +00:00
typedoc.json Add Quickstart guide for building MCP Apps 2025-12-04 14:28:55 -06:00

README.md

@modelcontextprotocol/ext-apps

API Documentation

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:

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

To run all examples together:

npm install
npm run examples:start

Then open http://localhost:8080/.

Resources