docs: Update release notes and changelog for v0.8.1

- Added v0.8.1 release notes documenting the critical schema fix
- Updated changelog with detailed information about the JSON schema validation error fix
- Bumped version to 0.8.1 in package.json and src/server.ts
- Documents the resolution of 'Invalid schema for tool list_document_pages: strict mode: unknown keyword: "optional"' error
- Explains technical details about proper JSON Schema optional property handling
- Maintains comprehensive documentation for users experiencing startup issues

Author: taazkareem

changelog.md

@@ -4,6 +4,23 @@
 
 *No unreleased changes*
 
+## v0.8.1 (2025-06-12)
+
+### 🛠️ Critical Bug Fixes
+
+- **Fixed JSON Schema Validation Error**:
+  - Resolved server startup failure with error: `Invalid schema for tool list_document_pages: strict mode: unknown keyword: "optional"`
+  - Removed invalid `optional: true` keywords from document tool schemas
+  - Fixed schemas for: `list_document_pages`, `get_document_pages`, `create_document_page`, `update_document_page`
+  - **Technical Note**: In JSON Schema, optional properties are defined by omitting them from the `required` array, not by using an `optional` keyword
+  - **Impact**: Server now starts correctly without schema validation errors
+
+### 🔄 Repository Updates
+
+- Updated document tool schemas to comply with strict JSON Schema validation
+- Ensured all tools load properly and are fully functional
+- Maintained zero breaking changes - all existing functionality preserved
+
 ## v0.8.0 (2025-06-12)
 
 ### 🚀 Major Features & Architectural Improvements

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taazkareem/clickup-mcp-server",
-  "version": "0.7.2",
+  "version": "0.8.1",
   "description": "ClickUp MCP Server - Integrate ClickUp tasks with AI through Model Context Protocol",
   "type": "module",
   "main": "build/index.js",

release-notes.md

@@ -1,3 +1,27 @@
+# v0.8.1 Release Notes
+
+## 🛠️ Critical Schema Fix
+
+**v0.8.1** is a patch release that fixes a critical schema validation issue that prevented the MCP server from starting.
+
+### **Bug Fix**
+- **Fixed JSON Schema Validation Error**: Removed invalid `optional: true` keywords from document tool schemas
+  - **Issue**: Server failed to start with error: `Invalid schema for tool list_document_pages: strict mode: unknown keyword: "optional"`
+  - **Root Cause**: Document tools were using `optional: true` which is not a valid JSON Schema keyword
+  - **Solution**: Removed `optional` keywords from all document tool schemas (optional properties are handled by the `required` array)
+  - **Tools Fixed**: `list_document_pages`, `get_document_pages`, `create_document_page`, `update_document_page`
+
+### **Impact**
+- ✅ **Server now starts correctly** without schema validation errors
+- ✅ **All tools load properly** and are fully functional
+- ✅ **Zero breaking changes** - all existing functionality preserved
+- ✅ **Immediate fix** for users experiencing startup issues
+
+### **Technical Details**
+In JSON Schema specification, optional properties are defined by omitting them from the `required` array, not by using an `optional` keyword. This fix ensures compliance with strict JSON Schema validation.
+
+---
+
 # v0.8.0 Release Notes
 
 ## 🎉 Major Release: Architectural Revolution & Member Management

src/server.ts

@@ -104,7 +104,7 @@ const { workspace } = clickUpServices;
 export const server = new Server(
   {
     name: "clickup-mcp-server",
-    version: "0.7.2",
+    version: "0.8.1",
   },
   {
     capabilities: {