@utaba/ucm-mcp-server 2.0.0 → 4.0.0

package/README.md

@@ -6,7 +6,7 @@ Get your auth token from https://ucm.utaba.ai
 
 ## Configuration
 
-- `--auth-token <token>` (required): Authentication token in format `{authorid}:{apikey}`
+- `--auth-token <token>` (required): Authentication token in format `{apikey}`
 
 ## Available MCP Tools
 
@@ -14,7 +14,7 @@ The server provides 11 MCP tools following the `ucm_` naming convention:
 
 ### System Tools
 - `ucm_health_check` - Check MCP server and UCM API connectivity
-- `ucm_quickstart` - Get the UCM quickstart guide (Tell your AI to load this first)
+- `ucm_connect` - Get the UCM quickstart guide (Tell your AI to load this first)
 
 ### Discovery Tools
 - `ucm_get_author_index` - Generate dynamic markdown index for an author

package/dist/clients/UcmApiClient.d.ts

@@ -1,5 +1,5 @@
 import { ArtifactData, AuthorData } from '../types/UcmApiTypes.js';
-export declare class UcmApiClient {
+export declare class UcmLocalApiClient {
     private baseUrl;
     private authToken?;
     private authorId?;

package/dist/clients/UcmApiClient.js

@@ -1,5 +1,5 @@
 import axios from 'axios';
-export class UcmApiClient {
+export class UcmLocalApiClient {
     baseUrl;
     authToken;
     authorId;

package/dist/index.js

@@ -11,7 +11,7 @@ async function main() {
     const program = new Command();
     program
         .name('ucm-mcp-server')
-        .description('Universal Context Manager - Read the ucm_quickstart first to avoid mistakes')
+        .description('Universal Context Manager - Read the ucm_connect tool first to avoid mistakes')
         .version('1.0.5')
         .option('-u, --ucm-url <url>', 'UCM API base URL (defaults to https://ucm.utaba.ai)')
         .option('-p, --port <port>', 'Server port', '3001')

package/dist/server/McpServer.js

@@ -2,7 +2,7 @@ import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
 import { McpHandler } from './McpHandler.js';
-import { UcmApiClient } from '../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../clients/UcmApiClient.js';
 import { ToolRegistry } from './ToolRegistry.js';
 export class McpServer {
     config;
@@ -14,7 +14,7 @@ export class McpServer {
     constructor(config, logger) {
         this.config = config;
         this.logger = logger;
-        this.ucmClient = new UcmApiClient(config.ucmApiUrl, config.authToken, config.requestTimeout, config.authorId);
+        this.ucmClient = new UcmLocalApiClient(config.ucmApiUrl, config.authToken, config.requestTimeout, config.authorId);
         this.toolRegistry = new ToolRegistry(this.ucmClient, this.logger, config.trustedAuthors, config.authorId, config.ucmApiUrl);
         this.handler = new McpHandler(this.toolRegistry, this.logger, config.authorId);
         this.server = new Server({

package/dist/server/ToolRegistry.d.ts

@@ -1,4 +1,4 @@
-import { UcmApiClient } from '../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../clients/UcmApiClient.js';
 import { ILogger } from '../interfaces/ILogger.js';
 export interface ToolInfo {
     name: string;
@@ -12,7 +12,7 @@ export declare class ToolRegistry {
     private authorId?;
     private baseUrl?;
     private tools;
-    constructor(ucmClient: UcmApiClient, logger: ILogger, trustedAuthors?: string[], authorId?: string | undefined, baseUrl?: string | undefined);
+    constructor(ucmClient: UcmLocalApiClient, logger: ILogger, trustedAuthors?: string[], authorId?: string | undefined, baseUrl?: string | undefined);
     private registerTools;
     private registerTool;
     listTools(): Promise<ToolInfo[]>;

package/dist/tools/base/BaseToolController.d.ts

@@ -1,11 +1,11 @@
 import { IMcpTool } from '../../interfaces/IMcpTool.js';
-import { UcmApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare abstract class BaseToolController implements IMcpTool {
-    protected ucmClient: UcmApiClient;
+    protected ucmClient: UcmLocalApiClient;
     protected logger: ILogger;
     protected publishingAuthorId?: string | undefined;
-    constructor(ucmClient: UcmApiClient, logger: ILogger, publishingAuthorId?: string | undefined);
+    constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string | undefined);
     abstract get name(): string;
     abstract get description(): string;
     abstract get inputSchema(): any;

package/dist/tools/core/DeleteArtifactTool.d.ts

@@ -1,8 +1,8 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class DeleteArtifactTool extends BaseToolController {
-    constructor(ucmClient: UcmApiClient, logger: ILogger, publishingAuthorId?: string);
+    constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);
     get name(): string;
     get description(): string;
     get inputSchema(): any;

package/dist/tools/core/EditArtifactMetadataTool.d.ts

@@ -1,8 +1,8 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class EditArtifactMetadataTool extends BaseToolController {
-    constructor(ucmClient: UcmApiClient, logger: ILogger, publishingAuthorId?: string);
+    constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);
     get name(): string;
     get description(): string;
     get inputSchema(): any;

package/dist/tools/core/GetArtifactTool.d.ts

@@ -1,9 +1,9 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class GetArtifactTool extends BaseToolController {
     private trustedAuthors;
-    constructor(ucmClient: UcmApiClient, logger: ILogger, publishingAuthorId?: string, trustedAuthors?: string[]);
+    constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string, trustedAuthors?: string[]);
     get name(): string;
     get description(): string;
     get inputSchema(): any;

package/dist/tools/core/GetArtifactVersionsTool.d.ts

@@ -1,8 +1,8 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class GetArtifactVersionsTool extends BaseToolController {
-    constructor(ucmClient: UcmApiClient, logger: ILogger, publishingAuthorId?: string);
+    constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);
     get name(): string;
     get description(): string;
     get inputSchema(): any;

package/dist/tools/core/GetChunkTool.d.ts

@@ -1,8 +1,8 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class GetChunkTool extends BaseToolController {
-    constructor(ucmClient: UcmApiClient, logger: ILogger, publishingAuthorId?: string);
+    constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);
     get name(): string;
     get description(): string;
     get inputSchema(): any;

package/dist/tools/core/ListArtifactsTool.d.ts

@@ -1,8 +1,8 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class ListArtifactsTool extends BaseToolController {
-    constructor(ucmClient: UcmApiClient, logger: ILogger, publishingAuthorId?: string);
+    constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);
     get name(): string;
     get description(): string;
     get inputSchema(): any;

package/dist/tools/core/PublishArtifactFromFileTool.d.ts

@@ -1,8 +1,8 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class PublishArtifactFromFileTool extends BaseToolController {
-    constructor(ucmClient: UcmApiClient, logger: ILogger, publishingAuthorId?: string);
+    constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);
     get name(): string;
     get description(): string;
     get inputSchema(): any;

package/dist/tools/core/PublishArtifactTool.d.ts

@@ -1,8 +1,8 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class PublishArtifactTool extends BaseToolController {
-    constructor(ucmClient: UcmApiClient, logger: ILogger, publishingAuthorId?: string);
+    constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);
     get name(): string;
     get description(): string;
     get inputSchema(): any;

package/dist/tools/core/SearchArtifactsTool.d.ts

@@ -1,8 +1,8 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class SearchArtifactsTool extends BaseToolController {
-    constructor(ucmClient: UcmApiClient, logger: ILogger, publishingAuthorId?: string);
+    constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);
     get name(): string;
     get description(): string;
     get inputSchema(): any;

package/dist/tools/repository/CreateRepositoryTool.d.ts

@@ -1,8 +1,8 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class CreateRepositoryTool extends BaseToolController {
-    constructor(ucmClient: UcmApiClient, logger: ILogger, publishingAuthorId?: string);
+    constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);
     get name(): string;
     get description(): string;
     get inputSchema(): any;

package/dist/tools/repository/DeleteRepositoryGuidanceTool.d.ts

@@ -1,9 +1,9 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class DeleteRepositoryGuidanceTool extends BaseToolController {
     private baseUrl?;
-    constructor(ucmClient: UcmApiClient, logger: ILogger, publishingAuthorId?: string, baseUrl?: string | undefined);
+    constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string, baseUrl?: string | undefined);
     get name(): string;
     get description(): string;
     get inputSchema(): any;

package/dist/tools/repository/GetRepositoryTool.d.ts

@@ -1,8 +1,8 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class GetRepositoryTool extends BaseToolController {
-    constructor(ucmClient: UcmApiClient, logger: ILogger, publishingAuthorId?: string);
+    constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);
     get name(): string;
     get description(): string;
     get inputSchema(): any;

package/dist/tools/repository/UpdateRepositoryTool.d.ts

@@ -1,8 +1,8 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class UpdateRepositoryTool extends BaseToolController {
-    constructor(ucmClient: UcmApiClient, logger: ILogger, publishingAuthorId?: string);
+    constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);
     get name(): string;
     get description(): string;
     get inputSchema(): any;

package/dist/tools/utility/AuthorIndexTool.d.ts

@@ -1,8 +1,8 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class AuthorIndexTool extends BaseToolController {
-    constructor(ucmClient: UcmApiClient, logger: ILogger, publishingAuthorId?: string);
+    constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);
     get name(): string;
     get description(): string;
     get inputSchema(): any;

package/dist/tools/utility/AuthorRecentsTool.d.ts

@@ -1,8 +1,8 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class AuthorRecentsTool extends BaseToolController {
-    constructor(ucmClient: UcmApiClient, logger: ILogger, publishingAuthorId?: string);
+    constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);
     get name(): string;
     get description(): string;
     get inputSchema(): any;

package/dist/tools/utility/HealthCheckController.d.ts

@@ -1,8 +1,8 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class HealthCheckController extends BaseToolController {
-    constructor(ucmClient: UcmApiClient, logger: ILogger, publishingAuthorId?: string);
+    constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);
     get name(): string;
     get description(): string;
     get inputSchema(): any;

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 = '1.1.8'; //TODO: tried to sync this with packageJson but it didn't work.
+const version = '3.0.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/ListRepositoriesTool.d.ts

@@ -1,8 +1,8 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class ListRepositoriesTool extends BaseToolController {
-    constructor(ucmClient: UcmApiClient, logger: ILogger, publishingAuthorId?: string);
+    constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);
     get name(): string;
     get description(): string;
     get inputSchema(): any;

package/dist/tools/utility/QuickstartTool.d.ts

@@ -1,8 +1,8 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class QuickstartTool extends BaseToolController {
-    constructor(ucmClient: UcmApiClient, logger: ILogger, publishingAuthorId?: string);
+    constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);
     get name(): string;
     get description(): string;
     get inputSchema(): any;

package/dist/tools/utility/QuickstartTool.js

@@ -4,10 +4,10 @@ export class QuickstartTool extends BaseToolController {
         super(ucmClient, logger, publishingAuthorId);
     }
     get name() {
-        return 'ucm_quickstart';
+        return 'ucm_connect';
     }
     get description() {
-        return 'CRITICAL MANDATORY READING: READ THIS FIRST before using any other tools as it will guide you to understand how to use the UCM system and MCP tools effectively';
+        return 'CRITICAL MANDATORY READING QUICKSTART: READ THIS FIRST before using any other tools as it will guide you to understand how to use the UCM system and MCP tools effectively';
     }
     get inputSchema() {
         return {

package/dist/tools/utility/SubmitFeedbackTool.d.ts

@@ -1,8 +1,8 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class SubmitFeedbackTool extends BaseToolController {
-    constructor(ucmClient: UcmApiClient, logger: ILogger, publishingAuthorId?: string);
+    constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);
     get name(): string;
     get description(): string;
     get inputSchema(): any;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@utaba/ucm-mcp-server",
-  "version": "2.0.0",
+  "version": "4.0.0",
   "description": "Universal Context Manager MCP Server - AI-native artifact management",
   "main": "dist/index.js",
   "type": "module",

package/package.json.backup

@@ -1,6 +1,6 @@
 {
   "name": "ucm-mcp-server",
-  "version": "2.0.0",
+  "version": "4.0.0",
   "description": "Universal Context Manager MCP Server - AI-native artifact management",
   "main": "dist/index.js",
   "type": "module",