
Convert Web App
Turns your existing web application into a hybrid that works both standalone and as an MCP App inside Claude Desktop, from a single codebase. The skill walks through analyzing your current data sources (URL params, API calls, props), mapping them to MCP equivalents like ontoolinput arguments and server-side tools, and wrapping everything with a thin detection layer that switches between contexts. Heavy focus on CSP investigation since the sandboxed iframe fails silently on missing domain declarations. You get framework-specific templates for React, Vue, Svelte, and others, plus patterns for handling external APIs and binary content. Best when you already have a working web UI and want to embed it inline in chat without rebuilding from scratch.
- skills.sh installs
- 1K
- GitHub stars
- 3.1K
- last updated
- Aug 21, 2026
Install
$ npx -y skills add modelcontextprotocol/ext-apps --skill convert-web-app --agent claude-codeInstalls into .claude/skills of the current project.
Files
Add MCP App Support to a Web App
Add MCP App support to an existing web application so it works both as a standalone web app and as an MCP App that renders inline in MCP-enabled hosts like Claude Desktop — from a single codebase.
How It Works
The existing web app stays intact. A thin initialization layer detects whether the app is running inside an MCP host or as a regular web page, and fetches parameters from the appropriate source. A new MCP server wraps the app's bundled HTML as a resource and registers a tool to display it.
Standalone: Browser loads page → App reads URL params / APIs → renders
MCP App: Host calls tool → Server returns result → Host renders app in iframe → App reads MCP lifecycle → renders
The app's rendering logic is shared — only the data source changes.
Getting Reference Code
Clone the SDK repository for working examples and API documentation:
git clone --branch "v$(npm view @modelcontextprotocol/ext-apps version)" --depth 1 https://github.com/modelcontextprotocol/ext-apps.git /tmp/mcp-ext-apps
API Reference (Source Files)
Read JSDoc documentation directly from /tmp/mcp-ext-apps/src/:
Sponsors
Details
- Repository
- github.com/modelcontextprotocol/ext-apps
- Categories
- Backend & APIs, AI & Agent Building
- First seen
- Jun 3, 2026