---
title: "Build an MCP App (Interactive UI Widgets): review, setup & limitations · Undominated.ai"
canonical: https://undominated.ai/skills/anthropic-build-mcp-app/
description: "Adds interactive UI widgets (forms, pickers, confirm dialogs, charts) to an MCP server: the tool declares a ui:// resource, the server serves the widget HTML, and the host renders it in a sandboxed iframe in the chat."
---

# Build an MCP App (Interactive UI Widgets): review, setup & limitations · Undominated.ai

> Adds interactive UI widgets (forms, pickers, confirm dialogs, charts) to an MCP server: the tool declares a ui:// resource, the server serves the widget HTML, and the host renders it in a sandboxed iframe in the chat.

[← Explore all skills](/skills/)

AI APPLICATION DEVELOPMENT / Anthropic

# Build an MCP App (Interactive UI Widgets)

Adds interactive UI widgets (forms, pickers, confirm dialogs, charts) to an MCP server: the tool declares a ui:// resource, the server serves the widget HTML, and the host renders it in a sandboxed iframe in the chat.

 [See setup guidance ↓](#setup)[Original source ↗](https://github.com/anthropics/claude-plugins-official/tree/41f32e407b450055044f167db7ded5e8ff67d203/plugins/mcp-server-dev/skills/build-mcp-app)

SOURCE REVIEW

 Reviewed 2026-10-21
 Evidence 4 linked sources
 Publisher Anthropic
 Licence [Apache-2.0 ↗](https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/mcp-server-dev/LICENSE)
 Revision 41f32e407b45
 [Read what was—and wasn’t—checked ↓](#review)

“This skill should be used when the user wants to build an "MCP app", add "interactive UI" or "widgets" to an MCP server, "render components in chat", build "MCP UI resources", make a tool that shows a "form", "picker", "dashboard" or "confirmation dialog" inline in the conversation, or mentions "apps SDK" in the context of MCP. Use AFTER the build-mcp-server skill has settled the deployment model, or when the user already knows they want UI widgets.”

 [Anthropic · upstream description ↗](https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/mcp-server-dev/skills/build-mcp-app/SKILL.md) Our analysis follows below.

01 / THE REASONING

## Why this made the selection.

 - It says when a widget is worth building (structured input Claude cannot infer, picking from a list, confirming a destructive or billable action, visual output, live progress) and when elicitation covers the need with no UI code.
- It documents Claude host specifics: _meta.ui.resourceUri on the tool, the text/html;profile=mcp-app resource MIME type, CSP domains that default to block-all, and directory submission requirements of OAuth or authless access, tool annotations and 3-5 PNG screenshots.

### A good fit for

 - Add a contact-picker or confirmation widget to an existing MCP server tool
- Decide whether a tool needs a widget or a flat elicitation form
- Debug a widget that renders blank by checking the iframe's CSP and inlining the ext-apps bundle

### Weigh up before choosing

 - Last commit touching plugins/mcp-server-dev/skills/build-mcp-app at revision 41f32e40: 2026-04-28 (f4b5494f).
- The minimal picker widget writes each contact's name and email into li.innerHTML through a template literal, without escaping them.
- The scaffold's Express server registers POST /mcp with no authentication step.
- Widgets need the @modelcontextprotocol/ext-apps browser bundle inlined into the HTML, because the iframe CSP blocks CDN script fetches; the skill warns that importing from esm.sh renders a blank widget.
- For Claude Desktop testing it wraps the server with npx -y mcp-remote, with no package version given.
- It builds on the base layer from build-mcp-server and defers MCPB packaging to build-mcpb.
- The mcp-server-dev README, the plugin that carries build-mcp-app, prints no install line at this revision.

02 / THE REVIEW RECORD

## What we actually inspected.

Source review has boundaries. A clear record is more useful than a “safe” badge.

### Material inspected

 - plugins/mcp-server-dev/skills/build-mcp-app/SKILL.md
- plugins/mcp-server-dev/README.md
- plugins/mcp-server-dev/LICENSE
- README.md

### Our findings

 - The SKILL.md frontmatter declares no allowed-tools; the skill is Markdown with six reference files.
- A widget-enabled tool has two registrations: the tool returns plain text or JSON and names a UI resource, and the resource serves the HTML.
- Widgets cannot reach the host page's DOM, cookies or storage, cannot call arbitrary origins, and must use app.openLink for navigation, per the SKILL.md.
- Hosts without the apps surface ignore _meta.ui and show the tool's text content instead.

### Not established by this review

 - No widget or server was built, run or opened in a host.
- references/iframe-sandbox.md, widget-templates.md, apps-sdk-messages.md, payload-budgeting.md, abuse-protection.md and directory-checklist.md were not opened.
- Not executed: it was not installed or run.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

## Add a skill to your workflow.

[Upstream setup instructions ↗](https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/mcp-server-dev/README.md)
 - Neither the mcp-server-dev README nor any other file at this revision prints an install line for the plugin that contains build-mcp-app; the repository README only gives the placeholder form `/plugin install {plugin-name}@claude-plugins-official`, so install.command is null.
- The README says build-mcp-app works on remote servers and MCPB bundles and is reached through the build-mcp-server entry skill.
- The scaffold the skill gives for a widget server starts with `npm install @modelcontextprotocol/sdk @modelcontextprotocol/ext-apps zod express`; that installs the server's dependencies, not the skill.
- Nothing was installed for this review.

### Before you start

 - Claude Code
- A deployment model settled with build-mcp-server first, unless the user already knows they want UI widgets

### Compatibility

Claude Code

### Guidance and code templates for MCP servers that serve widgets

 - build-mcp-app declares no allowed-tools, so tool use follows the session
- Its scaffold writes src/server.ts and widgets/picker.html and runs npm install for four packages
- Its test steps run npx mcp-remote against http://localhost:3000/mcp and suggest a Cloudflare tunnel for testing as a claude.ai custom connector

### Cost model

Apache-2.0 per plugins/mcp-server-dev/LICENSE; npm packages and any tunnel or host used for testing are outside the skill

04 / FOLLOW THE EVIDENCE

## The source trail.

Our notes are separate from the original resource. Check upstream before adopting a new version.

 - [build-mcp-app SKILL.md ↗](https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/mcp-server-dev/skills/build-mcp-app/SKILL.md) Checked 2026-10-21 https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/mcp-server-dev/skills/build-mcp-app/SKILL.md Supports: upstreamDescription, summary, whySelected[0], whySelected[1], bestFor[0], bestFor[1], bestFor[2], limitations[1], limitations[2], limitations[3], limitations[4], limitations[5], review.findings[0], review.findings[1], review.findings[2], review.findings[3], install.steps[2], install.prerequisites[1], access.permissions[0], access.permissions[1], access.permissions[2]
- [mcp-server-dev README ↗](https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/mcp-server-dev/README.md) Checked 2026-10-21 https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/mcp-server-dev/README.md Supports: install.sourceUrl, install.steps[0], install.steps[1], limitations[5], limitations[6]
- [mcp-server-dev LICENSE ↗](https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/mcp-server-dev/LICENSE) Checked 2026-10-21 https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/mcp-server-dev/LICENSE Supports: license, access.cost
- [Repository README, installation ↗](https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/README.md) Checked 2026-10-21 https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/README.md Supports: install.steps[0], install.prerequisites[0], compatibility

KEEP COMPARING

## Other approaches to consider.

Related by category or shared topics. These are alternatives to inspect, not a measured quality order.

 [### Build an MCP Server ↗ Interviews the developer about an MCP server before any code, recommends one deployment model and a tool-design pattern, then scaffolds a remote or local stdio server or hands off to the MCP app or MCPB skill.](/skills/anthropic-build-mcp-server/)[### Build an MCPB (Bundled Local MCP Server) ↗ Packages a local stdio MCP server with its runtime and dependencies into a .mcpb zip archive with a manifest.json, so a user can install it without setting up Node or Python.](/skills/anthropic-build-mcpb/)[### Agent Platform GenAI Inference ↗ Calls Gemini and third-party OpenMaaS models on Google Cloud Agent Platform, asking for model, project and region instead of defaulting.](/skills/google-agent-platform-inference/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Choose a toolkit](/tools/)
- [Inspect execution hosts](/agents/)
- [Check tool access](/mcp-servers/)
- [Check project dependencies](/check-repo/)
