MemClaw exposes 24 tools with basic schemas and descriptions, but falls short of production quality. All tools have descriptions (10-50 chars, mostly terse), and input schemas are present with type definitions. However, descriptions lack LLM-optimization guidance (e.g., 'when to use', 'what it returns'), parameter descriptions are minimal, output schemas are undocumented, and error handling provides no recovery guidance. No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite clear risk levels. Naming is verb-forward (create, list, update, delete, add, remove) but some tools conflate concerns (e.g., 'add-urls' + 'add-doc' could be unified as 'add-resource'). Parameter validation rules are absent from descriptions. No pagination guidance in list tools despite accepting page/size params.

• Expand all descriptions to 50-200 chars. Include: what the tool does, when to use it (vs similar tools), what it returns, and any prerequisites. E.g., 'List all LiveDocs in your workspace. Returns short_id, name, description, and timestamps. Use this to discover available docs before adding resources. Supports pagination via page/size params.'
• Document output schemas for all tools. Specify field names, types, and whether they are required. E.g., create returns {short_id: string, name: string, created_at: ISO8601}. This enables agents to chain tools correctly.
• Add tool annotations: mark read-only tools with readOnlyHint=true, destructive tools (delete, remove-resource, delete-readme, delete-task) with destructiveHint=true, and idempotent tools with idempotentHint=true.
• Convert status parameter in create-task and update-task to use enum constraint: {enum: ['0', '1', '2']} or {enum: ['TODO', 'IN_PROGRESS', 'DONE']}. Add description: 'Task status: 0=TODO, 1=IN_PROGRESS, 2=DONE (default 0).'
• Add pagination guidance to list, resources, tasks, task-records descriptions. E.g., 'Returns up to 20 results per page. Use page (1-indexed) and size (1-100) to paginate. Response includes total count and next_cursor if more results exist.'