This server has 7 tools with significant definition quality gaps across naming, descriptions, and parameter documentation. Tools are explicitly registered with Zod schemas in src/index.ts and src/document/routes.ts. However, most parameter descriptions are missing or minimal, and several tool descriptions lack clarity about state modification and use cases. The server mixes trivial calculator tools with document management operations without clear separation of concerns. While schemas are present (Zod-based), parameter-level documentation is sparse, forcing LLMs to infer intent.

• Expand tool descriptions to 50 - 150 characters with explicit guidance on WHAT the tool does, WHEN to use it (vs similar tools), and what it returns. Example: 'add' → 'Adds two numbers and returns the numeric result. Use for simple arithmetic; use calculate for multi-operation sequences.' (avoid example values like 'a=1, b=2').
• Add non-empty descriptions to every parameter. For 'a' and 'b' in add/calculate: 'The first operand (numeric value)' and 'The second operand (numeric value)'. For 'operation': already has enum, description should clarify 'The arithmetic operation to perform: add (a+b), subtract (a-b), multiply (a*b), divide (a/b, returns error if b=0)'.
• Document output schemas for each tool. Example for getDocumentById: 'Returns a document object with fields: documentId (string), path (string), content (object), metadata (object with name, fileType, size, timestamps), or error object with error field.'
• Rewrite 'deleteDocument', 'createDocument', 'updateDocument' descriptions to explicitly state they modify state and are irreversible. Add a note about no undo. Example: 'Permanently deletes a document by ID. This action cannot be undone. Verify the document ID before calling.'
• Add pagination to getFilesInPath: introduce limit (default 20, max 100) and offset/cursor parameters. Document maximum results returned. Return total_count for offset-based pagination.
• Clarify parameter relationships. For getDocumentById and updateDocument, document whether 'path' is a filter, an override, or optional context. If mutually exclusive with documentId, state so.