An MCP server for managing notes with capabilities to add, read, and search notes
Server has 4 tools with basic verb-noun naming (add_note, read_all_notes, read_latest_notes, read_indexed_notes). Descriptions exist but are minimal (10-50 chars, well below the 194-char baseline). Input schemas are present with type declarations but lack parameter descriptions, a critical gap. No output schemas documented. Error handling is minimal; tools return generic strings rather than actionable error guidance. No tool annotations (readOnlyHint, destructiveHint). The add_note tool modifies state but description does not explicitly state this. Overall, definitions are skeletal, sufficient to register but insufficient for LLM-driven tool selection and error recovery.
This function appends a new note to the notebook file
This function reads all the note contents and returns it
This function reads note by indicated index. Least accepted index is 1.
This function reads the lastest note contents and returns it
Parameter descriptions missing. The 'message' param in add_note and 'index' param in read_indexed_notes have no descriptions explaining what values are valid, expected format, or constraints.
Output schemas not documented. Tools return strings but LLMs cannot infer structure, pagination, or chaining IDs. No documentation of what fields/format to expect.
Descriptions too brief (10-50 chars vs 194-char baseline). 'This function reads all the note contents and returns it' lacks context on when to use vs read_latest_notes, what happens on empty notebook, or whether results are paginated.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 46 | 2026-07-28+ | v2 |
No tool annotations. add_note is destructive (writes to file) but lacks destructiveHint. read_* tools are read-only but lack readOnlyHint. Agents cannot infer safety/retry semantics.
Error handling returns generic strings ('No Note yet!', 'Note not saved!') instead of actionable guidance. LLMs cannot determine if error is retryable, user-fixable, or fatal.