An MCP server. It shows a form of questions to a person in their browser and returns the answers.
Single tool 'grill_with_form' has a well-structured JSON Schema with comprehensive parameter definitions, clear descriptions, and proper type constraints. The tool description is detailed (280+ chars) and explains the use case, mandatory questions, and optional 'Other' field behavior. Input schema includes nested object definitions for questions and choices with required fields and descriptions. However, output schema is not documented in the visible code, the tool returns an Outcome but the structure of answers is not formally specified. No tool annotations (readOnlyHint, destructiveHint, idempotentHint) are present. Error handling and recovery guidance are not visible in the tool definition itself.
Present a form of questions in the person's browser and wait for their answers. Use this when a whole round of questions exists at once — more than a couple, or options with long text, descriptions or code spans that need to be readable. For one or two quick questions mid-task, ask in the conversation instead of opening a browser. Every question is mandatory and there is one Submit: either all answers come back, or none do. Each question offers free-text 'Other' alongside its choices unless you set allowOther to false, and a question with no choices at all is answered purely as free text. Question and choice text may use `code`, **bold** and links.
Output schema not documented. Tool returns Outcome but structure of answers object is not formally specified. LLMs cannot plan downstream operations without knowing response fields.
No tool annotations present. Tool lacks readOnlyHint, destructiveHint, or idempotentHint metadata. Agents cannot determine if the tool is safe to retry or has side effects.
Error handling and recovery guidance not visible in tool definition. No documented error cases, retryability classification, or actionable error messages for LLM recovery.
Naming could be more verb-forward. 'grill_with_form' uses 'with' rather than a clear action verb like 'present_form' or 'collect_form_answers'. Current name is slightly ambiguous about the action.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 69 | 2026-07-28+ | v2 |