@utaba/ucm-mcp-server 6.4.0 → 6.5.0

package/dist/clients/UcmLocalApiClient.d.ts

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

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. If any tool name in toolNames is not recognised, the full catalogue is returned for all tools — use this to identify the correct name.';
     }
     get inputSchema() {
         return {

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. If the tool name is invalid, the response will include the full tool catalogue so you can identify the correct tool and retry immediately. If the parameters are invalid, the response will include the correct schema — retry using that schema directly. No additional discovery calls are needed to recover from errors.';
     }
     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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@utaba/ucm-mcp-server",
-  "version": "6.4.0",
+  "version": "6.5.0",
   "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.0",
   "description": "Universal Context Manager MCP Server - AI Productivity Platform",
   "main": "dist/index.js",
   "type": "module",