Skip to content
Back to search

ext-apps

Official repo for spec & SDK of MCP Apps protocol - standard for UIs embedded AI chatbots, served by MCP servers

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/modelcontextprotocol--ext-apps/badge.svg)](/listings/modelcontextprotocol--ext-apps)

HTML

<a href="/listings/modelcontextprotocol--ext-apps"><img src="/api/listings/modelcontextprotocol--ext-apps/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

**Claude Code** — install via the plugin marketplace:

/plugin marketplace add modelcontextprotocol/ext-apps
/plugin install mcp-apps@modelcontextprotocol-ext-apps

**Other agents** — any AI coding agent that supports [Agent Skills](https://agentskills.io/) can use these skills. See the [agent skills guide](./docs/agent-skills.md) for manual installation instructions.

Once installed, verify by asking your agent _"What skills do you have?"_ — you should see `create-mcp-app`, `migrate-oai-app`, `add-app-to-server`, and `convert-web-app` in the list. Then just ask it to create or migrate an app and it will guide you through the rest.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 14 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "mcp-apps",
  3. "description": "Plugins for MCP Apps development",
  4. "owner": {
  5. "name": "MCP Apps"
  6. },
  7. "plugins": [
  8. {
  9. "name": "mcp-apps",
  10. "source": "./plugins/mcp-apps",
  11. "description": "Skills for creating MCP Apps with the MCP Apps SDK"
  12. }
  13. ]
  14. }
README.md · README · 284 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <!-- LOGO -->
  2. <div align="center">
  3. <picture>
  4. <source media="(prefers-color-scheme: dark)" srcset="media/mcp-white.svg">
  5. <source media="(prefers-color-scheme: light)" srcset="media/mcp.svg">
  6. <img src="media/mcp.svg" alt="MCP Apps" width="128">
  7. </picture>
  8. <h1>MCP Apps</h1>
  9. <p>
  10. Build interactive UIs for MCP tools — charts, forms, dashboards — that render inline in Claude, ChatGPT and any other compliant chat client.
  11. <br /><br />
  12. <a href="#why-mcp-apps">Why</a>
  13. ·
  14. <a href="https://apps.extensions.modelcontextprotocol.io/api/documents/quickstart.html">Quickstart</a>
  15. ·
  16. <a href="https://apps.extensions.modelcontextprotocol.io/api/">API Docs</a>
  17. ·
  18. <a href="https://github.com/modelcontextprotocol/ext-apps/blob/main/specification/2026-01-26/apps.mdx">Spec</a>
  19. ·
  20. <a href="CONTRIBUTING.md">Contributing</a>
  21. </p>
  22. </div>
  23. <p align="center">
  24. <a href="https://github.com/modelcontextprotocol/ext-apps/actions/workflows/ci.yml"><img src="https://github.com/modelcontextprotocol/ext-apps/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
  25. <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-blue" alt="License: Apache 2.0"></a>
  26. <a href="https://www.npmjs.com/package/@modelcontextprotocol/ext-apps"><img src="https://img.shields.io/npm/v/@modelcontextprotocol/ext-apps.svg" alt="npm version"></a>
  27. <a href="https://www.npmjs.com/package/@modelcontextprotocol/ext-apps"><img src="https://img.shields.io/npm/dm/@modelcontextprotocol/ext-apps.svg" alt="npm downloads"></a>
  28. <a href="https://github.com/modelcontextprotocol/ext-apps"><img src="https://img.shields.io/github/stars/modelcontextprotocol/ext-apps" alt="GitHub stars"></a>
  29. <a href="https://apps.extensions.modelcontextprotocol.io/api/"><img src="https://img.shields.io/badge/docs-API%20Reference-blue" alt="API Documentation"></a>
  30. </p>
  31. <p align="center">
  32. <img src="media/excalidraw.gif" alt="MCP Apps demo" width="600">
  33. <br><em>Excalidraw built with MCP Apps, running in Claude</em>
  34. </p>
  35. ## Table of Contents
  36. - [Build with Agent Skills](#build-with-agent-skills)
  37. - [Supported Clients](#supported-clients)
  38. - [Why MCP Apps?](#why-mcp-apps)
  39. - [How It Works](#how-it-works)
  40. - [Getting Started](#getting-started)
  41. - [Using the SDK](#using-the-sdk)
  42. - [Examples](#examples)
  43. - [Specification](#specification)
  44. - [Resources](#resources)
  45. - [Contributing](#contributing)
  46. ## Build with Agent Skills
  47. The fastest way to build an MCP App is to let your AI coding agent do it. This
  48. repo ships four [Agent Skills](https://agentskills.io/) — install them once,
  49. then just ask:
  50. | Skill | What it does | Try it |
  51. | --------------------------------------------------------------------------- | ----------------------------------------------------------- | ------------------------------------- |
  52. | [`create-mcp-app`](./plugins/mcp-apps/skills/create-mcp-app/SKILL.md) | Scaffolds a new MCP App with an interactive UI from scratch | _"Create an MCP App"_ |
  53. | [`migrate-oai-app`](./plugins/mcp-apps/skills/migrate-oai-app/SKILL.md) | Converts an existing OpenAI App to use MCP Apps | _"Migrate from OpenAI Apps SDK"_ |
  54. | [`add-app-to-server`](./plugins/mcp-apps/skills/add-app-to-server/SKILL.md) | Adds interactive UI to an existing MCP server's tools | _"Add UI to my MCP server"_ |
  55. | [`convert-web-app`](./plugins/mcp-apps/skills/convert-web-app/SKILL.md) | Turns an existing web app into a hybrid web + MCP App | _"Add MCP App support to my web app"_ |
  56. ### Install the Skills
  57. **Claude Code** — install via the plugin marketplace:
  58. ```
  59. /plugin marketplace add modelcontextprotocol/ext-apps
  60. /plugin install mcp-apps@modelcontextprotocol-ext-apps
  61. ```
  62. **Other agents** — any AI coding agent that supports
  63. [Agent Skills](https://agentskills.io/) can use these skills. See the
  64. [agent skills guide](./docs/agent-skills.md) for manual installation
  65. instructions.
  66. Once installed, verify by asking your agent _"What skills do you have?"_ — you
  67. should see `create-mcp-app`, `migrate-oai-app`, `add-app-to-server`, and
  68. `convert-web-app` in the list. Then just ask it to create or migrate an app and
  69. it will guide you through the rest.
  70. ## Supported Clients
  71. <p align="center">
  72. <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>
  73. <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>
  74. <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>
  75. <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>
  76. <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>
  77. <a href="https://www.mcpjam.com/blog/mcp-apps-example"><img src="https://img.shields.io/badge/MCPJam-docs-8B5CF6" alt="MCPJam"></a>
  78. <a href="https://manufact.com/inspector"><img src="https://img.shields.io/badge/mcp--use-inspector-E5F3FD" alt="mcp-use"></a>
  79. <a href="https://docs.alpic.ai/distribution/playground"><img src="https://img.shields.io/badge/Alpic-playground-E90060?logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAGQAAABkCAMAAABHPGVmAAAAKlBMVEUKDhz%2F%2F%2F%2BjpaogJDFBRE%2Fw8PHHyMvh4eNmaHF1d4CUlpuFho2ztLhWWWP5YkbJAAAACXBIWXMAAAsTAAALEwEAmpwYAAAB1klEQVR42u2Y0ZKDIAxFBQQF8f9%2FdyW7dhAu7U7Iy87mzvShGfXU3CTGLotKpVKpVCqV6h%2FI2VuxfF3tUwcdVEccA2LNS%2BWCq2mUykG%2BCtg5iNmv76mllOApCPHrFQgNxJf8HHIQs10XdFtDKcEKPQ0x4brg6htKWGr0PIR8jq0tj4oQgJiIzD8rtATErMAWMj%2FxIYcBPjuPgoENcW3Jks%2BdLeXS32jLmise%2BZxQ8GRD%2BkkCbSlByi0Pgm3p0P6nJ1meXJ%2F8K1tKo7qUOFM4wdxEMMS4iSp9sqFJQrZ4hOZBTEa5gbaQ%2BTwI%2FcCu8TOq482xIWZkSx8MfAi0xcOEJTZkULKohXjm29epGU2SIGK%2BfT9J%2Bjre%2BRBYsiUYBSHkaEI2B0EInRx%2BkbApiB89EaMgBNdx7u5vDoJH79ne3yQElqxvEzYLKY%2Bl81PCZiFUsvlDwqYhw80uSkJg4z8Ttsss3OltwgQgMGGPlpSAwITVM0wCgius6iARCGzJcn%2BHJCSMXraCIATPsPW2SggCh364a1sIgveUew%2BTgtBGsuE9zDspyLBZ3M5aVCOCUDFlqXUbrm8j7%2FnvJ2B9G3kf%2BZBlt0iu%2Fr%2BNxHqRU6lUKpVKpVL9UX0BOrAPfcbTY8UAAAAASUVORK5CYII%3D" alt="Alpic Playground"></a>
  80. </p>
  81. > [!NOTE]
  82. > MCP Apps is an extension to the
  83. > [core MCP specification](https://modelcontextprotocol.io/specification). Host
  84. > support varies — see the
  85. > [clients page](https://modelcontextprotocol.io/extensions/client-matrix) for the full list.
  86. ## Why MCP Apps?
  87. MCP tools return text and structured data. That works for many cases, but not
  88. when you need an interactive UI, like a chart, form, design canvas or video player.
  89. MCP Apps provide a standardized way to deliver interactive UIs from MCP servers.
  90. Your UI renders inline in the conversation, in context, in any compliant host.
  91. ## How It Works
  92. MCP Apps extend the Model Context Protocol by letting tools declare UI
  93. resources:
  94. 1. **Tool definition** — Your tool declares a `ui://` resource containing its
  95. HTML interface
  96. 2. **Tool call** — The LLM calls the tool on your server
  97. 3. **Host renders** — The host fetches the resource and displays it in a
  98. sandboxed iframe
  99. 4. **Bidirectional communication** — The host passes tool data to the UI via
  100. notifications, and the UI can call other tools through the host
  101. ## Getting Started
  102. Requires Node.js 20+. The base MCP SDK packages are `^2.0.0` peers of
  103. `ext-apps` (`@modelcontextprotocol/core` is a required peer that `client` already depends on, so npm installs it for you).
  104. For a View or host:
  105. ```bash
  106. npm install -S @modelcontextprotocol/ext-apps \
  107. @modelcontextprotocol/client@^2.0.0 \
  108. zod@^4.2.0
  109. ```
  110. For an MCP server, add the server package (and, for HTTP transports, the Node
  111. and Express adapters):
  112. ```bash
  113. npm install -S @modelcontextprotocol/ext-apps \
  114. @modelcontextprotocol/client@^2.0.0 \
  115. @modelcontextprotocol/server@^2.0.0 \
  116. @modelcontextprotocol/node@^2.0.0 \
  117. @modelcontextprotocol/express@^2.0.0 \
  118. zod@^4.2.0
  119. ```
  120. The wire protocol is unchanged between `ext-apps` 1.x and 2.x: a 2.x View works
  121. in a 1.x host and a 2.x host renders 1.x Views. See the
  122. [migration guide](https://apps.extensions.modelcontextprotocol.io/api/documents/migrate-to-v2.html)
  123. when upgrading from 1.x.
  124. **New here?** Start with the
  125. [Quickstart Guide](https://apps.extensions.modelcontextprotocol.io/api/documents/quickstart.html)
  126. to build your first MCP App.
  127. ## Using the SDK
  128. The SDK serves three roles: app developers building interactive Views, host
  129. developers embedding those Views, and MCP server authors registering tools with
  130. UI metadata.
  131. | Package | Purpose | Docs |
  132. | ------------------------------------------- | --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
  133. | `@modelcontextprotocol/ext-apps` | Build interactive Views (App class, PostMessageTransport) | [API Docs →](https://apps.extensions.modelcontextprotocol.io/api/modules/app.html) |
  134. | `@modelcontextprotocol/ext-apps/react` | React hooks for Views (useApp, useHostStyles, etc.) | [API Docs →](https://apps.extensions.modelcontextprotocol.io/api/modules/_modelcontextprotocol_ext-apps_react.html) |
  135. | `@modelcontextprotocol/ext-apps/app-bridge` | Embed and communicate with Views in your chat client | [API Docs →](https://apps.extensions.modelcontextprotocol.io/api/modules/app-bridge.html) |
  136. | `@modelcontextprotocol/ext-apps/server` | Register tools and resources on your MCP server | [API Docs →](https://apps.extensions.modelcontextprotocol.io/api/modules/server-helpers.html) |
  137. There's no _supported_ host implementation in this repo (beyond the
  138. [examples/basic-host](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples/basic-host)
  139. example).
  140. The [MCP-UI](https://github.com/idosal/mcp-ui) client SDK offers a
  141. fully-featured MCP Apps framework used by a few hosts. Clients may choose to use
  142. it or roll their own implementation.
  143. ## Examples
  144. The
  145. [`examples/`](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples)
  146. directory contains demo apps showcasing real-world use cases.
  147. <!-- prettier-ignore-start -->
  148. | | | |
  149. |:---:|:---:|:---:|
  150. | [![Map](examples/map-server/grid-cell.png "Interactive 3D globe viewer using CesiumJS")](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples/map-server) | [![Three.js](examples/threejs-server/grid-cell.png "Interactive 3D scene renderer")](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples/threejs-server) | [![ShaderToy](examples/shadertoy-server/grid-cell.png "Real-time GLSL shader renderer")](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples/shadertoy-server) |
  151. | [**Map**](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples/map-server) | [**Three.js**](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples/threejs-server) | [**ShaderToy**](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples/shadertoy-server) |
  152. | [![Sheet Music](examples/sheet-music-server/grid-cell.png "ABC notation to sheet music")](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples/sheet-music-server) | [![Wiki Explorer](examples/wiki-explorer-server/grid-cell.png "Wikipedia link graph visualization")](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples/wiki-explorer-server) | [![Cohort Heatmap](examples/cohort-heatmap-server/grid-cell.png "Customer retention heatmap")](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples/cohort-heatmap-server) |
  153. | [**Sheet Music**](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples/sheet-music-server) | [**Wiki Explorer**](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples/wiki-explorer-server) | [**Cohort Heatmap**](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples/cohort-heatmap-server) |
  154. | [![Scenario Modeler](examples/scenario-modeler-server/grid-cell.png "SaaS business projections")](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples/scenario-modeler-server) | [![Budget Allocator](examples/budget-allocator-server/grid-cell.png "Interactive budget allocation")](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples/budget-allocator-server) | [![Customer Segmentation](examples/customer-segmentation-server/grid-cell.png "Scatter chart with clustering")](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples/customer-segmentation-server) |
  155. | [**Scenario Modeler**](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples/scenario-modeler-server) | [**Budget Allocator**](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples/budget-allocator-server) | [**Customer Segmentation**](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples/customer-segmentation-server) |
  156. | [![System Monitor](examples/system-monitor-server/grid-cell.png "Real-time OS metrics")](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples/system-monitor-server) | [![Transcript](examples/transcript-server/grid-cell.png "Live speech transcription")](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples/transcript-server) | [![Video Resource](examples/video-resource-server/grid-cell.png "Binary video via MCP resources")](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples/video-resource-server) |
  157. | [**System Monitor**](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples/system-monitor-server) | [**Transcript**](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples/transcript-server) | [**Video Resource**](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples/video-resource-server) |
  158. | [![PDF Server](examples/pdf-server/grid-cell.png "Interactive PDF viewer with chunked loading")](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples/pdf-server) | [![QR Code](examples/qr-server/grid-cell.png "QR code generator")](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples/qr-server) | [![Say Demo](examples/say-server/grid-cell.png "Text-to-speech demo")](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples/say-server) |
  159. | [**PDF Server**](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples/pdf-server) | [**QR Code (Python)**](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples/qr-server) | [**Say Demo**](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples/say-server) |
  160. ### Starter Templates
  161. | | |
  162. |:---:|:---|
  163. | [![Basic](examples/basic-server-react/grid-cell.png "Starter template")](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples/basic-server-react) | The same app built with different frameworks — pick your favorite!<br><br>[React](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples/basic-server-react) · [Vue](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples/basic-server-vue) · [Svelte](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples/basic-server-svelte) · [Preact](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples/basic-server-preact) · [Solid](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples/basic-server-solid) · [Vanilla JS](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples/basic-server-vanillajs) |
  164. <!-- prettier-ignore-end -->
  165. ### Running the Examples
  166. #### With basic-host
  167. To run all examples locally using
  168. [basic-host](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples/basic-host)
  169. (the reference host implementation included in this repo):
  170. ```bash
  171. git clone https://github.com/modelcontextprotocol/ext-apps.git
  172. cd ext-apps
  173. npm install
  174. npm start
  175. ```
  176. Then open http://localhost:8080/.
  177. #### With MCP Clients
  178. Every Node.js example is published as `@modelcontextprotocol/server-<name>`. To
  179. add one to an MCP client that supports stdio (Claude Desktop, VS Code, etc.),
  180. use this pattern:
  181. ```json
  182. {
  183. "mcpServers": {
  184. "<name>": {
  185. "command": "npx",
  186. "args": ["-y", "@modelcontextprotocol/server-<name>", "--stdio"]
  187. }
  188. }
  189. }
  190. ```
  191. For example, to add the map server: `@modelcontextprotocol/server-map`. The
  192. Python examples (`qr-server`, `say-server`) use `uv run` instead — see their
  193. READMEs for details.
  194. #### Local Development
  195. To test local modifications with an MCP client, clone the repo, install, then
  196. point your client at a local build:
  197. ```json
  198. {
  199. "mcpServers": {
  200. "<name>": {
  201. "command": "bash",
  202. "args": [
  203. "-c",
  204. "cd ~/code/ext-apps/examples/<name>-server && npm run build >&2 && node dist/index.js --stdio"
  205. ]
  206. }
  207. }
  208. }
  209. ```
  210. ## Specification
  211. <div align="center">
  212. | Version | Status | Link |
  213. | -------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------- |
  214. | **2026-01-26** | Stable | [specification/2026-01-26/apps.mdx](https://github.com/modelcontextprotocol/ext-apps/blob/main/specification/2026-01-26/apps.mdx) |
  215. | **draft** | Development | [specification/draft/apps.mdx](https://github.com/modelcontextprotocol/ext-apps/blob/main/specification/draft/apps.mdx) |
  216. </div>
  217. ## Resources
  218. - [Quickstart Guide](https://apps.extensions.modelcontextprotocol.io/api/documents/quickstart.html)
  219. - [API Documentation](https://apps.extensions.modelcontextprotocol.io/api/)
  220. - [Specification (2026-01-26)](https://github.com/modelcontextprotocol/ext-apps/blob/main/specification/2026-01-26/apps.mdx)
  221. ([Draft](https://github.com/modelcontextprotocol/ext-apps/blob/main/specification/draft/apps.mdx))
  222. - [SEP-1865 Discussion](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/1865)
  223. ## Contributing
  224. Contributions are welcome! Please read [CONTRIBUTING.md](CONTRIBUTING.md) for
  225. guidelines on how to get started, submit pull requests, and report issues.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.