Server defines 9 tools with explicit Zod schemas and descriptions. Naming follows verb_noun pattern (zhiji_workspace_assemble, zhiji_memory_search, etc.). Descriptions are detailed and domain-specific (194 - 250 chars average), exceeding baseline. However, critical gaps exist: (1) output schemas are NOT documented, tools return JSON but LLMs cannot predict field structure; (2) error handling lacks recovery guidance, errors are raw API responses without actionable next steps; (3) parameter descriptions use Chinese, reducing LLM clarity; (4) no tool annotations (readOnlyHint/destructiveHint) despite clear read/write semantics; (5) some parameters lack constraints (e.g., maxResults has bounds but hours lacks explicit max). Composition is strong, tools chain well (workspace_assemble → feedback). Security: API key injection via header is correct; no secrets in params.

• Document output schemas for all tools. Define return type as a Zod schema (e.g., z.object({ memoryContext: z.array(...), profile: z.string(), ... })) and include in tool registration or README. This enables LLMs to plan downstream operations.
• Enhance error handling with recovery guidance. Wrap api() calls to categorize errors: if 404, suggest 'User not found. Ensure MB_USER_EMAIL is set or pass userEmail parameter.'; if timeout, suggest 'Query took >60s. Try reducing maxResults or simplifying query.'; if 5xx, suggest 'Service unavailable. Retry in 5s.'
• Add tool annotations. Register tools with readOnlyHint=true for read tools (zhiji_memory_search, zhiji_profile_get, etc.) and destructiveHint=true for write tools (zhiji_memory_ingest, zhiji_ingest_file). Use server.tool(..., { ... }, { readOnlyHint: true }).
• Provide English parameter descriptions or bilingual descriptions. Replace Chinese-only descriptions with English equivalents or add English alongside Chinese. This improves compatibility with non-Chinese LLMs and reduces ambiguity.
• Add explicit bounds to numeric parameters. Set z.number().int().min(1).max(720) for hours; z.number().int().min(1000).max(600000) for transcriptionTimeoutMs. Document rationale in descriptions (e.g., 'max 720 hours = 30 days').

Inferred effective spec: 2026-07-28+.

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