From 2bc9074d20da3c010531330a1b9ccdc6d10b0ef5 Mon Sep 17 00:00:00 2001
From: dianed-square <73617011+dianed-square@users.noreply.github.com>
Date: Wed, 10 Dec 2025 15:40:21 -0800
Subject: [PATCH] docs: mcp elicitation (#6060)

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
---
 documentation/docs/guides/mcp-elicitation.md | 57 ++++++++++++++++++++
 1 file changed, 57 insertions(+)
 create mode 100644 documentation/docs/guides/mcp-elicitation.md

diff --git a/documentation/docs/guides/mcp-elicitation.md b/documentation/docs/guides/mcp-elicitation.md
new file mode 100644
index 00000000..b039a4c0
--- /dev/null
+++ b/documentation/docs/guides/mcp-elicitation.md
@@ -0,0 +1,57 @@
+---
+sidebar_position: 55
+title: MCP Elicitation
+sidebar_label: MCP Elicitation
+description: How extensions can request structured information from you during a task
+unlisted: true
+---
+
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+MCP Elicitation allows goose to pause and ask you for specific information when an extension needs it. Instead of guessing or making assumptions, goose presents a form requesting exactly what's needed to continue.
+
+This feature is automatically enabled in goose. When an extension that supports elicitation needs information from you, a form will appear in your session.
+
+:::info
+[MCP Elicitation](https://modelcontextprotocol.io/specification/draft/client/elicitation) is a feature in the Model Context Protocol. goose supports form mode requests.
+:::
+
+## How MCP Elicitation Works
+
+When an extension needs information, goose pauses and presents a form for you to fill out. You can submit your response or cancel the request.
+
+<Tabs groupId="interface">
+  <TabItem value="ui" label="goose Desktop" default>
+
+    A form appears inline in the chat with:
+    - Fields for the requested data
+    - Required fields marked with an asterisk (*)
+    - Default values you can accept or change
+    - A **Submit** button to send your response
+
+    After submitting, you'll see a confirmation message.
+
+  </TabItem>
+  <TabItem value="cli" label="goose CLI">
+
+    A prompt appears in your terminal with:
+    - A message explaining what information is needed (in cyan)
+    - Field names (in yellow) with descriptions
+    - Required fields marked with a red asterisk (*)
+    - Default values shown in brackets, e.g., `[default]`
+
+    Type your response for each field and press Enter. For yes/no questions, you'll see an interactive toggle.
+
+    To cancel the request, press `Ctrl+C`.
+
+  </TabItem>
+</Tabs>
+
+:::info Timeout
+Elicitation requests timeout after 5 minutes. If you don't respond in time, the request is cancelled and goose will continue without the information.
+:::
+
+## For Extension Developers
+
+Want to add elicitation to your own extensions? See the [MCP Elicitation specification](https://modelcontextprotocol.io/specification/draft/client/elicitation) to learn how MCP servers can request structured input from users.