docs: add TypeScript MCP elicitation examples

Author: gsird

src/content/docs/user-guide/concepts/tools/mcp-tools.mdx

@@ -492,9 +492,19 @@ For more information on elicitation, see the [MCP specification](https://modelco
 </Tab>
 <Tab label="TypeScript">
 
-```ts
-// Not supported in TypeScript
+### Elicitation
+
+An MCP server can request additional information from the user by sending an elicitation request. Set up an elicitation callback to handle these requests:
+
+```typescript
+--8<-- "user-guide/concepts/tools/mcp-tools.ts:elicitation_server"
 ```
+
+```typescript
+--8<-- "user-guide/concepts/tools/mcp-tools.ts:elicitation"
+```
+
+For more information on elicitation, see the [MCP specification](https://modelcontextprotocol.io/specification/draft/client/elicitation).
 </Tab>
 </Tabs>
 

src/content/docs/user-guide/concepts/tools/mcp-tools.ts

@@ -143,6 +143,79 @@ const transport = new StdioServerTransport()
 await server.connect(transport)
 // --8<-- [end:mcp_server]
 
+// --8<-- [start:elicitation_server]
+// @ts-nocheck — standalone snippet; duplicates imports from mcp_server snippet above
+// server.ts
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
+import { z } from 'zod'
+
+const elicitServer = new McpServer({
+  name: 'File Tools',
+  version: '1.0.0',
+})
+
+elicitServer.tool(
+  'delete_files',
+  'Delete the given files after getting user approval.',
+  {
+    paths: z.array(z.string()),
+  },
+  async ({ paths }) => {
+    const result = await elicitServer.server.elicitInput({
+      message: `Do you want to delete ${paths.join(', ')}?`,
+      requestedSchema: {
+        type: 'object',
+        properties: {
+          username: { type: 'string', description: 'Who is approving?' },
+        },
+        required: ['username'],
+      },
+    })
+
+    if (result.action !== 'accept') {
+      return { content: [{ type: 'text', text: `User ${result.action}ed deletion` }] }
+    }
+
+    // Perform deletion...
+    const username = (result.content as { username: string }).username
+    return { content: [{ type: 'text', text: `User ${username} approved deletion` }] }
+  }
+)
+
+await elicitServer.connect(new StdioServerTransport())
+// --8<-- [end:elicitation_server]
+
+// --8<-- [start:elicitation]
+// client.ts
+import type { ElicitationCallback } from '@strands-agents/sdk'
+
+const elicitationCallback: ElicitationCallback = async (_context, params) => {
+  console.log(`ELICITATION: ${params.message}`)
+  // Get user confirmation...
+  return {
+    action: 'accept',
+    content: { username: 'myname' },
+  }
+}
+
+const elicitClient = new McpClient({
+  transport: new StdioClientTransport({
+    command: 'npx',
+    args: ['tsx', '/path/to/server.ts'],
+  }),
+  elicitationCallback,
+})
+
+const agentElicit = new Agent({
+  tools: [elicitClient],
+})
+
+await agentElicit.invoke("Delete 'a/b/c.txt' and share the name of the approver")
+
+await elicitClient.disconnect()
+// --8<-- [end:elicitation]
+
 // --8<-- [start:tools_overview_example]
 // Create MCP client with stdio transport
 const mcpClientOverview = new McpClient({