@utaba/ucm-mcp-server 6.1.0 → 6.2.0

package/dist/clients/UcmLocalApiClient.d.ts

@@ -119,7 +119,7 @@ export declare class UcmLocalApiClient {
      * Returns connection details, auth status, and available tool schemas
      * Connection type is auto-detected by the server from the connectionId
      */
-    accessConnection(connectionId: string): Promise<{
+    accessConnection(connectionId: string, toolNames?: string[]): Promise<{
         success: boolean;
         connectionId: string;
         connectionType: 'sharepoint' | 'remote-mcp';
@@ -127,20 +127,29 @@ export declare class UcmLocalApiClient {
         isAuthenticated: boolean;
         authRequired?: boolean;
         loginUrl?: string;
+        loginMessage?: string;
         tools?: any[];
-        schema: string;
+        markdown?: string;
+        instructions?: string;
+        policies?: string[];
     }>;
     /**
      * Call a tool on an external connection
      * Executes a tool on a SharePoint connection or Remote MCP Server
      * Connection type is auto-detected by the server from the connectionId
      */
-    callRemoteTool(connectionId: string, toolName: string, args?: Record<string, any>): Promise<{
+    callRemoteTool(connectionId: string, toolName: string, args?: any): Promise<{
         success: boolean;
         connectionId: string;
         connectionType: 'sharepoint' | 'remote-mcp';
         toolName: string;
-        result?: any;
+        content?: Array<{
+            type: string;
+            text?: string;
+            data?: string;
+            mimeType?: string;
+            uri?: string;
+        }>;
         error?: string;
         errorCode?: string;
         authRequired?: boolean;

package/dist/clients/UcmLocalApiClient.js

@@ -378,9 +378,13 @@ export class UcmLocalApiClient {
      * Returns connection details, auth status, and available tool schemas
      * Connection type is auto-detected by the server from the connectionId
      */
-    async accessConnection(connectionId) {
+    async accessConnection(connectionId, toolNames) {
         const client = this.ensureClient();
-        const response = await client.get(`/api/v1/connections/${connectionId}`);
+        const params = {};
+        if (toolNames && toolNames.length > 0) {
+            params.toolNames = toolNames.join(',');
+        }
+        const response = await client.get(`/api/v1/connections/${connectionId}`, { params });
         return response.data;
     }
     /**
@@ -390,10 +394,10 @@ export class UcmLocalApiClient {
      */
     async callRemoteTool(connectionId, toolName, args) {
         const client = this.ensureClient();
-        const body = {
-            toolName,
-            args: args || {}
-        };
+        const body = { toolName };
+        if (args !== undefined) {
+            body.args = args;
+        }
         const response = await client.post(`/api/v1/connections/${connectionId}/tools`, body);
         return response.data;
     }

package/dist/server/McpHandler.js

@@ -39,6 +39,10 @@ export class McpHandler {
             }
             const result = await this.toolRegistry.executeTool(name, args || {});
             this.logger.info('MCP-Handler', `Tool ${name} executed successfully`);
+            // If the tool returned a pre-formatted MCP response (with content array), pass through
+            if (result && typeof result === 'object' && Array.isArray(result.content)) {
+                return result;
+            }
             // Handle string results directly (e.g., markdown content)
             if (typeof result === 'string') {
                 return {

package/dist/tools/connections/AccessConnectionTool.d.ts

@@ -15,6 +15,7 @@ export declare class AccessConnectionTool extends BaseToolController {
     protected validateParams(params: any): void;
     protected handleExecute(params: {
         connectionId: string;
+        toolNames?: string[];
     }): Promise<any>;
 }
 //# sourceMappingURL=AccessConnectionTool.d.ts.map

package/dist/tools/connections/AccessConnectionTool.js

@@ -25,6 +25,11 @@ export class AccessConnectionTool extends BaseToolController {
                     description: 'Connection ID (SharePoint connection or Remote MCP Server) from ucm_list_connections',
                     minLength: 36,
                     maxLength: 36
+                },
+                toolNames: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Optional list of tool names to get full parameter schemas for. If omitted, returns a summary index of all available tools. Pass in all tool names that could likely be relevant.'
                 }
             },
             required: ['connectionId']
@@ -43,15 +48,32 @@ export class AccessConnectionTool extends BaseToolController {
     async handleExecute(params) {
         this.logger.info('AccessConnectionTool', `Accessing connection: ${params.connectionId}`);
         try {
-            const result = await this.ucmClient.accessConnection(params.connectionId);
+            const result = await this.ucmClient.accessConnection(params.connectionId, params.toolNames);
             this.logger.info('AccessConnectionTool', 'Connection accessed successfully', '', {
                 connectionId: params.connectionId,
                 connectionType: result.connectionType,
                 isAuthenticated: result.isAuthenticated,
                 toolCount: result.tools?.length || 0
             });
-            // Return the schema (JSON envelope with modelInstructions, policies, tools) for AI consumption
-            return result.schema;
+            // Auth required — return login message
+            if (!result.isAuthenticated) {
+                if (result.authRequired && result.loginUrl) {
+                    return `Authentication required for "${result.connectionName}". Login URL: ${result.loginUrl}`;
+                }
+                return `Connection "${result.connectionName}" is not accessible: ${result.loginMessage || 'Authentication failed'}`;
+            }
+            // If markdown index returned (no toolNames requested), return markdown
+            if (result.markdown) {
+                return result.markdown;
+            }
+            // toolNames mode — return compact JSON with filtered tools
+            return JSON.stringify({
+                connectionId: result.connectionId,
+                connectionName: result.connectionName,
+                instructions: result.instructions,
+                policies: result.policies,
+                tools: result.tools
+            });
         }
         catch (error) {
             // Sanitize error for logging

package/dist/tools/connections/CallRemoteToolTool.d.ts

@@ -16,7 +16,7 @@ export declare class CallRemoteToolTool extends BaseToolController {
     protected handleExecute(params: {
         connectionId: string;
         toolName: string;
-        args?: Record<string, any>;
+        args?: any;
     }): Promise<any>;
 }
 //# sourceMappingURL=CallRemoteToolTool.d.ts.map

package/dist/tools/connections/CallRemoteToolTool.js

@@ -33,7 +33,8 @@ export class CallRemoteToolTool extends BaseToolController {
                 },
                 args: {
                     type: 'object',
-                    description: 'Tool arguments object (see ucm_access_connection for parameter schemas)'
+                    description: 'Tool arguments — passed through to the remote tool as-is',
+                    additionalProperties: true
                 }
             },
             required: ['connectionId', 'toolName']
@@ -52,23 +53,27 @@ export class CallRemoteToolTool extends BaseToolController {
         if (!params.toolName || typeof params.toolName !== 'string') {
             throw new McpError(McpErrorCode.InvalidParams, 'toolName is required and must be a string');
         }
-        // Validate args if provided — must be an object, not a string
-        if (params.args !== undefined && (typeof params.args !== 'object' || params.args === null)) {
-            throw new McpError(McpErrorCode.InvalidParams, 'args must be an object');
-        }
     }
     async handleExecute(params) {
+        // MCP transport may serialize nested objects as strings — parse if needed
+        const args = typeof params.args === 'string'
+            ? JSON.parse(params.args)
+            : params.args;
         this.logger.info('CallRemoteToolTool', `Calling tool ${params.toolName} on connection: ${params.connectionId}`);
         try {
-            const result = await this.ucmClient.callRemoteTool(params.connectionId, params.toolName, params.args);
+            const result = await this.ucmClient.callRemoteTool(params.connectionId, params.toolName, args);
             this.logger.info('CallRemoteToolTool', 'Tool executed successfully', '', {
                 connectionId: params.connectionId,
                 toolName: params.toolName,
                 success: result.success,
                 authRequired: result.authRequired || false
             });
-            // Return the markdown content for AI consumption
-            return result.markdown;
+            // Clean proxy: pass through content blocks directly
+            if (!result.success) {
+                return result.error || result.markdown || 'Tool execution failed';
+            }
+            // Return as pre-formatted MCP response — McpHandler will pass through
+            return { content: result.content };
         }
         catch (error) {
             // Sanitize error for logging

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.0.0'; //TODO: tried to sync this with packageJson but it didn't work.
+const version = '6.2.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/package.json

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