[DOCS] MCP SSE transport deprecation note missing from SDK reference pages

Documentation Type

Incorrect/outdated documentation

Documentation Location

https://code.claude.com/docs/en/mcp
https://platform.claude.com/docs/en/agent-sdk/mcp

Section/Topic

SSE transport configuration examples in the Agent SDK MCP documentation

Current Documentation

The Claude Code MCP page clearly states SSE is deprecated:

Note: SSE transport is deprecated. Please migrate to streamable HTTP transport.

However, the Agent SDK MCP documentation at platform.claude.com/docs/en/agent-sdk/mcp shows SSE transport examples without any deprecation notice:

``python from anthropic_agent_sdk import MCPServerSse server = MCPServerSse( name="sse-server", url="http://localhost:8000/sse", ) ``

What's Wrong or Missing?

The deprecation status of SSE transport is inconsistently documented:

A. Claude Code docs deprecate SSE
The mcp.md page has a clear deprecation note recommending migration to streamable HTTP.

B. Agent SDK docs show SSE without warning
The agent-sdk/mcp page includes working SSE examples but no deprecation notice, making it appear SSE is still a recommended approach.

Suggested Improvement

Add deprecation notice to the Agent SDK MCP documentation:

Before the SSE examples, add:

Note: SSE transport is deprecated. Consider using streamable HTTP transport instead. See the migration guide for details.

Or mark the MCPServerSse class itself as deprecated in the documentation.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:
| Page | Section | Status |
|------|---------|--------|
| https://code.claude.com/docs/en/mcp | SSE Transport | Has deprecation note ✓ |
| https://platform.claude.com/docs/en/agent-sdk/mcp | SSE examples | Missing deprecation note |

Total scope: 1 page needs update (agent-sdk/mcp)