Agent Skills

Agent Skills 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:

create-mcp-app — scaffolds a new MCP App with an interactive UI
migrate-oai-app — migrates an existing OpenAI App to the MCP Apps SDK
add-app-to-server — adds interactive UI to an existing MCP server's tools
convert-web-app — converts an existing web application into an MCP App

Install the Skills

Choose one of the following installation methods based on your agent:

Option 1: Claude Code Plugin

Install via Claude Code:

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

Option 2: Vercel Skills CLI

Use the Vercel Skills CLI to install skills across different AI coding agents:

npx skills add modelcontextprotocol/ext-apps

Option 3: Manual Installation

Clone the repository:

git clone https://github.com/modelcontextprotocol/ext-apps.git

Then copy the skills from plugins/mcp-apps/skills/ to your agent's skills directory. See your agent's documentation for the correct location:

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.

Invoke a Skill

Try invoking the skills by asking your agent:

"Create an MCP App" — scaffolds a new MCP App with an interactive UI
"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

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

Test Your App

After creating or migrating your MCP App, see the Testing MCP Apps guide to run and debug it locally.