Skip to content

feat(server): add getUiCapability helper for capability negotiation #313

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
ochafik merged 11 commits into from
Jan 23, 2026
Merged

feat(server): add getUiCapability helper for capability negotiation #313

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
11 commits
Select commit Hold shift + click to select a range
d9a14ed
feat(server): add hasUiSupport/getUiCapability for experimental+exten…
ochafik Jan 20, 2026
8451dab
fix: update @types/node version in package-lock.json
ochafik Jan 20, 2026
730c4c2
docs(spec): clarify hosts SHOULD double-tag, servers SHOULD check both
ochafik Jan 20, 2026
25546e6
Merge remote-tracking branch 'origin/main' into ochafik/double-tag-ca…
ochafik Jan 21, 2026
ce43e79
chore: remove double-tagging recommendation, keep hasUiSupport helper
ochafik Jan 21, 2026
0f8176e
refactor(server): simplify to only getUiCapability, remove hasUiSupport
ochafik Jan 22, 2026
324f9ea
Merge remote-tracking branch 'origin/main' into ochafik/double-tag-ca…
ochafik Jan 22, 2026
cac9b09
fix: update @see link to getUiCapability
ochafik Jan 22, 2026
6b9e5de
refactor(server): inline ClientCapabilitiesWithExtensions type in get…
ochafik Jan 22, 2026
fcb5e54
refactor: move McpUiClientCapabilities to spec.types.ts
ochafik Jan 22, 2026
c19fdfb
Merge origin/main into ochafik/double-tag-capabilities
ochafik Jan 23, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
144 changes: 76 additions & 68 deletions package-lock.json
View file
Open in desktop

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

8 changes: 4 additions & 4 deletions specification/draft/apps.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1457,13 +1457,13 @@ Future versions may add additional settings:

#### Server Behavior

Servers SHOULD check client (host would-be) capabilities before registering UI-enabled tools:
Servers SHOULD check client capabilities before registering UI-enabled tools. The SDK provides the `getUiCapability` helper for this:

```typescript
const hasUISupport =
clientCapabilities?.extensions?.["io.modelcontextprotocol/ui"]?.mimeTypes?.includes("text/html;profile=mcp-app");
import { getUiCapability, RESOURCE_MIME_TYPE } from "@modelcontextprotocol/ext-apps/server";

if (hasUISupport) {
const uiCap = getUiCapability(clientCapabilities);
if (uiCap?.mimeTypes?.includes(RESOURCE_MIME_TYPE)) {
// Register tools with UI templates
server.registerTool("get_weather", {
description: "Get weather with interactive dashboard",
Expand Down
14 changes: 14 additions & 0 deletions src/generated/schema.json
View file
Open in desktop

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

Loading
Loading