AWS appstream2: Document close_session tool and expire_streaming_session parameter

Service: appstream2 · 2026-11-07 · Documentation low

File: appstream2/latest/developerguide/agent-access-mcp-server-tools.md

Summary

Adds documentation for the new `close_session` MCP tool, available in the stateless MCP protocol (2026-07-28), including the optional `expire_streaming_session` Boolean parameter (default false) that terminates the WorkSpaces Applications streaming session and triggers fleet autoscaling.

Security assessment

The change documents session lifecycle management for the MCP server: ending an MCP session and optionally expiring the underlying streaming session. Session termination has mild security-adjacent value (reducing lingering sessions/instances), but the text is functional tool reference with no vulnerability, credential, or access-control change.

Evidence

+Parameters: `expire_streaming_session` (optional, Boolean, default `false`). Set it to `true` to also expire the WorkSpaces Applications streaming session, which terminates the streaming instance and triggers the fleet's configured autoscaling policy. For more information about autoscaling, see [Fleet Auto Scaling for Amazon WorkSpaces Applications](./autoscaling.html).

Diff

diff --git a/appstream2/latest/developerguide/agent-access-mcp-server-tools.md b/appstream2/latest/developerguide/agent-access-mcp-server-tools.md
index 0d6a3b2..11dfd7f 100644
--- a//appstream2/latest/developerguide/agent-access-mcp-server-tools.md
+++ b//appstream2/latest/developerguide/agent-access-mcp-server-tools.md
@@ -148,0 +149,2 @@ The app switcher is available only when the fleet's **Stream view** is set to **
+The `close_session` tool is part of the stateless MCP protocol (version 2026-07-28). With the earlier MCP protocol versions, you end the session by closing the MCP client in your agent code, which sends an HTTP `DELETE` request instead. For more information, see [Session cleanup](./agent-access-mcp-server-session-cleanup.html).
+
@@ -170,0 +173,7 @@ Returns the following identifier fields as the tool result: `mcpSessionId`, `sta
+`close_session`
+    
+
+The agent calls this tool to end the current session. This closes the MCP session. By default, it does not expire the WorkSpaces Applications streaming session, and the streaming instance is preserved for reuse.
+
+Parameters: `expire_streaming_session` (optional, Boolean, default `false`). Set it to `true` to also expire the WorkSpaces Applications streaming session, which terminates the streaming instance and triggers the fleet's configured autoscaling policy. For more information about autoscaling, see [Fleet Auto Scaling for Amazon WorkSpaces Applications](./autoscaling.html).
+