Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -101,3 +101,6 @@ The `plugins/mcp-apps/` directory contains a Claude Code plugin distributed via

- `plugins/mcp-apps/skills/create-mcp-app/SKILL.md` — for creating an MCP App
- `plugins/mcp-apps/skills/migrate-oai-app/SKILL.md` — for migrating an app from the OpenAI Apps SDK to the MCP Apps SDK
- `plugins/mcp-apps/skills/add-app-to-server/SKILL.md` — for adding interactive UI to an existing MCP server's tools
- `plugins/mcp-apps/skills/convert-web-app/SKILL.md` — for turning an existing web app into a hybrid web + MCP App
- `plugins/mcp-apps/skills/add-apps-to-host/SKILL.md` — for building the host side (sandbox page, AppFrame, backend endpoints) that renders MCP Apps in a chat client
6 changes: 4 additions & 2 deletions docs/agent-skills.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,12 +8,13 @@ description: Use Agent Skills to build, migrate, and extend MCP Apps with AI cod

[Agent Skills](https://agentskills.io/) are instruction sets that guide AI coding agents through tasks. When you invoke a skill, the agent takes the lead — it asks clarifying questions, makes decisions based on your codebase, and executes the work.

This repository provides four skills:
This repository provides five skills:

- [**create-mcp-app**](https://github.com/modelcontextprotocol/ext-apps/blob/main/plugins/mcp-apps/skills/create-mcp-app/SKILL.md) — scaffolds a new MCP App with an interactive UI
- [**migrate-oai-app**](https://github.com/modelcontextprotocol/ext-apps/blob/main/plugins/mcp-apps/skills/migrate-oai-app/SKILL.md) — migrates an existing OpenAI App to the MCP Apps SDK
- [**add-app-to-server**](https://github.com/modelcontextprotocol/ext-apps/blob/main/plugins/mcp-apps/skills/add-app-to-server/SKILL.md) — adds interactive UI to an existing MCP server's tools
- [**convert-web-app**](https://github.com/modelcontextprotocol/ext-apps/blob/main/plugins/mcp-apps/skills/convert-web-app/SKILL.md) — converts an existing web application into an MCP App
- [**add-apps-to-host**](https://github.com/modelcontextprotocol/ext-apps/blob/main/plugins/mcp-apps/skills/add-apps-to-host/SKILL.md) — adds MCP Apps support to a chat client (host): the sandbox page, the AppFrame component and the backend endpoints they need

## Install the Skills

Expand Down Expand Up @@ -55,7 +56,7 @@ Then copy the skills from `plugins/mcp-apps/skills/` to your agent's skills dire

## Verify Installation

Ask your agent "What skills do you have?" — you should see `create-mcp-app`, `migrate-oai-app`, `add-app-to-server`, and `convert-web-app` among the available skills.
Ask your agent "What skills do you have?" — you should see `create-mcp-app`, `migrate-oai-app`, `add-app-to-server`, `convert-web-app`, and `add-apps-to-host` among the available skills.

## Invoke a Skill

Expand All @@ -65,6 +66,7 @@ Try invoking the skills by asking your agent:
- "Migrate from OpenAI Apps SDK" — converts an existing OpenAI App to use the MCP Apps SDK
- "Add UI to my MCP server" — adds interactive UI to an existing MCP server's tools
- "Convert my web app to an MCP App" — converts an existing web application into an MCP App
- "Render MCP Apps in my chat app" — builds the host side: sandbox page, AppFrame and backend endpoints

The agent will guide you through the process, asking clarifying questions as needed.

Expand Down
2,008 changes: 2,008 additions & 0 deletions docs/building-a-host.html

Large diffs are not rendered by default.

7 changes: 7 additions & 0 deletions plugins/mcp-apps/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,3 +27,10 @@ Invoke skills by asking Claude Code to:
- "Migrate from OpenAI Apps SDK"
- "Convert OpenAI App to MCP"
- "Port from window.openai"

### Add MCP Apps to a host

- "Render MCP Apps in my chat app"
- "Build an MCP Apps host"
- "Write an AppFrame and a sandbox proxy page"
- "Use AppBridge to embed MCP App views"
214 changes: 214 additions & 0 deletions plugins/mcp-apps/skills/add-apps-to-host/SKILL.md

Large diffs are not rendered by default.

Loading