@utaba/ucm-mcp-server 6.4.0 → 6.5.1

package/dist/clients/UcmLocalApiClient.d.ts

@@ -128,6 +128,7 @@ export declare class UcmLocalApiClient {
         authRequired?: boolean;
         loginUrl?: string;
         loginMessage?: string;
+        error?: string;
         tools?: any[];
         markdown?: string;
         instructions?: string;
@@ -155,6 +156,11 @@ export declare class UcmLocalApiClient {
         authRequired?: boolean;
         loginUrl?: string;
         loginMessage?: string;
+        tools?: Array<{
+            name: string;
+            description: string;
+            parameters: any;
+        }>;
         markdown: string;
     }>;
     /**

package/dist/index.js

@@ -12,7 +12,7 @@ async function main() {
     program
         .name('ucm-mcp-server')
         .description('Universal Context Manager - Read the ucm_connect tool first to avoid mistakes')
-        .version('6.3.0')
+        .version('6.5.1')
         .option('-u, --ucm-url <url>', 'UCM API base URL (defaults to https://ucm.utaba.ai)')
         .option('-p, --port <port>', 'Server port', '3001')
         .option('--log-level <level>', 'Log level', 'ERROR')

package/dist/tools/connections/AccessConnectionTool.js

@@ -14,7 +14,7 @@ export class AccessConnectionTool extends BaseToolController {
         return 'ucm_access_connection';
     }
     get description() {
-        return 'Access a specific external connection, check auth status, and return available tool schemas. Call this without the toolNames parameter to get an index of all available tools. Pass in toolNames to learn the full parameter schema if needed.';
+        return 'Access a specific external connection, check auth status, and return available tool schemas. Call without toolNames to get a summary index of all available tools. Pass toolNames to retrieve full parameter schemas.';
     }
     get inputSchema() {
         return {
@@ -66,14 +66,16 @@ export class AccessConnectionTool extends BaseToolController {
             if (result.markdown) {
                 return result.markdown;
             }
-            // toolNames mode — return compact JSON with filtered tools
-            return JSON.stringify({
+            // Tools mode — return compact JSON with schemas
+            const json = {
                 connectionId: result.connectionId,
                 connectionName: result.connectionName,
                 instructions: result.instructions,
                 policies: result.policies,
+                ...(result.error && { error: result.error }),
                 tools: result.tools
-            });
+            };
+            return JSON.stringify(json);
         }
         catch (error) {
             // Sanitize error for logging

package/dist/tools/connections/CallRemoteToolTool.js

@@ -14,7 +14,7 @@ export class CallRemoteToolTool extends BaseToolController {
         return 'ucm_call_remote_tool';
     }
     get description() {
-        return 'Use ucm_access_connection to discover available tools and schemas before calling a tool for the first time on a connection. No need to re-access if the schema is already known from earlier in the conversation.';
+        return 'Call a tool on an external connection.';
     }
     get inputSchema() {
         return {
@@ -69,9 +69,23 @@ export class CallRemoteToolTool extends BaseToolController {
                 authRequired: result.authRequired || false
             });
             // Clean proxy: pass through content blocks directly
-            // Prefer markdown over error — validation failures include full schema guidance
-            // so the AI can self-correct and retry with correct parameters
+            // Return structured JSON for errors so the AI can self-correct and retry
             if (!result.success) {
+                if (result.errorCode === 'TOOL_NOT_FOUND' && result.tools) {
+                    return JSON.stringify({
+                        error: 'TOOL_NOT_FOUND',
+                        message: result.error,
+                        available_tools: result.tools
+                    });
+                }
+                if (result.errorCode === 'VALIDATION_ERROR' && result.tools) {
+                    return JSON.stringify({
+                        error: 'VALIDATION_ERROR',
+                        message: result.error,
+                        tool_schema: result.tools[0]
+                    });
+                }
+                // For other errors (auth), return text
                 return result.markdown || result.error || 'Tool execution failed';
             }
             // Return as pre-formatted MCP response — McpHandler will pass through

package/dist/tools/utility/HealthCheckController.js

@@ -1,6 +1,6 @@
 import { BaseToolController } from '../base/BaseToolController.js';
 //import packageJson from '../../../../publish/package.json' assert { type: 'json' };
-const version = '6.4.0'; //TODO: tried to sync this with packageJson but it didn't work.
+const version = '6.5.1'; //TODO: tried to sync this with packageJson but it didn't work.
 export class HealthCheckController extends BaseToolController {
     constructor(ucmClient, logger, publishingAuthorId) {
         super(ucmClient, logger, publishingAuthorId);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@utaba/ucm-mcp-server",
-  "version": "6.4.0",
+  "version": "6.5.1",
   "description": "Universal Context Manager MCP Server - AI Productivity Platform",
   "main": "dist/index.js",
   "type": "module",

package/package.json.backup

@@ -1,6 +1,6 @@
 {
   "name": "ucm-mcp-server",
-  "version": "6.4.0",
+  "version": "6.5.1",
   "description": "Universal Context Manager MCP Server - AI Productivity Platform",
   "main": "dist/index.js",
   "type": "module",