The TiddlyWiki MCP server defines 5 tools with reasonable naming (verb-noun format) and parameter schemas. However, several quality gaps prevent a higher score: (1) Tool descriptions are adequate but brief (avg ~80 chars), lacking the 10-200 char optimization window guidance; (2) Parameter descriptions are minimal and lack constraints (enums, ranges, format specifications); (3) Output schemas are not explicitly documented in the server definition; (4) No tool annotations (readOnlyHint/destructiveHint) despite having tools with clear risk profiles; (5) Error handling guidance is absent. The test file confirms tools work but reveals incomplete schema documentation. Naming is consistent (read_, list_, search_, write_, delete_) and self-documenting. Per-tool analysis follows.

• Add tool annotations: set readOnlyHint=true for read_tiddler, list_tiddlers, search_tiddlers; set destructiveHint=true for delete_tiddler; set idempotentHint=true for write_tiddler (if confirmed idempotent) or document non-idempotent behavior.
• Document output schemas inline or in a schema registry. For each tool, specify: field names, types (string, number, array, object), required vs optional, and any constraints. Example for read_tiddler: {title: string, text: string, fields: {[key]: string}, modified: ISO8601-string}.
• Add format/constraint guidance to parameters: (1) limit: add minimum=1, maximum=1000; (2) type in write_tiddler: add enum=['text/markdown', 'text/vnd.tiddlywiki', 'application/json'] or reference TiddlyWiki's valid MIME types; (3) title: add minLength=1, maxLength=100 or relevant bounds; (4) filter: add description of valid TiddlyWiki filter syntax and common examples.
• Enhance descriptions with context: (1) write_tiddler should state 'Creates a new tiddler or updates an existing one. Idempotent: calling twice with the same title and text is safe.' (2) delete_tiddler should warn: 'Permanently deletes the tiddler. This action cannot be undone.' (3) list_tiddlers should clarify: 'Returns all non-system tiddlers by default; set includeSystem=true to include tiddlers starting with $:/'.
• Add error guidance: For each tool, document likely failure modes and recovery steps. Example for read_tiddler: 'Returns error 404 if tiddler not found. Try search_tiddlers to find alternative titles.' For delete_tiddler: 'Returns error 409 if tiddler is protected; check tiddler.protected field from read_tiddler before attempting delete.'

Inferred effective spec: 2025-06-18+.

• Relies on Stateful initialize / Mcp-Session-Id (removed; protocol is stateless) - make each request self-contained