Ask user tool

README.md

@@ -59,6 +59,12 @@ Allows the model to browse Wikipedia using its API.
 *   **Workflow**: Use `mode='summary'` (default) to get an overview and a Table of Contents. Use `mode='section'` with a linear index from the ToC to dive into specific details.
 *   **Features**: Returns raw Wikitext to save tokens, handles redirects, and automatically falls back to a search result list if a page is not found.
 
+### 🗣️ `ask_user`
+Asks the human operator a question and waits for their answer.
+*   **Best for**: Circuit-breaking when the model is missing critical context or needs guidance. Use this to interject when the model gets stuck.
+*   **Workflow**: The model calls `ask_user` with a `question` string. The question is printed to the MCP server's terminal, and the server blocks until you type an answer and press Enter.
+*   **Behavior**: Blocks indefinitely — there is no timeout. The answer is returned to the model as the tool result.
+
 ---
 
 ## Installation & Requirements