modelcontextprotocol/registry
Watch
1
0
Fork
You've already forked registry
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
registry/docs
History
Repository files (latest commit first)
Filename Latest commit message Latest commit date
adam jones 843783ac18
 docs: make streamable-http the primary transport in examples (#602) 
## Summary
Changes `streamable-http` to be the recommended and primary transport
type in documentation examples, while keeping SSE as a secondary option
during the preview period.

## Changes
- ✅ Update all primary remote server examples to use `streamable-http`
- ✅ Reorder multi-transport examples to show `streamable-http` first
- ✅ Add note that SSE is deprecated but still supported during preview
- ✅ Update transport protocol requirements text to indicate
`streamable-http` (recommended) and `sse` (deprecated)

## Context
As noted in issue #487, the docs were using SSE as the primary example
despite it being deprecated in the MCP specification (2025-06-18) in
favor of streamable HTTP. This PR aligns the documentation with the spec
while maintaining backward compatibility information for the preview
period.

Per maintainer feedback on the issue:
- SSE is still supported during the preview phase
- Eventually SSE support will be removed
- The community would benefit from consistent messaging about the
preferred transport

## Files Changed
- `docs/guides/publishing/publish-server.md` - Main publishing guide
- `docs/reference/server-json/generic-server-json.md` - Reference
documentation with examples

## Approach
This takes a balanced approach:
- Makes streamable-http the clear primary/recommended option
- Keeps SSE documented as supported during preview (not hidden)
- Adds explicit note about deprecation status
- Minimal changes, focused on examples and ordering

Fixes #487

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Co-authored-by: Claude <noreply@anthropic.com>
2025-10-03 17:34:20 +01:00
..
explanations docs: Force white background for ecosystem diagram (#564) 2025-09-28 21:54:22 +03:00
guides docs: make streamable-http the primary transport in examples (#602) 2025-10-03 17:34:20 +01:00
reference docs: make streamable-http the primary transport in examples (#602) 2025-10-03 17:34:20 +01:00
community-projects.md Add MCP registry cheat sheet project link (#600) 2025-10-02 16:29:14 +01:00
README.md Add community-projects reference document (#569) 2025-09-29 21:38:46 +01:00
terms.md Add terms of service documentation (#346) 2025-09-05 00:35:24 +01:00

README.md

MCP Registry Documentation

The MCP registry provides MCP clients with a list of MCP servers, like an app store for MCP servers.

I want to...

Documentation Index