A simple note-taking MCP server that allows adding and reading notes from a file
Two tools with minimal but present descriptions and basic schemas. add_note has a single string parameter with description; read_notes has no parameters. Both descriptions are under 100 chars and lack context on when to use each tool or what happens on error. No output schemas documented. No error handling guidance. No parameter constraints or validation hints. Naming is clear (verb_noun pattern) but descriptions are sparse. Missing idempotency guidance for add_note (write operation). No mention of file-based state or persistence model.
Add a new note to the notes file.
Read and return all notes from the notes file.
No output schema documented for either tool. LLMs cannot predict return structure or plan downstream operations.
Descriptions lack context on when to use each tool and what happens on error. 'Add a new note' and 'Read and return all notes' are minimal, no guidance on idempotency, file state, or error recovery.
add_note is a write operation but description does not state it modifies state. LLMs cannot determine if the call is safe to retry or has irreversible consequences.
No error handling guidance. If the notes file cannot be written or read, the tool returns a generic error with no recovery path for the LLM.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 56 | 2026-07-28+ | v2 |
STDIO transport only, not remotely accessible. Cannot be used by hosted MCP clients or integrated into production agent platforms.