Update MCP reference docs

Signed-off-by: Christian Tzolov <[email protected]>

Author: tzolov

spring-ai-docs/src/main/antora/modules/ROOT/pages/api/mcp/mcp-stateless-server-boot-starter-docs.adoc

@@ -40,7 +40,9 @@ NOTE: Stateless servers don't support message requests to the MCP client (e.g.,
 
 == Configuration Properties
 
-All properties are prefixed with `spring.ai.mcp.server.stateless`:
+=== Common Properties
+
+All Common properties are prefixed with `spring.ai.mcp.server`:
 
 [options="header"]
 |===
@@ -56,11 +58,19 @@ All properties are prefixed with `spring.ai.mcp.server.stateless`:
 |`capabilities.prompt` |Enable/disable prompt capabilities |`true`
 |`capabilities.completion` |Enable/disable completion capabilities |`true`
 |`tool-response-mime-type` |Response MIME type per tool name |`-`
-|`mcp-endpoint` |Custom MCP endpoint path |`/mcp`
 |`request-timeout` |Request timeout duration |`20 seconds`
-|`disallow-delete` |Disallow delete operations |`false`
 |===
 
+=== Stateless Connection Properties
+
+All connection properties are prefixed with `spring.ai.mcp.server.streamable-http`:
+
+[options="header"]
+|===
+|Property |Description |Default
+|`mcp-endpoint` |Custom MCP endpoint path |`/mcp`
+|`disallow-delete` |Disallow delete operations |`false`
+|===
 
 == Features and Capabilities
 
@@ -193,16 +203,15 @@ public List<McpStatelessServerFeatures.SyncCompletionSpecification> myCompletion
 === Stateless Server Configuration
 [source,yaml]
 ----
-# Using spring-ai-starter-mcp-server-stateless-webflux
 spring:
   ai:
     mcp:
       server:
-        stateless:
-          name: stateless-mcp-server
-          version: 1.0.0
-          type: ASYNC
-          instructions: "This stateless server is optimized for cloud deployments"
+        name: stateless-mcp-server
+        version: 1.0.0
+        type: ASYNC
+        instructions: "This stateless server is optimized for cloud deployments"
+        streamable-http:          
           mcp-endpoint: /api/mcp
 ----
 

spring-ai-docs/src/main/antora/modules/ROOT/pages/api/mcp/mcp-stdio-sse-server-boot-starter-docs.adoc

@@ -65,7 +65,9 @@ Due to Spring Boot's default behavior, when both `org.springframework.web.servle
 
 == Configuration Properties
 
-All properties are prefixed with `spring.ai.mcp.server`:
+=== Common Properties
+
+All Common properties are prefixed with `spring.ai.mcp.server`:
 
 [options="header"]
 |===
@@ -85,10 +87,19 @@ All properties are prefixed with `spring.ai.mcp.server`:
 |`prompt-change-notification` |Enable prompt change notifications |`true`
 |`tool-change-notification` |Enable tool change notifications |`true`
 |`tool-response-mime-type` |Optional response MIME type per tool name. For example, `spring.ai.mcp.server.tool-response-mime-type.generateImage=image/png` will associate the `image/png` MIME type with the `generateImage()` tool name |`-`
+|`request-timeout` |Duration to wait for server responses before timing out requests. Applies to all requests made through the client, including tool calls, resource access, and prompt operations |`20 seconds`
+|===
+
+=== SSE Properties
+
+All SSE properties are prefixed with `spring.ai.mcp.server`:
+
+[options="header"]
+|===
+|Property |Description |Default
 |`sse-message-endpoint` |Custom SSE message endpoint path for web transport to be used by the client to send messages |`/mcp/message`
 |`sse-endpoint` |Custom SSE endpoint path for web transport |`/sse`
 |`base-url` |Optional URL prefix. For example, `base-url=/api/v1` means that the client should access the SSE endpoint at `/api/v1` + `sse-endpoint` and the message endpoint is `/api/v1` + `sse-message-endpoint` |`-`
-|`request-timeout` |Duration to wait for server responses before timing out requests. Applies to all requests made through the client, including tool calls, resource access, and prompt operations |`20 seconds`
 |`keep-alive-interval` |Connection keep-alive interval |`null` (disabled)
 |===
 

spring-ai-docs/src/main/antora/modules/ROOT/pages/api/mcp/mcp-streamable-http-server-boot-starter-docs.adoc

@@ -36,7 +36,9 @@ NOTE: They require xref:api/mcp/mcp-client-boot-starter-docs#_streamable_http_tr
 
 == Configuration Properties
 
-All properties are prefixed with `spring.ai.mcp.server.streamable-http`:
+=== Common Properties
+
+All common properties are prefixed with `spring.ai.mcp.server`:
 
 [options="header"]
 |===
@@ -55,19 +57,29 @@ All properties are prefixed with `spring.ai.mcp.server.streamable-http`:
 |`prompt-change-notification` |Enable prompt change notifications |`true`
 |`tool-change-notification` |Enable tool change notifications |`true`
 |`tool-response-mime-type` |Response MIME type per tool name |`-`
-|`mcp-endpoint` |Custom MCP endpoint path |`/mcp`
 |`request-timeout` |Request timeout duration |`20 seconds`
+|===
+
+=== Streamable-HTTP Properties
+
+All streamable-HTTP properties are prefixed with `spring.ai.mcp.server.streamable-http`:
+
+[options="header"]
+|===
+|Property |Description |Default
+|`mcp-endpoint` |Custom MCP endpoint path |`/mcp`
 |`keep-alive-interval` |Connection keep-alive interval |`null` (disabled)
+|`disallow-delete` |Disallow delete operations |`false`
 |===
 
 == Features and Capabilities
 
 The MCP Server supports four main capability types that can be individually enabled or disabled:
 
-- **Tools** - Enable/disable tool capabilities with `spring.ai.mcp.server.streamable-http.capabilities.tool=true|false`
-- **Resources** - Enable/disable resource capabilities with `spring.ai.mcp.server.streamable-http.capabilities.resource=true|false`
-- **Prompts** - Enable/disable prompt capabilities with `spring.ai.mcp.server.streamable-http.capabilities.prompt=true|false`
-- **Completions** - Enable/disable completion capabilities with `spring.ai.mcp.server.streamable-http.capabilities.completion=true|false`
+- **Tools** - Enable/disable tool capabilities with `spring.ai.mcp.server.capabilities.tool=true|false`
+- **Resources** - Enable/disable resource capabilities with `spring.ai.mcp.server.capabilities.resource=true|false`
+- **Prompts** - Enable/disable prompt capabilities with `spring.ai.mcp.server.capabilities.prompt=true|false`
+- **Completions** - Enable/disable completion capabilities with `spring.ai.mcp.server.capabilities.completion=true|false`
 
 All capabilities are enabled by default. Disabling a capability will prevent the server from registering and exposing the corresponding features to clients.
 
@@ -307,15 +319,17 @@ NOTE: Currently, for streamable-http servers, the keep-alive mechanism is availa
 spring:
   ai:
     mcp:
-      server:
+      server:        
+        name: streamable-mcp-server
+        version: 1.0.0
+        type: SYNC
+        instructions: "This streamable server provides real-time notifications"
+        resource-change-notification: true
+        tool-change-notification: true
+        prompt-change-notification: true
         streamable-http:
-          name: streamable-mcp-server
-          version: 1.0.0
-          type: SYNC
-          instructions: "This streamable server provides real-time notifications"
-          resource-change-notification: true
-          tool-change-notification: true
-          prompt-change-notification: true
+          mcp-endpoint: /api/mcp
+          keep-alive-interval: 30s
 ----