registry/docs/reference
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
..
api fix(spec): registryType, identifier, version should be required fields (#548) 2025-09-29 21:32:50 +01:00
cli Introduce serverId, rename id to versionId (#465) 2025-09-21 15:00:09 +03:00
server-json docs: make streamable-http the primary transport in examples (#602) 2025-10-03 17:34:20 +01:00
faq.md Clarify the docs around open/closed source and public/private MCP servers (#573) 2025-09-29 22:29:26 +01:00
README.md Big docs tidy up in preparation for launch (#364) 2025-09-07 10:44:42 +01:00

Reference Documentation

Technical specifications and quick lookups for the MCP Registry.

API Reference

server.json Reference

CLI Reference

Quick Reference