migrate-oai-app

This skill should be used when the user asks to "migrate from OpenAI Apps SDK", "convert OpenAI App to MCP", "port from window.openai", "migrate from skybridge", "convert openai/outputTemplate", or needs guidance on converting OpenAI Apps SDK applications to MCP Apps SDK. Provides step-by-step migration guidance with API mapping tables.

Jump to install

Repository: modelcontextprotocol/ext-apps
Last source activity: February 10, 2026 at 14:50
Detected SKILL.md language: English
Stars: 2,712
Forks: 364

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/modelcontextprotocol/ext-apps --skill migrate-oai-app

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

create-mcp-app

This skill should be used when the user asks to "create an MCP App", "add a UI to an MCP tool", "build an interactive MCP View", "scaffold an MCP App", or needs guidance on MCP Apps SDK patterns, UI-resource registration, MCP App lifecycle, or host integration. Provides comprehensive guidance for building MCP Apps with interactive UIs.

2026-03-06

convert-web-app

This skill should be used when the user asks to "add MCP App support to my web app", "turn my web app into a hybrid MCP App", "make my web page work as an MCP App too", "wrap my existing UI as an MCP App", "convert iframe embed to MCP App", "turn my SPA into an MCP App", or needs to add MCP App support to an existing web application while keeping it working standalone. Provides guidance for analyzing existing web apps and creating a hybrid web + MCP App with server-side tool and resource registration.

2026-02-21

add-app-to-server

This skill should be used when the user asks to "add an app to my MCP server", "add UI to my MCP server", "add a view to my MCP tool", "enrich MCP tools with UI", "add interactive UI to existing server", "add MCP Apps to my server", or needs to add interactive UI capabilities to an existing MCP server that already has tools. Provides guidance for analyzing existing tools and adding MCP Apps UI resources.

2026-02-20

View all from this repository

name	migrate-oai-app
description	This skill should be used when the user asks to "migrate from OpenAI Apps SDK", "convert OpenAI App to MCP", "port from window.openai", "migrate from skybridge", "convert openai/outputTemplate", or needs guidance on converting OpenAI Apps SDK applications to MCP Apps SDK. Provides step-by-step migration guidance with API mapping tables.

Migrate OpenAI App to MCP

Migrate existing OpenAI Apps SDK applications to the MCP Apps SDK (@modelcontextprotocol/ext-apps). The MCP Apps SDK provides a standardized, open protocol for interactive UIs in conversational clients.

Best Practices

Use your package manager to add dependencies (e.g., npm install, pnpm add, yarn add) instead of manually writing version numbers. This lets the package manager resolve the latest compatible versions. Never specify version numbers from memory.
Preemptively add a final todo item with this exact wording: "Re-read the 'Before Finishing' checklist in this skill and address each checkbox individually, stating what you did for each one, before marking this todo complete."

Getting Reference Code

Clone the SDK repository for complete migration documentation and working examples:

git clone --branch "v$(npm view @modelcontextprotocol/ext-apps version)" --depth 1 https://github.com/modelcontextprotocol/ext-apps.git /tmp/mcp-ext-apps

Migration Reference Guide

Read the migration reference guide with "before/after" mapping tables: /tmp/mcp-ext-apps/docs/migrate_from_openai_apps.md

API Reference (Source Files)

Read JSDoc documentation directly from /tmp/mcp-ext-apps/src/*:

`src/app.ts`	`App` class, handlers, lifecycle
`src/server/index.ts`	`registerAppTool`, `registerAppResource`
`src/spec.types.ts`	Type definitions
`src/react/useApp.tsx`	`useApp` hook for React apps
`src/react/use.ts`	Other `use*` hooks for React apps

Template	Key Files
`basic-server-vanillajs/`	`server.ts`, `src/mcp-app.ts`, `mcp-app.html`
`basic-server-react/`	`server.ts`, `src/mcp-app.tsx` (uses `useApp` hook)
`basic-server-vue/`	`server.ts`, `src/App.vue`
`basic-server-svelte/`	`server.ts`, `src/App.svelte`
`basic-server-preact/`	`server.ts`, `src/mcp-app.tsx`
`basic-server-solid/`	`server.ts`, `src/mcp-app.tsx`

OpenAI Feature	Status/Workaround
`_meta["openai/toolInvocation/invoking"]` / `_meta["openai/toolInvocation/invoked"]`	Progress indicators not yet available
`_meta["openai/widgetDescription"]`	Use `app.updateModelContext()` for dynamic context

OpenAI Feature	Status/Workaround
`window.openai.widgetState` / `setWidgetState()`	Use `localStorage` or server-side state
`window.openai.uploadFile()` / `getFileDownloadUrl()`	File operations not yet available
`window.openai.requestModal()` / `requestClose()`	Modal management not yet available
`window.openai.view`	Not yet available

Pattern	Indicates
`"openai/`	Old metadata keys → `_meta.ui.*`
`text/html+skybridge`	Old MIME type → `RESOURCE_MIME_TYPE` constant
`text/html;profile=mcp-app`	New MIME type, but prefer `RESOURCE_MIME_TYPE` constant
`_domains"` or `_domains:`	snake_case CSP → camelCase (`connect_domains` → `connectDomains`)

migrate-oai-app

Install options

Review the source files

Migrate OpenAI App to MCP

Best Practices

Getting Reference Code

Migration Reference Guide

API Reference (Source Files)

Migrate OpenAI App to MCP

Best Practices

Getting Reference Code

Migration Reference Guide

API Reference (Source Files)

Front-End Framework Examples

CSP Investigation

CORS Configuration

Key Conceptual Changes

Server-Side

Client-Side

Features Not Yet Available in MCP Apps

Before Finishing

Testing

Using basic-host

Verify Runtime Behavior

Pattern	Indicates
`window.openai.toolInput`	Old global → `params.arguments` in `ontoolinput` handler
`window.openai.toolOutput`	Old global → `params.structuredContent` in `ontoolresult`
`window.openai`	Old global API → `App` instance methods

migrate-oai-app

Source facts

Install options

Review the source files

More from this repository

Migrate OpenAI App to MCP

Best Practices

Getting Reference Code

Migration Reference Guide

API Reference (Source Files)

Migrate OpenAI App to MCP

Best Practices

Getting Reference Code

Migration Reference Guide

API Reference (Source Files)

Front-End Framework Examples

CSP Investigation

CORS Configuration

Key Conceptual Changes

Server-Side

Client-Side

Features Not Yet Available in MCP Apps

Before Finishing

Testing

Using basic-host

Verify Runtime Behavior

More from this repository