Skip to content

Add ui.homepage field for redirecting to the app's homepage #703

Description

@khandrew1

Is your feature request related to a problem? Please describe.
There's no field for an app's actual homepage. ui.domain is a host-assigned sandbox origin, and the MCP server's own URL isn't necessarily the app's homepage (the app's public-facing site may be hosted separately from the MCP server). Hosts have no way to link users back to the app's real homepage.

Note that ChatGPT's Apps SDK already overloads _meta.ui.domain for something else: per their Build your MCP server docs, setting domain also controls whether the fullscreen "punch-out" button is shown, since ChatGPT renders the widget under <domain>.web-sandbox.oaiusercontent.com. That's a sandbox/rendering concern, separate from "where is the app's homepage."

Describe the solution you'd like
Add an optional homepage field to UIResourceMeta:

interface UIResourceMeta {
  // ...
  // The app's public homepage URL, which may differ from where the
  // MCP server itself is hosted.
  // Hosts MAY use this to let users navigate to the app's homepage.
  homepage?: string;
}

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions