Apply suggestions from Connor

tadasant · connor4312 · web-flow · commit d948cb569cf3 · 2025-10-14T05:37:40.000-07:00
Co-authored-by: Connor Peet &lt;connor@peet.io&gt;
diff --git a/docs/reference/server-json/generic-server-json.md b/docs/reference/server-json/generic-server-json.md
@@ -743,7 +743,7 @@ This example demonstrates URL templating for local/package servers, where variab
       "version": "1.0.0",
       "transport": {
         "type": "streamable-http",
-        "url": "http://localhost:{port}/mcp"
+        "url": "http://localhost:{--port}/mcp"
       },
       "packageArguments": [
         {
@@ -759,4 +759,4 @@ This example demonstrates URL templating for local/package servers, where variab
 }
 ```
 
-The `{port}` variable in the URL references either the `--port` argument name or the `port` valueHint from packageArguments. When the package runs with `--port 8080`, the URL becomes `http://localhost:8080/mcp`.
+The `{--port}` variable in the URL references the `--port` argument `name` from packageArguments. For positional arguments, an argument with the `valueHint` of `port` could similarly be referened as `{port}`. When the package runs with `--port 8080`, the URL becomes `http://localhost:8080/mcp`.

Original file line number	Diff line number	Diff line change
`@@ -743,7 +743,7 @@ This example demonstrates URL templating for local/package servers, where variab`
`743`	`743`	`"version": "1.0.0",`
`744`	`744`	`"transport": {`
`745`	`745`	`"type": "streamable-http",`
`746`		`- "url": "http://localhost:{port}/mcp"`
	`746`	`+ "url": "http://localhost:{--port}/mcp"`
`747`	`747`	`},`
`748`	`748`	`"packageArguments": [`
`749`	`749`	`{`
`@@ -759,4 +759,4 @@ This example demonstrates URL templating for local/package servers, where variab`
`759`	`759`	`}`
`760`	`760`	```
`761`	`761`
`762`		-The `{port}` variable in the URL references either the `--port` argument name or the `port` valueHint from packageArguments. When the package runs with `--port 8080`, the URL becomes `http://localhost:8080/mcp`.
	`762`	+The `{--port}` variable in the URL references the `--port` argument `name` from packageArguments. For positional arguments, an argument with the `valueHint` of `port` could similarly be referened as `{port}`. When the package runs with `--port 8080`, the URL becomes `http://localhost:8080/mcp`.