A web application that generates conversation starter questions for couples or close friends using Claude AI via the Anthropic API
Single tool 'generateQuestions' has a basic description but critically lacks a complete input schema in the visible source. The description is adequate (89 chars) but the schema shows only 'count' parameter with minimal type info. No output schema is documented. The tool name lacks a clear action verb prefix (should be 'generate_questions' per verb_noun convention). No error handling guidance, no parameter constraints (e.g., min/max for count), and no documentation of the response structure. The implementation is inferred from llmService.ts rather than explicitly registered in an MCP server definition file, which caps the score further.
Generate conversation starter questions for couples or close friends. Returns an array of questions with id, text, and optional category fields.
No explicit MCP server registration visible. Tool definition appears to be inferred from llmService.ts rather than explicitly registered via MCP SDK.
Input schema incomplete. Only 'count' parameter shown with type 'number' but no min/max bounds, no default value documented, and no validation constraints.
Output schema not documented. Tool description mentions 'array of questions with id, text, and optional category fields' but no formal schema definition is provided. LLMs cannot reliably parse unstructured output.
Tool name 'generateQuestions' does not follow verb_noun convention. Should be 'generate_questions' (snake_case with action verb prefix). Current camelCase naming is non-standard for MCP tools.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 31 | 2026-07-28+ | v2 |
No error handling guidance. Tool description does not explain what happens on failure, whether errors are retryable, or what the LLM should do if generation fails. Fallback logic exists in App.tsx but is not documented in tool contract.