mcp-recall demonstrates solid tool design with consistent naming (verb_noun pattern), complete input schemas using Zod, and clear descriptions. All 6 tools follow the memory_* naming convention and include parameter descriptions. However, output schemas are not formally documented, responses are text-only without structured field definitions. Error handling is basic (returns isError flag but lacks recovery guidance). Parameter constraints are present but could be more explicit (e.g., limit bounds not stated). Tool composition is clean: each tool has one responsibility, and memory_search/memory_list support pagination. Descriptions average ~120 chars, meeting the 10-1024 baseline. No security issues detected (no secrets in params). Missing: output schema documentation, actionable error messages, and tool annotations (readOnlyHint/destructiveHint).

• Document output schemas for all tools. Define structured response objects with typed fields (e.g., memory_search returns {memories: [{id, content, similarity, tags, metadata, created_at}], total_count}). This enables LLMs to chain calls and extract data reliably.
• Add tool annotations: mark memory_search, memory_list, memory_stats with readOnlyHint=true; mark memory_delete with destructiveHint=true; mark memory_store and memory_update with idempotentHint=false (or true if content+tags+metadata are idempotent keys).
• Enhance error messages with recovery guidance. E.g., memory_delete: 'Memory {id} not found. Call memory_list() to see available memories.' memory_update: 'Memory {id} not found. Did you mean: [list of similar IDs]?'
• Add explicit bounds to numeric parameters. E.g., limit: z.number().min(1).max(100).default(10), offset: z.number().min(0). Document in descriptions: 'Maximum results (1 - 100, default: 10)'.
• Improve memory_stats description to explain use case: 'Retrieve database statistics (total memories, unique tags, date range). Call this to assess memory store size before bulk operations or to monitor growth over time.'

Inferred effective spec: <=2025-11-25.

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