MCP Apps
    Preparing search index...

    Interface McpUiResourceMeta

    UI Resource metadata for security and rendering configuration.

    interface McpUiResourceMeta {
        contentMimeTypes?: string[];
        csp?: McpUiResourceCsp;
        domain?: string;
        permissions?: McpUiResourcePermissions;
        prefersBorder?: boolean;
    }
    Index

    Properties

    contentMimeTypes? csp? domain? permissions? prefersBorder?

    Properties

    contentMimeTypes?: string[]

    MIME types of dynamic content payloads this view renders.

    When present, the view acts as a renderer for typed payloads returned by its associated tools as embedded resources marked with _meta.ui.content (see McpUiContentBlockMeta). Does not affect the resource's own mimeType, which remains "text/html;profile=mcp-app".

    This is a validation contract, not a routing mechanism: it declares what the view can parse so hosts can review, prefetch, type-filter, and size-limit at connection time. Routing is implicit: payloads are delivered to the calling tool's declared view (_meta.ui.resourceUri).

    Single-format renderers declare one entry. Multiple entries support distinct payload types rendered by one view, format version migration, or separate full-document and incremental-update types.

    ["application/a2ui+json"]
    csp?: McpUiResourceCsp

    Content Security Policy configuration for UI resources.

    domain?: string

    Dedicated origin for view sandbox.

    Useful when views need stable, dedicated origins for OAuth callbacks, CORS policies, or API key allowlists.

    Host-dependent: The format and validation rules for this field are determined by each host. Servers MUST consult host-specific documentation for the expected domain format. Common patterns include:

    • Hash-based subdomains (e.g., {hash}.claudemcpcontent.com)
    • URL-derived subdomains (e.g., www-example-com.oaiusercontent.com)

    If omitted, host uses default sandbox origin (typically per-conversation).

    "a904794854a047f6.claudemcpcontent.com"

    "www-example-com.oaiusercontent.com"
    permissions?: McpUiResourcePermissions

    Sandbox permissions requested by the UI resource.

    prefersBorder?: boolean

    Visual boundary preference - true if view prefers a visible border.

    Boolean requesting whether a visible border and background is provided by the host. Specifying an explicit value for this is recommended because hosts' defaults may vary.

    • true: request visible border + background
    • false: request no visible border + background
    • omitted: host decides border

    Settings

    Member Visibility

    On This Page

    Properties