An MCP server for managing sticky notes with add, read, and summarization capabilities
Two tools with basic descriptions and minimal schemas. add_note has a single string parameter with description; read_notes has no parameters. Both descriptions are present but brief (34-56 chars, below the 50-200 char LLM-optimized baseline). No output schemas documented. No error handling guidance, no parameter constraints, no idempotency hints. Tool names follow verb_noun convention (add_, read_) but lack context about side effects and recovery paths. No validation, no pagination, no structured output specification.
Append a new note to the sticky note file.
Read and return all the notes from the sticky note file.
No output schemas documented for either tool. LLMs cannot infer return structure or plan downstream calls. add_note returns a string confirmation; read_notes returns a string of notes or default message, neither is formally specified.
Descriptions are too brief (34-56 chars vs 50-200 char baseline). 'Append a new note to the sticky note file' lacks context on when to use this vs alternatives, what happens on error, or idempotency guarantees.
No error handling guidance. If the notes file is inaccessible or write fails, the tool returns a generic error. LLMs have no recovery path, should specify 'retryable' vs 'user-fixable' and suggest next steps.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 40 | 2026-07-28+ | v2 |
add_note modifies state (writes to file) but description does not explicitly state this is a destructive/side-effecting operation. Agents need to know which calls are safe to retry.