interactive_feedback
Open a Web UI to collect interactive user feedback. Use it to confirm decisions, present summaries, and ask questions during AI workflows, avoiding unnecessary tool calls.
Instructions
Open a Web UI to collect interactive feedback from the user.
This tool is the PRIMARY communication channel with the user. The full list of "when to call" scenarios lives in the project's gl-mcp-feedback user rules; this docstring only covers the runtime contract that the tool itself enforces.
Strict prohibitions:
- While this tool is available, DO NOT invoke Cursor's built-in
AskQuestion. Route every question through summary as a
numbered list.
- DO NOT end the turn with a plain-text reply when there is
substantive content for the user to read. Put it in summary.
- When the user skips without feedback, re-call this tool to ask
why; only stop on explicit termination
(结束 / 不用了 / stop / done).
- Allowed parameters: project_directory, summary,
title, timeout. Names like question / choices /
options belong to AskQuestion and will fail schema
validation here.
summary writing rules:
- Markdown: headings (##), lists, tables, code fences, bold for
key decisions. Include modified file paths and explicit
questions when applicable.
- NEVER pass an empty string or the placeholder phrase
我已完成了您请求的任务。 — runtime validation rejects them
and you must re-call with a real summary.
title writing rules:
- Optional, ≤30 chars headline shown in the browser tab and
summary header. Leave empty when summary is
self-explanatory.
- Examples: 需要你提供更多信息 / 修复完成，请验证 /
实现方案确认.
Args:
project_directory: Absolute or relative project path. Defaults to cwd.
summary: Required Markdown summary. No empty string, no placeholder.
title: Optional short headline for the Web UI tab and summary header.
timeout: Seconds to wait for user feedback. Keep >= 600.
Returns: ToolResult: TextContent with the user's text feedback plus MCPImage objects for any uploaded images. An empty result means the user skipped — re-call to ask why.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | No | Optional short headline (max ~30 chars) for this feedback round, displayed in the browser tab and at the top of the AI summary panel. Should be concise (e.g. "需要你提供更多信息", "修复完成，请验证"). Leave empty when there's no good headline. | |
| summary | No | Markdown summary of the AI's current work / plan / question, rendered in the Web UI. MUST be filled in with substantive content; empty strings and placeholder phrases (e.g. "我已完成了您请求的任务。") are rejected at runtime. | |
| timeout | No | Seconds to wait for user feedback. Keep >= 600. | |
| project_directory | No | Project directory path. | . |