Thanks to visit codestin.com
Credit goes to github.com

Skip to content

[Schema] SEP-1865 MCP Apps: Content types, ui:// scheme, tool metadata fields #350

@chr-hertel

Description

@chr-hertel

Implements the schema portion of SEP-1865 (MCP Apps) for the MCP Spec 2026-07-28 release.

Tracked by umbrella #335. Depends on SEP-2133 extensions framework.

Spec summary

MCP Apps lets servers ship interactive HTML UIs to hosts. Servers predeclare UI resources under the ui:// URI scheme with MIME type text/html;profile=mcp-app, and tools reference these templates via metadata so hosts can prefetch and cache them. UIs run in sandboxed iframes and communicate bidirectionally with the host using MCP JSON-RPC over postMessage.

Spec lives at modelcontextprotocol/ext-apps.

PHP SDK changes

  • Recognize text/html;profile=mcp-app MIME type.
  • Recognize ui:// URI scheme (additions to URI handling under src/Schema/).
  • Add _meta-style tool metadata field tying a tool to a UI resource (e.g. mcp-apps-namespaced output template ref).
  • Surface the schema in tool result formatters so tools/call responses can include the UI linkage.

Related

Metadata

Metadata

Assignees

No one assigned

    Labels

    2026-07-28All issues and PRs related to the spec release 2026-07-28SchemaIssues & PRs related to the Schema componentenhancementRequest for a new feature that's not currently supportedimproves spec complianceImproves consistency with other SDKs such as TyepScript

    Type

    No type
    No fields configured for issues without a type.

    Projects

    Status
    Todo

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions