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.
SkillScore100Maintained
Automatic
◆AI Engineer pack
Last verified 8/7/2026
What it changes
Passed 22 of 22 test cases with the skill, and 9 of 22 without it.
Without skill41%
With skill100%
Checks it passed that the model alone missed
Calls app.sendLog with level info
Calls app.sendLog with level error
Calls useHostStyles passing the app instance
and 22 more in the full report
13 fixed9 passed either way0 still failing0 broke
Pass-rate lift
+59 pp
Tokens
+104%
Agent turns
0%
Response time
-38%
Model gemini-3.6-flashMeasured 8/7/2026v122 of 22 cases passed with skill
Tokens, turns and time describe resource use, not a dollar price.
See it in action
One of 13 test cases the skill fixed. Same model, same prompt, with and without the skill.
1 of 13
Prompt
When registering an MCP tool that should open an interactive UI in the host, what property must be included in the tool's metadata to link it to its corresponding HTML resource URI?
What was checked, without and with the skill
Checked
Without skill
With skill
Specifies the URI string inside _meta.ui.resourceUri
Missed
Passed
case-16 · gemini-3.6-flash · 8/7/2026 · answers are capped and redacted
What's inside
The instructions your model reads when the skill loads.
SKILL.md362 linessingle file
Create MCP App
Build interactive UIs that run inside MCP-enabled hosts like Claude Desktop. An MCP App combines an MCP tool with an HTML resource to display rich, interactive content.
Core Concept: Tool + Resource
Every MCP App requires two parts linked together:
Tool - Called by the LLM/host, returns data
Resource - Serves the bundled HTML UI that displays the data
Link - The tool's _meta.ui.resourceUri references the resource
Host calls tool → Server returns result → Host renders resource UI → UI receives result
Quick Start Decision Tree
Framework Selection
Framework
SDK Support
Best For
React
useApp hook provided
Teams familiar with React
Vanilla JS
Manual lifecycle
Simple apps, no build complexity
Vue/Svelte/Preact/Solid
Manual lifecycle
Framework preference
Project Context
Adding to existing MCP server:
Import registerAppTool, registerAppResource from SDK
Add tool registration with _meta.ui.resourceUri
Add resource registration serving bundled HTML
Creating new MCP server:
Set up server with transport (stdio or HTTP)
Register tools and resources
Configure build system with vite-plugin-singlefile
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.