MCP config: streamableHttp transport type fails schema validation in /doctor

Resolved 💬 2 comments Opened Apr 3, 2026 by rororowyourboat Closed Apr 3, 2026

Summary

When a .mcp.json file contains an MCP server entry with "type": "streamableHttp", the /doctor command reports a schema validation error even though streamableHttp is a valid MCP transport type per the spec.

Steps to Reproduce

  1. Create a .mcp.json with a streamableHttp server entry:

``json
{
"mcpServers": {
"unity": {
"type": "streamableHttp",
"url": "http://localhost:27183/mcp/"
}
}
}
``

  1. Run /doctor in Claude Code

Expected Behavior

streamableHttp should be recognized as a valid transport type, or at minimum the error message should clarify that it is not yet supported.

Actual Behavior

[Failed to parse] Project config (shared via .mcp.json)
 └ [Error] mcpServers.unity: Does not adhere to MCP server configuration schema

Environment

  • Claude Code CLI
  • Platform: Linux (Ubuntu 24.04)
  • The streamableHttp transport is part of the MCP spec but appears to not be supported by Claude Code's config schema validator

View original on GitHub ↗

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