MCP server that provides utility tools for UUID generation, MD5 hashing, and integer addition via a FastAPI backend
Three tools with basic verb naming (get_, compute_, add) but significant quality gaps. All tools have descriptions (10-50 chars, below the 194-char baseline), but lack depth on WHEN to use them or what they return. Input schemas are present with type info but parameter descriptions are minimal or missing. No output schema documentation. Error handling returns generic strings ('Unable to...') with no recovery guidance. Tools are simple utilities with no composition risk, but descriptions fail to meet LLM-optimization standards.
Compute a add operation on two intergers.
Compute hash in md5 format for a given text data.
Generate a uuid v4
Descriptions are too short (10-50 chars vs 194-char baseline). 'Generate a uuid v4' and 'Compute hash in md5 format...' lack context on WHEN to use each tool or what the output format is. LLMs cannot reliably select tools without richer descriptions.
No output schema documented. Tools return strings but LLMs don't know the format (UUID format, hex hash, integer as string). Downstream tools cannot reliably parse or chain results.
Error handling returns generic strings ('Unable to generate a uuid', 'Unable to compute hash') with no recovery guidance. LLMs cannot determine if the error is retryable, user-fixable, or fatal.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 48 | 2026-07-28+ | v2 |
Parameter descriptions are minimal. 'data: str the text to be hashed' is terse; 'left: int' and 'right: int' lack any context. No constraints on input ranges, formats, or valid values.
Tool names are generic action verbs without clear domain context. 'add' could mean append, concatenate, or arithmetic; 'compute_hash' doesn't specify the use case (integrity check, deduplication, etc.).