Model Context Protocol server exposing the MYAPP API to LLM clients
Five tools with basic schemas and descriptions, but significant gaps in parameter documentation and output schema clarity. All tools have descriptions (10-30 chars), but most are too terse to guide LLM selection. Input schemas present but lack descriptions for parameters. No output schemas documented. Error handling and recovery guidance absent. Naming follows verb_noun convention (get_, list_, create_, delete_) which is correct, but descriptions do not explain WHEN to use each tool or what distinguishes similar operations (e.g., get_item vs list_items). No tool annotations (readOnlyHint, destructiveHint) despite clear risk levels. Pagination implemented on list_items but not documented in description.
Create an item
Delete an item by id
Get a single item by id
Get server health/status
List items (paginated)
Descriptions are too terse (10-30 chars). LLMs cannot determine when to select get_item vs list_items, or why create_item exists. Baseline for A+ tools is 50-200 chars with WHAT/WHEN/WHY context.
No output schemas documented. LLMs cannot plan downstream calls or extract required fields. get_item and list_items must document return structure (e.g., item fields, pagination metadata).
Parameter descriptions missing. 'page' and 'page_size' in list_items lack descriptions explaining valid ranges, defaults, or behavior. 'id' and 'name' parameters lack context (e.g., is id a database PK? Is name unique?).
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 47 | <=2025-11-25 | v2 |
No tool annotations (readOnlyHint, destructiveHint, idempotentHint). delete_item is marked DESTRUCTIVE but lacks annotation. get_system_status, list_items, get_item are READ_ONLY but not annotated. Agents cannot infer safety without annotations.
No error handling or recovery guidance. If delete_item fails (e.g., item not found, permission denied), LLM receives no actionable next step. No confirmation/dry-run for destructive operations.