The server provides 4 tools with clear verb-noun naming and reasonable descriptions. All tools have input schemas with Zod validation. However, output schemas are not explicitly documented, parameter constraints are minimal, and error handling lacks actionable recovery guidance. Descriptions are adequate but fall short of LLM-optimized length (target 50-200 chars per pattern baseline). The insert_lines tool modifies state but descriptions do not sufficiently emphasize irreversibility or include prerequisites.

• Add explicit output schema documentation for each tool. Example for get_page: return { page_title: string, content: string, related_pages: string[], last_updated: ISO8601_date }. Make it JSON Schema or similar format visible to the MCP client.
• Enhance insert_lines description to explicitly state it modifies the page and is irreversible. Example: 'WRITE operation: inserts lines after the target line in a Cosense page. Changes are permanent. If target line not found, appends to end.'
• Add actionable error messages with next-step guidance. Example: 'Page title not found. Try search_pages(query="<partial title>") to find the correct title, or call list_pages() to see all available pages.'
• Add length and character constraints to title and query parameters. Example: title must be 1-255 characters, alphanumeric and spaces; query: space-separated terms, max 10 terms.
• Implement pagination for list_pages. Add optional limit (default 20, max 100) and offset/cursor parameters. Return { pages: [...], total_count: number, has_more: boolean, next_offset: number }.
• Convert Zod schemas to explicit JSON Schema objects in tool registration. Ensure type, minLength, maxLength, enum, pattern fields are populated and visible to MCP clients.
• Add per-parameter validation with clear errors. If title is empty, return 'Title cannot be empty (1-255 chars required)' instead of an API-level error.
• Implement a dry-run or confirmation variant of insert_lines. Example: add optional parameter 'dry_run: boolean'. When true, return what would be inserted without committing the change.

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

• Relies on Logging (deprecated) - log to stderr or use OpenTelemetry