sdl-mcp 0.11.8 → 0.11.10

package/README.md

@@ -67,14 +67,25 @@ SDL-MCP fixes this. It indexes your codebase into a searchable **symbol graph**
 ```bash
 # Install (requires Node.js 24+)
 npm install -g sdl-mcp
+# Plain npm installs run lifecycle scripts in the background, so run
+# `sdl-mcp init` after install. Use `--foreground-scripts` only when you
+# specifically want npm to show the install-time wizard and lifecycle output.
 
-# Initialize, auto-detect languages, index your repo, and run health checks
+# Non-interactive setup: initialize, auto-detect languages, index, and run health checks
 sdl-mcp init -y --auto-index
 
 # Start the MCP server for your coding agent
 sdl-mcp serve --stdio
 ```
 
+For a clean foreground installer flow, use the tiny wrapper package:
+
+```bash
+npx create-sdl-mcp
+```
+
+Run `npx create-sdl-mcp --update` for the fast update path: it installs the server binaries, skips repo setup, and prints the repo-init commands to run later.
+
 Point your MCP client at the server and the agent gains access to SDL-MCP's current configured surface. By default that is exclusive Code Mode; set `codeMode.exclusive: false` when you want Code Mode plus the regular flat or gateway tools in one session.
 
 > **npx users:** Replace `sdl-mcp` with `npx --yes sdl-mcp@latest` in all commands above.

package/config/sdlmcp.config.example.json

@@ -288,7 +288,8 @@
   },
   "gateway": {
     "enabled": true,
-    "emitLegacyTools": false
+    "emitLegacyTools": false,
+    "toolNameFormat": "canonical"
   },
   "httpAuth": {
     "enabled": false,

package/config/sdlmcp.config.schema.json

@@ -1660,11 +1660,18 @@
           "type": "boolean",
           "description": "When gateway is enabled, also register the 25 legacy tool names for backward compatibility. Deprecated: will be removed in a future version.",
           "default": false
+        },
+        "toolNameFormat": {
+          "type": "string",
+          "enum": ["canonical", "openai"],
+          "description": "Tool name format advertised to MCP clients. Use openai to replace dots with underscores for strict tool-name validators.",
+          "default": "canonical"
         }
       },
       "default": {
         "enabled": true,
-        "emitLegacyTools": false
+        "emitLegacyTools": false,
+        "toolNameFormat": "canonical"
       }
     },
     "httpAuth": {