convert-web-app

Convert standalone web apps into sandboxed-iframe MCP App resources.

Updated Apr 6, 2026
One-click install
npx skills add https://github.com/mrkhachaturov/jira-mcp-plugin --skill convert-web-app-mrkhachaturov
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convert-web-app
Source: https://github.com/mrkhachaturov/jira-mcp-plugin/tree/main/.agents/skills/convert-web-app
Command: npx skills add https://github.com/mrkhachaturov/jira-mcp-plugin --skill convert-web-app-mrkhachaturov

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps you convert an existing standalone web application into a hybrid MCP App so it can run inside MCP-enabled hosts while still working normally in a browser.

Core Features & Use Cases

  • Hybrid runtime support: Adds MCP-host-aware initialization so the same UI renders both standalone and inside an MCP iframe.
  • MCP server tool + resource registration: Wraps your bundled HTML as an MCP App resource and registers a tool that supplies parameters to the UI via tool lifecycle events.
  • CSP and host styling integration: Guides you to enumerate required resource/connect domains for sandboxed iframes and to apply host theme variables (fonts, colors, spacing) for a consistent look across hosts.
  • Optional enhancements: Supports app-only helper tools, streaming partial input for progressive UI, fullscreen display mode requests, and safe fallback content for non-UI hosts.

Quick Start

Ask the skill to convert your current web app into a hybrid MCP App by keeping it standalone while adding an MCP tool that delivers launch parameters and a registered resource that renders your UI in an MCP host.

Frequently Asked Questions about convert-web-app

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I wrap a web application into an MCP App resource?

To wrap a web application into an MCP App resource, you build a sandboxed-iframe MCP App resource using the ext-apps SDK, registering a tool that supplies launch parameters to the UI via tool lifecycle handlers.

Can I make a SPA work as a hybrid UI inside an MCP host while keeping standalone browser behavior?

Yes, you can make a SPA work as a hybrid UI by adding MCP-host-aware initialization that renders the UI both standalone and inside an MCP iframe without breaking existing browser behavior.

What is CSP domain enumeration for sandboxed iframes in MCP Apps?

CSP domain enumeration for sandboxed iframes involves listing all required resource and connect domains so the wrapped MCP App can securely load external assets within the host environment.

How do I apply host theme variables to a wrapped MCP App?

You apply host theme variables by integrating host style variables like fonts, colors, and spacing using the ext-apps SDK, ensuring a consistent look across different MCP-enabled hosts.

Does the MCP App conversion support progressive UI and fullscreen display?

Yes, the MCP App conversion supports optional enhancements like streaming partial input for progressive UI, fullscreen display mode requests, and safe fallback content for non-UI hosts.

What are the limitations of wrapping an iframe embed as an MCP resource?

Limitations of wrapping an iframe embed as an MCP resource include strict CSP domain requirements for sandboxed iframes and the need to handle tool lifecycle events properly to ensure UI rendering across hosts.