@utaba/ucm-mcp-server 1.1.8 → 2.0.0

package/README.md

@@ -10,24 +10,24 @@ Get your auth token from https://ucm.utaba.ai
 
 ## Available MCP Tools
 
-The server provides 11 MCP tools following the `mcp_ucm_` naming convention:
+The server provides 11 MCP tools following the `ucm_` naming convention:
 
 ### System Tools
-- `mcp_ucm_health_check` - Check MCP server and UCM API connectivity
-- `mcp_ucm_quickstart` - Get the UCM quickstart guide (Tell your AI to load this first)
+- `ucm_health_check` - Check MCP server and UCM API connectivity
+- `ucm_quickstart` - Get the UCM quickstart guide (Tell your AI to load this first)
 
 ### Discovery Tools
-- `mcp_ucm_get_author_index` - Generate dynamic markdown index for an author
-- `mcp_ucm_list_repositories` - List all repositories for an author
-- `mcp_ucm_list_artifacts` - Browse the 4-level hierarchy
+- `ucm_get_author_index` - Generate dynamic markdown index for an author
+- `ucm_list_repositories` - List all repositories for an author
+- `ucm_list_artifacts` - Browse the 4-level hierarchy
 
 ### Artifact Management
-- `mcp_ucm_get_artifact` - Retrieve artifact content with auto-chunking
-- `mcp_ucm_get_chunk` - Get chunks of large responses
-- `mcp_ucm_publish_artifact` - Create/update artifacts
-- `mcp_ucm_publish_artifact_fromfile` - File-based publishing (preferred for large files)
-- `mcp_ucm_delete_artifact` - Remove artifacts
-- `mcp_ucm_get_artifact_versions` - Get version history
+- `ucm_get_artifact` - Retrieve artifact content with auto-chunking
+- `ucm_get_chunk` - Get chunks of large responses
+- `ucm_publish_artifact` - Create/update artifacts
+- `ucm_publish_artifact_fromfile` - File-based publishing (preferred for large files)
+- `ucm_delete_artifact` - Remove artifacts
+- `ucm_get_artifact_versions` - Get version history
 
 ## Usage with Claude Desktop
 

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 mcp_ucm_quickstart first to avoid mistakes')
+        .description('Universal Context Manager - Read the ucm_quickstart 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/tools/core/DeleteArtifactTool.js

@@ -4,7 +4,7 @@ export class DeleteArtifactTool extends BaseToolController {
         super(ucmClient, logger, publishingAuthorId);
     }
     get name() {
-        return 'mcp_ucm_delete_artifact';
+        return 'ucm_delete_artifact';
     }
     get description() {
         return 'Delete a UCM artifact by path and version. This action cannot be undone. Only the latest or specified version is deleted.';

package/dist/tools/core/EditArtifactMetadataTool.js

@@ -6,7 +6,7 @@ export class EditArtifactMetadataTool extends BaseToolController {
         super(ucmClient, logger, publishingAuthorId);
     }
     get name() {
-        return 'mcp_ucm_edit_artifact_metadata';
+        return 'ucm_edit_artifact_metadata';
     }
     get description() {
         return 'Edit artifact metadata and optionally move artifacts to new locations. Supports updating description, namespace, filename, MIME type, technology, and tags. Move operations affect all versions while metadata-only updates apply to latest version only.';

package/dist/tools/core/GetArtifactTool.js

@@ -8,7 +8,7 @@ export class GetArtifactTool extends BaseToolController {
         this.trustedAuthors = trustedAuthors;
     }
     get name() {
-        return 'mcp_ucm_get_artifact';
+        return 'ucm_get_artifact';
     }
     get description() {
         return 'Retrieve UCM artifact content with metadata. Large files are automatically chunked.';

package/dist/tools/core/GetArtifactVersionsTool.js

@@ -5,7 +5,7 @@ export class GetArtifactVersionsTool extends BaseToolController {
         super(ucmClient, logger, publishingAuthorId);
     }
     get name() {
-        return 'mcp_ucm_get_artifact_versions';
+        return 'ucm_get_artifact_versions';
     }
     get description() {
         return 'Get all available versions of a specific UCM artifact';

package/dist/tools/core/GetChunkTool.js

@@ -6,7 +6,7 @@ export class GetChunkTool extends BaseToolController {
         super(ucmClient, logger, publishingAuthorId);
     }
     get name() {
-        return 'mcp_ucm_get_chunk';
+        return 'ucm_get_chunk';
     }
     get description() {
         return 'Retrieve the next chunk of a large UCM artifact response';

package/dist/tools/core/ListArtifactsTool.js

@@ -5,7 +5,7 @@ export class ListArtifactsTool extends BaseToolController {
         super(ucmClient, logger, publishingAuthorId);
     }
     get name() {
-        return 'mcp_ucm_list_artifacts';
+        return 'ucm_list_artifacts';
     }
     get description() {
         return `List artifacts with exploratory browsing support. Can list authors, repositories, categories, subcategories, or artifacts depending on path depth. ${this.publishingAuthorId ? "Your author value is '" + this.publishingAuthorId + "'" : ''}`;

package/dist/tools/core/PublishArtifactFromFileTool.js

@@ -8,7 +8,7 @@ export class PublishArtifactFromFileTool extends BaseToolController {
         super(ucmClient, logger, publishingAuthorId);
     }
     get name() {
-        return 'mcp_ucm_publish_artifact_fromfile';
+        return 'ucm_publish_artifact_fromfile';
     }
     get description() {
         return 'Create or update UCM artifacts from a file URI. Supports versioning. PREFERRED METHOD: Use this tool for file-based content as it is much faster and more efficient. Pass the local file path as a file:// URI (e.g., "file:///path/to/file.txt").';

package/dist/tools/core/PublishArtifactTool.js

@@ -6,10 +6,10 @@ export class PublishArtifactTool extends BaseToolController {
         super(ucmClient, logger, publishingAuthorId);
     }
     get name() {
-        return 'mcp_ucm_publish_artifact';
+        return 'ucm_publish_artifact';
     }
     get description() {
-        return 'Create or update UCM artifacts with content and metadata. Supports versioning and automatic conflict detection. The API automatically detects whether to create or update based on existing artifacts. NOTE: Only use this tool for small data - use mcp_ucm_publish_artifact_fromfile for files as it is much faster and more efficient.';
+        return 'Create or update UCM artifacts with content and metadata. Supports versioning and automatic conflict detection. The API automatically detects whether to create or update based on existing artifacts. NOTE: Only use this tool for small data - use ucm_publish_artifact_fromfile for files as it is much faster and more efficient.';
     }
     get inputSchema() {
         return {

package/dist/tools/core/SearchArtifactsTool.js

@@ -4,7 +4,7 @@ export class SearchArtifactsTool extends BaseToolController {
         super(ucmClient, logger, publishingAuthorId);
     }
     get name() {
-        return 'mcp_ucm_search_artifacts';
+        return 'ucm_search_artifacts';
     }
     get description() {
         return `Search artifacts by text across multiple metadata fields with privacy filtering. Searches namespace, filename, description, and tags fields. ${this.publishingAuthorId ? "Your author value is '" + this.publishingAuthorId + "'" : ''}`;

package/dist/tools/repository/CreateRepositoryTool.js

@@ -5,7 +5,7 @@ export class CreateRepositoryTool extends BaseToolController {
         super(ucmClient, logger, publishingAuthorId);
     }
     get name() {
-        return 'mcp_ucm_create_repository';
+        return 'ucm_create_repository';
     }
     get description() {
         const authorInfo = this.publishingAuthorId ? ` Your author id is '${this.publishingAuthorId}'.` : '';

package/dist/tools/repository/DeleteRepositoryGuidanceTool.js

@@ -7,7 +7,7 @@ export class DeleteRepositoryGuidanceTool extends BaseToolController {
         this.baseUrl = baseUrl;
     }
     get name() {
-        return 'mcp_ucm_delete_repository_guidance';
+        return 'ucm_delete_repository_guidance';
     }
     get description() {
         return `Provides guidance for deleting a repository via the web UI.`;

package/dist/tools/repository/GetRepositoryTool.js

@@ -5,7 +5,7 @@ export class GetRepositoryTool extends BaseToolController {
         super(ucmClient, logger, publishingAuthorId);
     }
     get name() {
-        return 'mcp_ucm_get_repository';
+        return 'ucm_get_repository';
     }
     get description() {
         const authorInfo = this.publishingAuthorId ? ` Your author id is '${this.publishingAuthorId}'.` : '';

package/dist/tools/repository/UpdateRepositoryTool.js

@@ -5,7 +5,7 @@ export class UpdateRepositoryTool extends BaseToolController {
         super(ucmClient, logger, publishingAuthorId);
     }
     get name() {
-        return 'mcp_ucm_update_repository';
+        return 'ucm_update_repository';
     }
     get description() {
         const authorInfo = this.publishingAuthorId ? ` Your author id is '${this.publishingAuthorId}'.` : '';

package/dist/tools/utility/AuthorIndexTool.js

@@ -4,7 +4,7 @@ export class AuthorIndexTool extends BaseToolController {
         super(ucmClient, logger, publishingAuthorId);
     }
     get name() {
-        return 'mcp_ucm_get_author_index';
+        return 'ucm_get_author_index';
     }
     get description() {
         return `Discover a dynamic markdown index guide for AI assistants working with an author\'s content. Your author id is '${this.publishingAuthorId}'`;

package/dist/tools/utility/AuthorRecentsTool.js

@@ -4,7 +4,7 @@ export class AuthorRecentsTool extends BaseToolController {
         super(ucmClient, logger, publishingAuthorId);
     }
     get name() {
-        return 'mcp_ucm_get_author_recents';
+        return 'ucm_get_author_recents';
     }
     get description() {
         return `Generate author activity tracking showing the 20 most recently modified artifacts within an author context. Your author id is '${this.publishingAuthorId}'`;

package/dist/tools/utility/HealthCheckController.js

@@ -1,12 +1,12 @@
 import { BaseToolController } from '../base/BaseToolController.js';
 //import packageJson from '../../../../publish/package.json' assert { type: 'json' };
-const version = '1.1.7'; //TODO: tried to sync this with packageJson but it didn't work.
+const version = '1.1.8'; //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);
     }
     get name() {
-        return 'mcp_ucm_health_check';
+        return 'ucm_health_check';
     }
     get description() {
         return 'Check MCP server and UCM API connectivity status';

package/dist/tools/utility/ListRepositoriesTool.js

@@ -4,7 +4,7 @@ export class ListRepositoriesTool extends BaseToolController {
         super(ucmClient, logger, publishingAuthorId);
     }
     get name() {
-        return 'mcp_ucm_list_repositories';
+        return 'ucm_list_repositories';
     }
     get description() {
         return 'List all repositories for a specific author with pagination and statistics';

package/dist/tools/utility/QuickstartTool.js

@@ -4,10 +4,10 @@ export class QuickstartTool extends BaseToolController {
         super(ucmClient, logger, publishingAuthorId);
     }
     get name() {
-        return 'mcp_ucm_quickstart';
+        return 'ucm_quickstart';
     }
     get description() {
-        return 'IMPORTANT: 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: 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.js

@@ -4,7 +4,7 @@ export class SubmitFeedbackTool extends BaseToolController {
         super(ucmClient, logger, publishingAuthorId);
     }
     get name() {
-        return 'mcp_ucm_submit_user_issue_or_feedback';
+        return 'ucm_submit_user_issue_or_feedback';
     }
     get description() {
         return 'Submit user feedback, bug reports, feature requests ONLY if the user requests it and they want to send details to the UCM development team. Do NOT include sensitive or project related details. Ask the user before submitting the data if it is appropriate.';

package/dist/utils/McpErrorHandler.js

@@ -51,7 +51,7 @@ export class McpErrorHandler {
             return new McpError(McpErrorCode.InvalidParams, 'Parameter validation failed', { originalError: error });
         }
         if (message?.includes('ECONNREFUSED')) {
-            return new McpError(McpErrorCode.ExternalServiceUnavailable, 'External API is unavailable, try the mcp_ucm_health_check tool', { originalError: error });
+            return new McpError(McpErrorCode.ExternalServiceUnavailable, 'External API is unavailable, try the ucm_health_check tool', { originalError: error });
         }
         if (message?.includes('validation') || message?.includes('invalid') ||
             message?.includes('required') || message?.includes('must be')) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@utaba/ucm-mcp-server",
-  "version": "1.1.8",
+  "version": "2.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": "1.1.8",
+  "version": "2.0.0",
   "description": "Universal Context Manager MCP Server - AI-native artifact management",
   "main": "dist/index.js",
   "type": "module",