Node.js based MCP User Feedback Collector supporting AI work report and user feedback collection with web interface and MCP tool integration
Single tool 'collect_feedback' with well-structured input schema and comprehensive description. The tool demonstrates strong parameter documentation with detailed requirements for the work_summary field. However, lacks explicit output schema documentation, error handling guidance, and tool annotations. The description is exceptionally long (800+ chars) which exceeds best practice but is justified by the critical nature of the work_summary requirements. Parameter naming follows verb_noun conventions ('collect_feedback'). Tool accepts natural identifiers (project_name, project_path) which aligns with chat-data-model patterns. The schema uses proper JSON Schema with type definitions and descriptions for all parameters.
Collect feedback from users about AI work. This tool opens a web interface for users to provide feedback. The 'work_summary' field is the PRIMARY and ONLY content displayed to users in the feedback UI. You MUST include ALL relevant information in this field as a comprehensive Markdown-formatted report. The UI renders Markdown, so use headings, tables, code blocks, and lists for better readability.
No output schema documented. Users cannot predict what the tool returns (success/error format, response fields, pagination if applicable).
No error handling guidance. Tool description lacks guidance on failure modes (e.g., what happens if work_summary is too short, project_path invalid, or UI timeout occurs) and what the LLM should do next.
Tool description is 800+ characters, exceeding the 10 - 1024 character guideline. While content is valuable, it should be condensed and moved to extended docs. Risk: wastes tokens on every tool invocation.
No tool annotations (readOnlyHint, destructiveHint, idempotentHint). The tool modifies state (WRITE risk declared) but lacks destructiveHint annotation, which prevents clients from applying appropriate safeguards.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-22 | C | 66 | <=2025-11-25 | v2 |
| 2026-03-09 | F | 0 | - | v1 |
No confirmation or dry-run pattern for destructive operation. Tool has WRITE risk but offers no confirm_before_execute mechanism to prevent accidental feedback submission.
Parameter work_summary lacks min/max length constraints and validation rules in the schema. Description states 'Minimum 500 characters' but this is not enforced as a JSON Schema constraint.