Skip to content

Commit 377ef2f

Browse files
tadasantclaude
andcommitted
fix: Make base transport URL descriptions context-aware
The base StreamableHttpTransport and SseTransport descriptions were Package-specific but got inherited by RemoteTransport via allOf, causing incorrect documentation for the Remote context. Changes: - Update base URL descriptions to explain both Package and Remote contexts - Remove redundant URL overrides in RemoteTransport since base is now generic - Ensures correct documentation regardless of inheritance context Now the descriptions correctly explain: - Package context: Variables reference parent arguments/environment variables - Remote context: Variables reference transport's 'variables' object 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <[email protected]>
1 parent c90666f commit 377ef2f

File tree

1 file changed

+2
-13
lines changed

1 file changed

+2
-13
lines changed

docs/reference/server-json/server.schema.json

Lines changed: 2 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -367,7 +367,7 @@
367367
},
368368
"url": {
369369
"type": "string",
370-
"description": "URL template for the streamable-http transport. Variables in {curly_braces} can reference argument valueHints, argument names, or environment variable names from the parent Package. After variable substitution, this should produce a valid URI.",
370+
"description": "URL template for the streamable-http transport. Variables in {curly_braces} are resolved based on context: In Package context, they reference argument valueHints, argument names, or environment variable names from the parent Package. In Remote context, they reference variables from the transport's 'variables' object. After variable substitution, this should produce a valid URI.",
371371
"example": "https://api.example.com/mcp"
372372
},
373373
"headers": {
@@ -397,7 +397,7 @@
397397
"url": {
398398
"type": "string",
399399
"format": "uri",
400-
"description": "Server-Sent Events endpoint URL template. Variables in {curly_braces} can reference argument valueHints, argument names, or environment variable names from the parent Package. After variable substitution, this should produce a valid URI.",
400+
"description": "Server-Sent Events endpoint URL template. Variables in {curly_braces} are resolved based on context: In Package context, they reference argument valueHints, argument names, or environment variable names from the parent Package. In Remote context, they reference variables from the transport's 'variables' object. After variable substitution, this should produce a valid URI.",
401401
"example": "https://mcp-fs.example.com/sse"
402402
},
403403
"headers": {
@@ -433,11 +433,6 @@
433433
{
434434
"type": "object",
435435
"properties": {
436-
"url": {
437-
"type": "string",
438-
"description": "URL template for the streamable-http transport. Variables in {curly_braces} reference variable names from the 'variables' object. If variables are not provided, {curly_braces} should be treated as literal text. After variable substitution, this should produce a valid URI.",
439-
"example": "https://api.example.com/mcp/{tenant_id}"
440-
},
441436
"variables": {
442437
"type": "object",
443438
"description": "Configuration variables that can be referenced in URL template {curly_braces}. The key is the variable name, and the value defines the variable properties.",
@@ -457,12 +452,6 @@
457452
{
458453
"type": "object",
459454
"properties": {
460-
"url": {
461-
"type": "string",
462-
"format": "uri",
463-
"description": "Server-Sent Events endpoint URL template. Variables in {curly_braces} reference variable names from the 'variables' object. If variables are not provided, {curly_braces} should be treated as literal text. After variable substitution, this should produce a valid URI.",
464-
"example": "https://mcp-fs.example.com/sse/{tenant_id}"
465-
},
466455
"variables": {
467456
"type": "object",
468457
"description": "Configuration variables that can be referenced in URL template {curly_braces}. The key is the variable name, and the value defines the variable properties.",

0 commit comments

Comments
 (0)