@utaba/ucm-mcp-server 6.2.0 → 6.4.0

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('1.0.5')
+        .version('6.3.0')
         .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. Use this to see what tools are available for a connection before calling them.';
+        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.';
     }
     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 'Call a tool on an external connection. Use ucm_access_connection first to see available tools and their schemas.';
+        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.';
     }
     get inputSchema() {
         return {
@@ -69,8 +69,10 @@ 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
             if (!result.success) {
-                return result.error || result.markdown || 'Tool execution failed';
+                return result.markdown || result.error || 'Tool execution failed';
             }
             // Return as pre-formatted MCP response — McpHandler will pass through
             return { content: result.content };

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.2.0'; //TODO: tried to sync this with packageJson but it didn't work.
+const version = '6.4.0'; //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/dist/tools/utility/QuickstartTool.js

@@ -7,7 +7,7 @@ export class QuickstartTool extends BaseToolController {
         return 'ucm_connect';
     }
     get description() {
-        return 'Connect to UCM and initialise operational context for the conversation. Call this tool FIRST at the start of every conversation — it loads your personalized account information, author IDs, repositories, policies, and connected services. Required for conversation initialisation before using any other UCM tools.';
+        return 'Connect to UCM and initialise operational context for the conversation. Call this tool FIRST at the start of every conversation — it loads your personalized account information, workspace IDs, repositories, policies, and connected services. Required for conversation initialisation before using any other UCM tools.';
     }
     get inputSchema() {
         return {

package/package.json

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