Healthcheck tool returns unstructured content #7515

Author: tobiu

.github/ISSUE/bug-kb-healthcheck-unstructured-content.md

@@ -0,0 +1,23 @@
+---
+title: "Bug: healthcheck tool returns unstructured content"
+labels: bug, AI
+---
+
+Parent epic: #7501
+GH ticket id: #7514
+
+**Phase:** 4 (Bugfix)
+**Assignee:** tobiu
+**Status:** To Do
+
+## Description
+
+When running the `healthcheck` tool on the `neo-knowledge-base` MCP server, it fails with the error: `MCP error -32600: Tool healthcheck has an output schema but did not return structured content`.
+
+This indicates that the object returned by the `healthService.healthcheck` function does not match the `HealthCheckResponse` schema defined in `openapi.yaml`.
+
+## Acceptance Criteria
+
+1.  The `healthService.mjs` file is reviewed and corrected.
+2.  The `healthcheck` function is modified to return a JSON object that strictly conforms to the `HealthCheckResponse` schema.
+3.  Running the `healthcheck` tool successfully returns the structured health status without any MCP errors.

.github/ISSUE/epic-architect-knowledge-base-as-mcp.md

@@ -3,7 +3,7 @@
 GH ticket id: #7501
 
 **Assignee:** tobiu
-**Status:** To Do
+**Status:** In Progress
 
 ## Scope
 
@@ -46,3 +46,9 @@ We will employ a rapid and agile development approach. The scope and API specifi
     - `ticket-kb-review-and-correct-database-service.md`: Review and correct the `databaseService` implementation to ensure full feature parity.
     - `ticket-kb-enhance-openapi-examples.md`: Enhance the OpenAPI spec with tool usage examples from AGENTS.md.
     - `ticket-kb-enhance-tool-manuals.md`: Expand tool descriptions into comprehensive in-spec manuals.
+
+### Phase 4: Bugfixes
+
+- **Goal:** Address bugs discovered during testing.
+- **Sub-Tasks:**
+    - `bug-kb-healthcheck-unstructured-content.md`: Fix the healthcheck tool to return structured content matching its schema.

ai/mcp/server/knowledge-base/openapi.yaml

@@ -338,6 +338,9 @@ components:
             collectionName:
               type: string
               example: "neo-knowledge-base"
+            collectionExists:
+              type: boolean
+              example: true
             documentCount:
               type: integer
               example: 1234