Skip to content

chore: stable spec release 2026-01-26 and SDK v1.0.0#362

Merged
ochafik merged 7 commits intomainfrom
ochafik/stable-spec-2026-01-26
Jan 26, 2026
Merged

chore: stable spec release 2026-01-26 and SDK v1.0.0#362
ochafik merged 7 commits intomainfrom
ochafik/stable-spec-2026-01-26

Conversation

@ochafik
Copy link
Contributor

@ochafik ochafik commented Jan 26, 2026

Summary

This PR creates a stable specification release and bumps the SDK to version 1.0.0.

Changes

Stable Specification Release (2026-01-26)

  • Copy specification from specification/draft/apps.mdx to specification/2026-01-26/apps.mdx
  • Update status from "Draft" to "Stable (2026-01-26)"
  • Add specification version table to README
  • Update Resources section with links to both stable and draft specs

SDK Version Bump

  • Update main package version from 0.4.2 to 1.0.0
  • Update all example package versions to 1.0.0
  • Regenerate package-lock.json

@ochafik ochafik marked this pull request as ready for review January 26, 2026 16:13
@pkg-pr-new
Copy link

pkg-pr-new bot commented Jan 26, 2026

Open in StackBlitz

@modelcontextprotocol/ext-apps

npm i https://pkg.pr.new/modelcontextprotocol/ext-apps/@modelcontextprotocol/ext-apps@362

@modelcontextprotocol/server-basic-react

npm i https://pkg.pr.new/modelcontextprotocol/ext-apps/@modelcontextprotocol/server-basic-react@362

@modelcontextprotocol/server-basic-vanillajs

npm i https://pkg.pr.new/modelcontextprotocol/ext-apps/@modelcontextprotocol/server-basic-vanillajs@362

@modelcontextprotocol/server-budget-allocator

npm i https://pkg.pr.new/modelcontextprotocol/ext-apps/@modelcontextprotocol/server-budget-allocator@362

@modelcontextprotocol/server-cohort-heatmap

npm i https://pkg.pr.new/modelcontextprotocol/ext-apps/@modelcontextprotocol/server-cohort-heatmap@362

@modelcontextprotocol/server-customer-segmentation

npm i https://pkg.pr.new/modelcontextprotocol/ext-apps/@modelcontextprotocol/server-customer-segmentation@362

@modelcontextprotocol/server-map

npm i https://pkg.pr.new/modelcontextprotocol/ext-apps/@modelcontextprotocol/server-map@362

@modelcontextprotocol/server-pdf

npm i https://pkg.pr.new/modelcontextprotocol/ext-apps/@modelcontextprotocol/server-pdf@362

@modelcontextprotocol/server-scenario-modeler

npm i https://pkg.pr.new/modelcontextprotocol/ext-apps/@modelcontextprotocol/server-scenario-modeler@362

@modelcontextprotocol/server-shadertoy

npm i https://pkg.pr.new/modelcontextprotocol/ext-apps/@modelcontextprotocol/server-shadertoy@362

@modelcontextprotocol/server-sheet-music

npm i https://pkg.pr.new/modelcontextprotocol/ext-apps/@modelcontextprotocol/server-sheet-music@362

@modelcontextprotocol/server-system-monitor

npm i https://pkg.pr.new/modelcontextprotocol/ext-apps/@modelcontextprotocol/server-system-monitor@362

@modelcontextprotocol/server-threejs

npm i https://pkg.pr.new/modelcontextprotocol/ext-apps/@modelcontextprotocol/server-threejs@362

@modelcontextprotocol/server-transcript

npm i https://pkg.pr.new/modelcontextprotocol/ext-apps/@modelcontextprotocol/server-transcript@362

@modelcontextprotocol/server-video-resource

npm i https://pkg.pr.new/modelcontextprotocol/ext-apps/@modelcontextprotocol/server-video-resource@362

@modelcontextprotocol/server-wiki-explorer

npm i https://pkg.pr.new/modelcontextprotocol/ext-apps/@modelcontextprotocol/server-wiki-explorer@362

commit: 9747c38

@ochafik ochafik requested a review from idosal January 26, 2026 16:15
- Use git mv to copy specification from draft to specification/2026-01-26/apps.mdx (preserves history)
- Update status from 'Draft' to 'Stable (2026-01-26)'
- Add specification version table to README
- Update Resources section with links to both stable and draft specs
- Update main package version from 0.4.2 to 1.0.0
- Update all example package versions to 1.0.0
- Regenerate package-lock.json
@ochafik ochafik force-pushed the ochafik/stable-spec-2026-01-26 branch from 50e544b to 0202070 Compare January 26, 2026 16:23
idosal
idosal previously approved these changes Jan 26, 2026
Copy link
Collaborator

@idosal idosal left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

👌

Copy link
Member

@jonathanhefner jonathanhefner left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think we might also want to update:

  • "https://github.com/modelcontextprotocol/ext-apps/blob/main/specification/draft/apps.mdx",
  • The occurrences in docs/overview.md, e.g.:
    See the [Client<>Server Capability Negotiation](https://github.com/modelcontextprotocol/ext-apps/blob/main/specification/draft/apps.mdx#clientserver-capability-negotiation) section of the specification.
  • **Spec:** [ui/notifications/tool-input-partial](https://github.com/modelcontextprotocol/ext-apps/blob/main/specification/draft/apps.mdx#streaming-tool-input)
    (though I'm inclined to change that section... but that can wait until after v1)

- Add 'Protocol Version: 2026-01-26' to spec header
- Update LATEST_PROTOCOL_VERSION from '2025-11-21' to '2026-01-26'
- Update spec examples to use '2026-01-26' protocol version
- Add '2025-11-21' to SUPPORTED_PROTOCOL_VERSIONS for backwards compatibility
- Update typedoc.config.mjs navigation link
- Update docs/overview.md spec links (10 occurrences)
- Update plugins/mcp-apps/skills/create-mcp-app/SKILL.md spec link
- Update src/spec.types.ts @see links
- Update AGENTS.md spec path
- Regenerate src/generated/schema.ts with updated links
- Remove backwards compatibility version (2025-11-21) - this is the first stable release
- Remove redundant 'Protocol Version' header - spec version IS the protocol version
@ochafik
Copy link
Contributor Author

ochafik commented Jan 26, 2026

Note on git history: The stable spec file shows limited history in GitHub's blame/history views because git doesn't support true "copy with history" - it only infers renames based on content similarity, and GitHub's UI doesn't follow that inference. Full edit history is preserved in specification/draft/apps.mdx and can be viewed locally with git log --follow specification/2026-01-26/apps.mdx. Added a comment at the top of the stable spec pointing to the draft for reference.

@ochafik
Copy link
Contributor Author

ochafik commented Jan 26, 2026

Updated lots of draft references, @idosal @jonathanhefner ptal :-)

@ochafik ochafik merged commit 298e884 into main Jan 26, 2026
17 of 19 checks passed
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.

3 participants