MCP config schema doesn't recognize 'streamable-http' transport type

Resolved 💬 3 comments Opened Apr 9, 2026 by jameswnl Closed Apr 9, 2026

Summary

/doctor reports an MCP server config as invalid when using "type": "streamable-http", which is the current standard transport defined in the MCP Specification 2025-11-25.

Steps to Reproduce

  1. Configure an MCP server in ~/.claude.json with streamable-http transport:

``json
"mcpServers": {
"example": {
"type": "streamable-http",
"url": "http://localhost:8888/mcp/"
}
}
``

  1. Run /doctor

Observed

[Failed to parse] User config (available in all your projects)
Location: ~/.claude.json
 └ [Error] mcpServers.example: Does not adhere to MCP server configuration schema

Expected

streamable-http should be recognized as a valid transport type. Per the MCP spec 2025-11-25:

The protocol currently defines two standard transport mechanisms for client-server communication: 1. stdio 2. Streamable HTTP

The previous sse (HTTP+SSE) transport is explicitly deprecated:

This replaces the HTTP+SSE transport from protocol version 2024-11-05.

Environment

  • Claude Code 2.1.97 (native)
  • macOS

View original on GitHub ↗

This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗