Discovery & Onboarding Gates


MCP Server & UI Tiers

Three-Tier MCP UI Architecture (ui:// MCP Apps & a2ui:// Surfaces)

This server demonstrates all three Model Context Protocol response rendering tiers defined in openapi/producer-openapi.yaml:

  • Tier 1 — Structured Text & Markdown (content[0].type = "text"): Universal baseline supported by all MCP hosts.
  • Tier 2 — Sandboxed Interactive HTML5 MCP Apps (ui://widget/catalog-carousel.html, text/html;profile=mcp-app): Linked via _meta.ui.resourceUri on search_catalog_items. Communicates bidirectionally with the host page over window.postMessage using JSON-RPC 2.0 (McpAppBridgeMessage: ui/initialize, ui/notifications/initialized, ui/notifications/tool-input, ui/notifications/tool-result, tools/call, ui/open-link).
  • Tier 3 — Declarative A2UI JSON Surfaces (a2ui://reservation-confirmation, application/json+a2ui): Returned as an embedded resource by create_reservation (A2uiSurfaceDocument with version: "0.8", surfaceId, root, components, and dataModel).

Interactive UI Tier Sandboxes & Manifest Exporter

1. Tier 2 Live ui:// Sandboxed Iframe & AppBridge Host Simulator

Load ui://widget/catalog-carousel.html via resources/read (POST /mcp), mount the returned text/html;profile=mcp-app bundle inside a sandboxed <iframe>, and inspect the real-time JSON-RPC 2.0 window.postMessage traffic as you click Reserve (tools/call) or push live ui/notifications/tool-result updates into the widget.

2. Tier 3 Declarative a2ui:// Surface Renderer (create_reservation)

Invoke create_reservation (or resources/read for a2ui://reservation-confirmation) and render the declarative A2uiSurfaceDocument (components + dataModel) into native HTML controls wired to follow-up update_reservation_notes and cancel_reservation tool actions.

3. OpenAPI & MCP Tool Manifest Exporter

Export the server's complete public-safe OpenAPI 3.0.3 operation inventory (/openapi.json, /openapi.yaml), MCP tools/list schema bundle, and resources/list UI descriptors for client code generation and partner conformance auditing.