Skip to content

feat: add app homepage resource metadata - #748

Open
Chipagosfinest wants to merge 1 commit into
modelcontextprotocol:mainfrom
Chipagosfinest:agent/add-app-homepage-metadata
Open

feat: add app homepage resource metadata#748
Chipagosfinest wants to merge 1 commit into
modelcontextprotocol:mainfrom
Chipagosfinest:agent/add-app-homepage-metadata

Conversation

@Chipagosfinest

Copy link
Copy Markdown

What changed

  • adds optional homepage metadata to McpUiResourceMeta
  • regenerates the Zod and JSON schemas
  • documents the field in the draft MCP Apps specification and resource examples
  • verifies registerAppResource preserves the metadata

Why

ui.domain configures a host-assigned sandbox origin; it is not the app's public homepage. MCP servers and public app sites may also live at different locations, so hosts currently have no portable metadata they can use to help users learn more about or return to an app.

The documentation explicitly treats homepage as an untrusted external link. It does not grant navigation permission or establish destination trust; hosts retain their normal URL validation, policy, and consent behavior.

Closes #703.

Validation

  • bun test src/server/index.test.ts src/generated/schema.test.ts
  • npm run build
  • npm run prettier
  • npm exec typedoc -- --treatValidationWarningsAsErrors --emit none
  • repository pre-commit hook: npm run build:all

@Chipagosfinest
Chipagosfinest marked this pull request as ready for review August 17, 2026 16:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

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

1 participant