MCP server for Get笔记 (GetNotes) API - provides tools for managing notes, tags, images, and knowledge topics
Scoring was not performed
Output schemas completely undocumented. No tool describes what fields are returned, their types, or structure. LLMs cannot plan follow-up calls or extract required IDs without experimentation.
Parameter descriptions are minimal (1-2 sentences max) and lack actionable constraints. Example: 'Note ID' with no mention of type, format, or valid range. LLMs cannot validate inputs or infer proper usage.
Parameter types are ambiguous ('number|string'). No guidance on which to use, what format (ISO date vs epoch?), or how IDs should be passed. Forces agent guessing.
No error handling or recovery guidance. GetNoteAPIError is caught internally but LLMs receive no actionable error messages. If a note is not found, agent gets nothing to guide next steps.
No pagination guidance in descriptions. list_notes and list_topics accept pagination params but don't document default limits, max page size, or what 'total_count' or 'has_more' looks like in response.
save_note mixes create and update operations with optional 'id' parameter. No description of idempotency guarantees or whether re-submitting the same note creates duplicates.
upload_image description mentions 'complete workflow' but doesn't state what fields are returned (image_id, access_url). Agents cannot determine what data to expect.
note_type parameter in save_note lacks validation. Description says 'plain_text, link, or img_text' but no enum constraint or error if invalid type is passed.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-22 | F | 0 | 2026-07-28+ | v2 |
| 2026-03-09 | F | 33 | - | v1 |