Single tool 'add-note' has a basic schema and minimal description. The tool name lacks a clear action verb (should be 'create_note' or 'save_note'). Description is only 14 characters ('Add a new note'), below the 20-char minimum for scoring above 0-20 range. Input schema is present with proper types (string for name and content, both required), but lacks parameter descriptions, LLMs cannot infer what 'name' and 'content' mean without explicit guidance. No output schema documented. No error handling guidance. Tool performs a write operation but description does not state this. Prompts and resources are implemented but not evaluated here.
Add a new note
Tool name 'add-note' lacks action verb clarity. Should be 'create_note' or 'save_note' to signal intent. Current name is ambiguous about whether it creates, updates, or appends.
Tool description is only 14 characters ('Add a new note'), below the 20-char minimum. Does not state that this is a write operation, when to use it, or what it returns. LLMs cannot determine selection criteria.
Input parameters 'name' and 'content' have no descriptions. LLMs cannot infer what 'name' means (note title? identifier? display name?) or what 'content' should contain (plain text? markdown? max length?).
No output schema documented. Tool returns TextContent with a success message, but LLMs do not know what fields to expect or how to chain this to downstream tools.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 33 | 2026-07-28+ | v2 |
No error handling guidance. If 'name' is empty, duplicate, or invalid, the tool raises ValueError but does not tell the LLM what to do next or how to self-correct.