@mediagraph/mcp 1.0.7 → 1.0.9

package/dist/index.js

@@ -651,7 +651,7 @@ var MediagraphClient = class {
     return this.request("GET", "/api/assets/updated_since_last_sync", { params });
   }
   async addTagsToAsset(id, tags) {
-    return this.request("POST", `/api/assets/${id}/tag`, { body: { tags } });
+    return this.request("PUT", `/api/assets/${id}/tag`, { body: { asset: { add_tag_names: tags } } });
   }
   async getAssetAutoTags(id) {
     return this.request("GET", `/api/assets/${id}/auto_tags`);
@@ -659,16 +659,20 @@ var MediagraphClient = class {
   async getAssetFaceTaggings(id) {
     return this.request("GET", `/api/assets/${id}/face_taggings`);
   }
-  async getAssetDownload(id, rendition) {
+  async getAssetDownload(id, options) {
     const params = {};
-    if (rendition) params.rendition = rendition;
+    if (options?.size) params.size = options.size;
+    if (options?.watermarked) params.watermarked = true;
+    if (options?.version_number) params.version_number = options.version_number;
+    if (options?.via) params.via = options.via;
+    if (options?.skip_meta) params.skip_meta = true;
     return this.request("GET", `/api/assets/${id}/download`, { params });
   }
   async addAssetVersion(id, data) {
     return this.request("POST", `/api/assets/${id}/add_version`, { body: data });
   }
-  async revertAsset(id, versionNumber) {
-    return this.request("POST", `/api/assets/${id}/revert`, { body: { version_number: versionNumber } });
+  async revertAsset(id, version) {
+    return this.request("POST", `/api/assets/${id}/revert`, { body: { version } });
   }
   async requestAssetOptimization(id) {
     return this.request("POST", `/api/assets/${id}/request_optimization`);
@@ -677,14 +681,17 @@ var MediagraphClient = class {
     return this.request("POST", `/api/assets/${id}/complete_optimization`);
   }
   async removeAssetOptimizationRequest(id) {
-    return this.request("DELETE", `/api/assets/${id}/remove_optimization_request`);
+    return this.request("POST", `/api/assets/${id}/remove_optimization_request`);
   }
   async updateAssetCollectiveWork(id, data) {
     return this.request("PUT", `/api/assets/${id}/update_collective_work`, { body: data });
   }
-  async addAssetsToGroup(assetIds, groupId, groupType) {
+  async addAssetsToGroup(assetIds, groupId) {
     await this.request("POST", "/api/assets/add_group", {
-      body: { asset_ids: assetIds, group_id: groupId, group_type: groupType }
+      body: {
+        ids: assetIds,
+        asset_group_id: groupId
+      }
     });
   }
   // ============================================================================
@@ -721,7 +728,9 @@ var MediagraphClient = class {
     return this.request("GET", "/api/collections/tree");
   }
   async getCollectionVisibleAssetCounts(ids) {
-    return this.request("GET", "/api/collections/visible_asset_counts", { params: { ids } });
+    return this.request("POST", "/api/collections/visible_asset_counts", {
+      body: { asset_groups: ids.map((id) => ({ id })) }
+    });
   }
   async addAssetToCollection(collectionId, assetId) {
     await this.request("POST", `/api/collections/${collectionId}/add_asset`, { body: { asset_id: assetId } });
@@ -751,7 +760,7 @@ var MediagraphClient = class {
     return this.request("POST", `/api/lightboxes/${id}/transfer_ownership`, { body: { user_id: userId } });
   }
   async addAssetToLightbox(lightboxId, assetId) {
-    await this.request("POST", `/api/lightboxes/${lightboxId}/add_asset`, { body: { asset_id: assetId } });
+    await this.addAssetsToGroup([Number(assetId)], Number(lightboxId));
   }
   // ============================================================================
   // Storage Folders
@@ -799,10 +808,10 @@ var MediagraphClient = class {
     return this.request("POST", "/api/tags/bulk_find", { body: { names } });
   }
   async addTagToTaxonomy(id, taxonomyId) {
-    return this.request("POST", `/api/tags/${id}/add_taxonomy`, { body: { taxonomy_id: taxonomyId } });
+    return this.request("PUT", `/api/tags/${id}/add_taxonomy`, { body: { taxonomy_id: taxonomyId } });
   }
   async mergeTagInto(id, targetTagId) {
-    await this.request("POST", `/api/tags/${id}/merge_into`, { body: { target_tag_id: targetTagId } });
+    await this.request("POST", `/api/tags/${id}/merge_into`, { body: { tag_2_id: targetTagId } });
   }
   async getTagEvents(params) {
     return this.request("GET", "/api/tags/events", { params });
@@ -816,8 +825,11 @@ var MediagraphClient = class {
   async getAutoTag(id) {
     return this.request("GET", `/api/auto_tags/${id}`);
   }
-  async bulkFindAutoTags(names) {
-    return this.request("POST", "/api/auto_tags/bulk_find", { body: { names } });
+  async bulkFindAutoTags(tagNames) {
+    return this.request("POST", "/api/auto_tags/bulk_find", { body: { tag_names: tagNames } });
+  }
+  async deleteAutoTag(id) {
+    await this.request("DELETE", `/api/auto_tags/${id}`);
   }
   // ============================================================================
   // Taggings
@@ -936,8 +948,10 @@ var MediagraphClient = class {
   async getShareLink(id) {
     return this.request("GET", `/api/share_links/${id}`);
   }
-  async createShareLink(data) {
-    return this.request("POST", "/api/share_links", { body: { share_link: data } });
+  async createShareLink(assetGroupId, data) {
+    return this.request("POST", `/api/asset_groups/${assetGroupId}/share_links`, {
+      body: data ? { share_link: data } : void 0
+    });
   }
   async updateShareLink(id, data) {
     return this.request("PUT", `/api/share_links/${id}`, { body: { share_link: data } });
@@ -1014,8 +1028,14 @@ var MediagraphClient = class {
   async listUploads(params) {
     return this.request("GET", "/api/uploads", { params });
   }
-  async createUpload() {
-    return this.request("POST", "/api/uploads");
+  async createUpload(data) {
+    return this.request("POST", "/api/uploads", data ? { body: { upload: data } } : void 0);
+  }
+  /**
+   * Create upload session from a contribution - assets will go to the contribution's configured destination
+   */
+  async createUploadFromContribution(contributionId, data) {
+    return this.request("POST", `/api/contributions/${contributionId}/uploads`, data ? { body: { upload: data } } : void 0);
   }
   async getUploadAssets(guid, params) {
     return this.request("GET", `/api/uploads/${guid}/assets`, { params });
@@ -1054,7 +1074,7 @@ var MediagraphClient = class {
     }
   }
   async setUploadDone(id) {
-    return this.request("POST", `/api/uploads/${id}/set_done`);
+    return this.request("PUT", `/api/uploads/${id}/set_done`);
   }
   async canUpload() {
     return this.request("GET", "/api/can_upload");
@@ -1143,8 +1163,8 @@ var MediagraphClient = class {
   async exportCustomMetaField(id) {
     return this.request("GET", `/api/custom_meta_fields/${id}/export`);
   }
-  async importCustomMetaFields(data) {
-    return this.request("POST", "/api/custom_meta_fields/import", { body: data });
+  async importCustomMetaFields(settings) {
+    return this.request("POST", "/api/custom_meta_fields/import", { body: { settings } });
   }
   async getAccessRequestCustomMetaFields() {
     return this.request("GET", "/api/custom_meta_fields/access_requests");
@@ -1185,8 +1205,8 @@ var MediagraphClient = class {
   async deleteWorkflowStep(id) {
     await this.request("DELETE", `/api/workflow_steps/${id}`);
   }
-  async approveWorkflowStep(id) {
-    return this.request("POST", `/api/workflow_steps/${id}/approve`);
+  async approveWorkflowStep(id, assetIds) {
+    return this.request("POST", `/api/workflow_steps/${id}/approve`, { body: { asset_ids: assetIds } });
   }
   // ============================================================================
   // Comments
@@ -1197,8 +1217,11 @@ var MediagraphClient = class {
   async getComment(id) {
     return this.request("GET", `/api/comments/${id}`);
   }
-  async createComment(data) {
-    return this.request("POST", "/api/comments", { body: { comment: data } });
+  async createComment(type, id, data) {
+    return this.request("POST", "/api/comments", {
+      params: { type, id },
+      body: { comment: data }
+    });
   }
   async updateComment(id, data) {
     return this.request("PUT", `/api/comments/${id}`, { body: { comment: data } });
@@ -1248,8 +1271,8 @@ var MediagraphClient = class {
   async getWebhookLogs(id, params) {
     return this.request("GET", `/api/webhooks/${id}/logs`, { params });
   }
-  async testWebhook(data) {
-    return this.request("POST", "/api/webhooks/test", { body: data });
+  async testWebhook(url) {
+    return this.request("POST", "/api/webhooks/test", { body: { url } });
   }
   async getWebhookPayload() {
     return this.request("GET", "/api/webhooks/payload");
@@ -1300,7 +1323,7 @@ var MediagraphClient = class {
     return this.request("GET", "/api/invites/find", { params });
   }
   async checkInviteEmail(email) {
-    return this.request("GET", "/api/invites/check_email", { params: { email } });
+    return this.request("POST", "/api/invites/check_email", { body: { email } });
   }
   async getAvailableRoleLevels() {
     return this.request("GET", "/api/invites/available_role_levels");
@@ -1323,8 +1346,10 @@ var MediagraphClient = class {
   async deleteFilterGroup(id) {
     await this.request("DELETE", `/api/filter_groups/${id}`);
   }
-  async updateFilterGroupVisibility(id, shared) {
-    return this.request("PUT", `/api/filter_groups/${id}/update_visibility`, { body: { shared } });
+  async updateFilterGroupVisibility(id, data) {
+    return this.request("PUT", `/api/filter_groups/${id}/update_visibility`, {
+      body: { name: data.name, type: data.type, visible: String(data.visible) }
+    });
   }
   // ============================================================================
   // Search Queries
@@ -1362,8 +1387,8 @@ var MediagraphClient = class {
   async deleteCropPreset(id) {
     await this.request("DELETE", `/api/crop_presets/${id}`);
   }
-  async updateCropPresetPosition(id, position) {
-    return this.request("PUT", "/api/crop_presets/update_position", { body: { id, position } });
+  async updateCropPresetPosition(oldIndex, newIndex) {
+    return this.request("PUT", "/api/crop_presets/update_position", { body: { oldIndex, newIndex } });
   }
   // ============================================================================
   // Ingestions
@@ -1614,7 +1639,13 @@ COMMON SEARCH FIELDS:
         type: "object",
         properties: {
           id: idParam,
-          rendition: { type: "string", description: "Specific rendition (original, full, medium, small)" }
+          size: {
+            type: "string",
+            enum: ["small", "permalink", "full", "original"],
+            description: "Maximum size for the download (default: original)"
+          },
+          watermarked: { type: "boolean", description: "Request watermarked version" },
+          version_number: { type: "number", description: "Specific version number to download" }
         },
         required: ["id"]
       }
@@ -1641,9 +1672,9 @@ COMMON SEARCH FIELDS:
         type: "object",
         properties: {
           id: idParam,
-          version_number: { type: "number", description: "Version number to revert to" }
+          version: { type: "number", description: "Version number to revert to" }
         },
-        required: ["id", "version_number"]
+        required: ["id", "version"]
       }
     },
     {
@@ -1692,7 +1723,11 @@ COMMON SEARCH FIELDS:
       return successResult(await client2.addTagsToAsset(args.id, args.tags));
     },
     async get_asset_download(args, { client: client2 }) {
-      return successResult(await client2.getAssetDownload(args.id, args.rendition));
+      return successResult(await client2.getAssetDownload(args.id, {
+        size: args.size,
+        watermarked: args.watermarked,
+        version_number: args.version_number
+      }));
     },
     async get_asset_auto_tags(args, { client: client2 }) {
       return successResult(await client2.getAssetAutoTags(args.id));
@@ -1704,7 +1739,7 @@ COMMON SEARCH FIELDS:
       return successResult(await client2.getAssetDataVersions(args.asset_id));
     },
     async revert_asset(args, { client: client2 }) {
-      return successResult(await client2.revertAsset(args.id, args.version_number));
+      return successResult(await client2.revertAsset(args.id, args.version));
     },
     async get_asset_counts(args, { client: client2 }) {
       return successResult(await client2.getAssetCounts(args));
@@ -1781,6 +1816,19 @@ var groupTools = {
       description: "Get collections hierarchy as a tree",
       inputSchema: { type: "object", properties: {}, required: [] }
     },
+    // Multi-asset group operations
+    {
+      name: "add_assets_to_group",
+      description: "Add multiple assets to a Collection or Lightbox at once",
+      inputSchema: {
+        type: "object",
+        properties: {
+          ids: { type: "array", items: { type: "number" }, description: "Array of asset IDs to add" },
+          asset_group_id: { ...idParam, description: "ID of Collection or Lightbox" }
+        },
+        required: ["ids", "asset_group_id"]
+      }
+    },
     // Lightboxes
     {
       name: "list_lightboxes",
@@ -1893,6 +1941,13 @@ var groupTools = {
     async get_collections_tree(_args, { client: client2 }) {
       return successResult(await client2.getCollectionsTree());
     },
+    async add_assets_to_group(args, { client: client2 }) {
+      await client2.addAssetsToGroup(
+        args.ids,
+        args.asset_group_id
+      );
+      return successResult({ success: true, added_count: args.ids.length });
+    },
     // Lightboxes
     async list_lightboxes(args, { client: client2 }) {
       return successResult(await client2.listLightboxes(args));
@@ -1990,6 +2045,11 @@ var tagTools = {
       description: "Get details of a specific tagging (tag-to-asset relationship)",
       inputSchema: { type: "object", properties: { id: idParam }, required: ["id"] }
     },
+    {
+      name: "delete_tagging",
+      description: "Remove a tagging (untag an asset)",
+      inputSchema: { type: "object", properties: { id: idParam }, required: ["id"] }
+    },
     // Auto Tags
     {
       name: "list_auto_tags",
@@ -2000,6 +2060,25 @@ var tagTools = {
         required: []
       }
     },
+    {
+      name: "get_auto_tag",
+      description: "Get auto tag details",
+      inputSchema: { type: "object", properties: { id: idParam }, required: ["id"] }
+    },
+    {
+      name: "bulk_find_auto_tags",
+      description: "Find multiple auto tags by their names at once",
+      inputSchema: {
+        type: "object",
+        properties: { tag_names: { type: "array", items: { type: "string" }, description: "Array of auto tag names to find" } },
+        required: ["tag_names"]
+      }
+    },
+    {
+      name: "delete_auto_tag",
+      description: "Delete/dismiss an auto tag",
+      inputSchema: { type: "object", properties: { id: idParam }, required: ["id"] }
+    },
     // Taxonomies
     {
       name: "list_taxonomies",
@@ -2085,10 +2164,24 @@ var tagTools = {
     async get_tagging(args, { client: client2 }) {
       return successResult(await client2.getTagging(args.id));
     },
+    async delete_tagging(args, { client: client2 }) {
+      await client2.deleteTagging(args.id);
+      return successResult({ success: true });
+    },
     // Auto Tags
     async list_auto_tags(args, { client: client2 }) {
       return successResult(await client2.listAutoTags(args));
     },
+    async get_auto_tag(args, { client: client2 }) {
+      return successResult(await client2.getAutoTag(args.id));
+    },
+    async bulk_find_auto_tags(args, { client: client2 }) {
+      return successResult(await client2.bulkFindAutoTags(args.tag_names));
+    },
+    async delete_auto_tag(args, { client: client2 }) {
+      await client2.deleteAutoTag(args.id);
+      return successResult({ success: true });
+    },
     // Taxonomies
     async list_taxonomies(args, { client: client2 }) {
       return successResult(await client2.listTaxonomies(args));
@@ -2173,18 +2266,27 @@ var sharingTools = {
     },
     {
       name: "create_share_link",
-      description: "Create a share link for assets, collection, or lightbox",
+      description: "Create a share link for a Collection, Lightbox, or Storage Folder",
       inputSchema: {
         type: "object",
         properties: {
-          asset_ids: { type: "array", items: { type: "number" } },
-          collection_id: { type: "number" },
-          lightbox_id: { type: "number" },
-          name: { type: "string" },
-          password: { type: "string" },
-          expires_at: { type: "string" }
+          asset_group_id: { ...idParam, description: "ID of the Collection, Lightbox, or Storage Folder to share" },
+          enabled: { type: "boolean", description: "Enable the share link (default: true)" },
+          image_and_video_permission: {
+            type: "string",
+            enum: ["view", "download_small", "download_large", "download_original"],
+            description: "Permission level for images and videos"
+          },
+          other_permission: {
+            type: "string",
+            enum: ["view", "download"],
+            description: "Permission level for other file types"
+          },
+          watermark_all: { type: "boolean", description: "Apply watermark to all downloads" },
+          note: { type: "string", description: "Internal note" },
+          expires_at: { type: "string", description: "Expiration date/time in ISO 8601 format" }
         },
-        required: []
+        required: ["asset_group_id"]
       }
     },
     {
@@ -2226,7 +2328,8 @@ var sharingTools = {
       return successResult(await client2.getShareLink(args.id));
     },
     async create_share_link(args, { client: client2 }) {
-      return successResult(await client2.createShareLink(args));
+      const { asset_group_id, ...data } = args;
+      return successResult(await client2.createShareLink(asset_group_id, data));
     },
     async delete_share_link(args, { client: client2 }) {
       await client2.deleteShareLink(args.id);
@@ -2261,15 +2364,41 @@ var jobTools = {
     },
     {
       name: "create_bulk_job",
-      description: "Create a bulk job for batch operations on assets",
+      description: `Create a bulk job for batch operations on assets. Supports multiple operation types:
+- Tag management: use tag_names + tag_mode (add/remove/replace)
+- Metadata updates: use description + description_mode (set/append/prepend), rating, rights_package_id
+- Organization: use add_asset_group_id + add_asset_group_type (Collection/Lightbox/StorageFolder)
+- AI processing: use run_custom_meta_field_ids + cmf_overwrite_mode (skip/overwrite)
+- Bulk actions: use destroy_all, restore_all, or generate_alt_text`,
       inputSchema: {
         type: "object",
         properties: {
           asset_ids: { type: "array", items: { type: "number" }, description: "Asset IDs to process" },
-          action: { type: "string", description: "Bulk action (add_tags, remove_tags, add_to_collection, etc.)" },
-          params: { type: "object", description: "Action parameters" }
+          // Tag operations
+          tag_names: { type: "array", items: { type: "string" }, description: "Tag names to add/remove/replace" },
+          tag_mode: { type: "string", enum: ["add", "remove", "replace"], description: "Tag operation mode" },
+          // Metadata operations
+          description: { type: "string", description: "Description text to set/append/prepend" },
+          description_mode: { type: "string", enum: ["set", "append", "prepend"], description: "Description operation mode" },
+          rights_package_id: { type: "number", description: "Rights Package ID to assign" },
+          rights_status: { type: "string", description: "Rights status code" },
+          rating: { type: "number", minimum: 0, maximum: 5, description: "Rating value (0-5)" },
+          // Organization operations
+          add_asset_group_id: { type: "number", description: "ID of Collection/Lightbox/StorageFolder to add assets to" },
+          add_asset_group_type: { type: "string", enum: ["Collection", "Lightbox", "StorageFolder"], description: "Type of asset group" },
+          remove_asset_group_id: { type: "number", description: "ID of Collection/Lightbox to remove assets from" },
+          remove_asset_group_type: { type: "string", description: "Type of asset group to remove from" },
+          // Custom meta operations
+          custom_meta: { type: "object", description: "Custom meta field values to set (keyed by field name)" },
+          run_custom_meta_field_ids: { type: "array", items: { type: "number" }, description: "Custom Meta Field IDs to run AI on" },
+          cmf_overwrite_mode: { type: "string", enum: ["skip", "overwrite"], description: "Whether to overwrite existing values when running AI" },
+          // Bulk actions
+          destroy_all: { type: "boolean", description: "Delete all specified assets" },
+          restore_all: { type: "boolean", description: "Restore all specified assets from trash" },
+          generate_alt_text: { type: "boolean", description: "Generate alt text using AI" },
+          alt_text_generation_prompt: { type: "string", description: "Custom prompt for alt text generation" }
         },
-        required: ["asset_ids", "action"]
+        required: ["asset_ids"]
       }
     },
     {
@@ -2392,8 +2521,15 @@ var workflowTools = {
     },
     {
       name: "approve_workflow_step",
-      description: "Approve a workflow step",
-      inputSchema: { type: "object", properties: { id: idParam }, required: ["id"] }
+      description: "Approve selected assets in a workflow step, moving them to the next step",
+      inputSchema: {
+        type: "object",
+        properties: {
+          id: idParam,
+          asset_ids: { type: "array", items: { type: "number" }, description: "Array of asset IDs to approve" }
+        },
+        required: ["id", "asset_ids"]
+      }
     }
   ],
   handlers: {
@@ -2404,7 +2540,7 @@ var workflowTools = {
       return successResult(await client2.getWorkflow(args.id));
     },
     async approve_workflow_step(args, { client: client2 }) {
-      return successResult(await client2.approveWorkflowStep(args.id));
+      return successResult(await client2.approveWorkflowStep(args.id, args.asset_ids));
     }
   }
 };
@@ -2415,34 +2551,45 @@ var socialTools = {
     // Comments
     {
       name: "list_comments",
-      description: "List comments on a resource",
+      description: "List comments on a Lightbox or Collection",
       inputSchema: {
         type: "object",
         properties: {
-          commentable_type: { type: "string", enum: ["Asset", "Collection", "Lightbox"] },
-          commentable_id: { type: "number" },
+          type: { type: "string", enum: ["Lightbox", "Collection"], description: "Type of commentable object" },
+          id: { type: "number", description: "ID of the commentable object" },
           ...paginationParams
         },
-        required: ["commentable_type", "commentable_id"]
+        required: ["type", "id"]
       }
     },
     {
       name: "create_comment",
-      description: "Create a comment",
+      description: "Create a new comment on a Lightbox or Collection. Supports markdown and @mentions.",
       inputSchema: {
         type: "object",
         properties: {
-          body: { type: "string" },
-          commentable_type: { type: "string", enum: ["Asset", "Collection", "Lightbox"] },
-          commentable_id: { type: "number" },
-          parent_id: { type: "number" }
+          type: { type: "string", enum: ["Lightbox", "Collection"], description: "Type of commentable object" },
+          id: { type: "number", description: "ID of the commentable object" },
+          text: { type: "string", description: "Comment text (supports markdown and @mentions)" }
+        },
+        required: ["type", "id", "text"]
+      }
+    },
+    {
+      name: "update_comment",
+      description: "Update a comment. Only the comment author can update their own comments.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          id: idParam,
+          text: { type: "string", description: "Updated comment text" }
         },
-        required: ["body", "commentable_type", "commentable_id"]
+        required: ["id", "text"]
       }
     },
     {
       name: "delete_comment",
-      description: "Delete a comment",
+      description: "Delete a comment. Only the comment author can delete their own comments.",
       inputSchema: { type: "object", properties: { id: idParam }, required: ["id"] }
     },
     // Notifications
@@ -2463,7 +2610,17 @@ var socialTools = {
       return successResult(await client2.listComments(args));
     },
     async create_comment(args, { client: client2 }) {
-      return successResult(await client2.createComment(args));
+      return successResult(await client2.createComment(
+        args.type,
+        args.id,
+        { text: args.text }
+      ));
+    },
+    async update_comment(args, { client: client2 }) {
+      return successResult(await client2.updateComment(
+        args.id,
+        { text: args.text }
+      ));
     },
     async delete_comment(args, { client: client2 }) {
       await client2.deleteComment(args.id);
@@ -2489,7 +2646,11 @@ var downloadTools = {
         type: "object",
         properties: {
           asset_ids: { type: "array", items: { type: "number" } },
-          rendition: { type: "string" }
+          size: {
+            type: "string",
+            enum: ["small", "small-watermark", "permalink", "permalink-watermark", "full", "full-watermark", "original"],
+            description: "Maximum size requested for assets in the download"
+          }
         },
         required: ["asset_ids"]
       }
@@ -2565,7 +2726,10 @@ var uploadTools = {
 
 This creates a new asset in the user's Mediagraph library.
 Supports images, videos, audio, documents, and other media files.
-The file will be processed and thumbnails/previews generated automatically.`,
+The file will be processed and thumbnails/previews generated automatically.
+
+By default, assets are uploaded to the default storage folder. To upload to a specific destination,
+provide a contribution_id - the asset will go to the contribution's configured storage folder or lightbox.`,
       inputSchema: {
         type: "object",
         properties: {
@@ -2581,9 +2745,9 @@ The file will be processed and thumbnails/previews generated automatically.`,
             type: "string",
             description: "Filename with extension (required when using file_data)"
           },
-          storage_folder_id: {
+          contribution_id: {
             type: "number",
-            description: "Optional: ID of the storage folder to upload into"
+            description: "Optional: ID of a contribution (upload link) to upload through. Assets will go to the contribution's configured storage folder or lightbox."
           }
         },
         required: []
@@ -2593,7 +2757,10 @@ The file will be processed and thumbnails/previews generated automatically.`,
       name: "upload_files",
       description: `Upload multiple files from the local filesystem to Mediagraph.
 Creates new assets for each file in the user's Mediagraph library.
-All files are uploaded in a single upload session.`,
+All files are uploaded in a single upload session.
+
+By default, assets are uploaded to the default storage folder. To upload to a specific destination,
+provide a contribution_id - assets will go to the contribution's configured storage folder or lightbox.`,
       inputSchema: {
         type: "object",
         properties: {
@@ -2602,9 +2769,9 @@ All files are uploaded in a single upload session.`,
             items: { type: "string" },
             description: "Array of absolute paths to files on the local filesystem"
           },
-          storage_folder_id: {
+          contribution_id: {
             type: "number",
-            description: "Optional: ID of the storage folder to upload into"
+            description: "Optional: ID of a contribution (upload link) to upload through. Assets will go to the contribution's configured storage folder or lightbox."
           }
         },
         required: ["file_paths"]
@@ -2616,6 +2783,7 @@ All files are uploaded in a single upload session.`,
       const filePath = args.file_path;
       const fileDataB64 = args.file_data;
       const providedFilename = args.filename;
+      const contributionId = args.contribution_id;
       let fileData;
       let filename;
       let fileSize;
@@ -2643,7 +2811,7 @@ All files are uploaded in a single upload session.`,
         return errorResult("Either file_path or file_data (with filename) is required");
       }
       const contentType = getMimeType(filename);
-      const upload = await client2.createUpload();
+      const upload = contributionId ? await client2.createUploadFromContribution(contributionId) : await client2.createUpload();
       const preparedAsset = await client2.prepareAssetUpload(upload.guid, {
         filename,
         file_size: fileSize,
@@ -2653,7 +2821,7 @@ All files are uploaded in a single upload session.`,
       const asset = await client2.setAssetUploaded(preparedAsset.guid);
       await client2.setUploadDone(upload.id);
       return successResult({
-        message: `Successfully uploaded ${filename}`,
+        message: `Successfully uploaded ${filename}${contributionId ? ` via contribution ${contributionId}` : ""}`,
         asset: {
           id: asset.id,
           guid: asset.guid,
@@ -2661,15 +2829,17 @@ All files are uploaded in a single upload session.`,
           file_size: asset.file_size,
           mime_type: asset.mime_type
         },
-        upload_guid: upload.guid
+        upload_guid: upload.guid,
+        contribution_id: contributionId
       });
     },
     async upload_files(args, { client: client2 }) {
       const filePaths = args.file_paths;
+      const contributionId = args.contribution_id;
       if (!filePaths || filePaths.length === 0) {
         return errorResult("No files provided");
       }
-      const upload = await client2.createUpload();
+      const upload = contributionId ? await client2.createUploadFromContribution(contributionId) : await client2.createUpload();
       const results = [];
       for (const filePath of filePaths) {
         try {
@@ -2705,8 +2875,9 @@ All files are uploaded in a single upload session.`,
       await client2.setUploadDone(upload.id);
       const successCount = results.filter((r) => r.success).length;
       return successResult({
-        message: `Uploaded ${successCount} of ${filePaths.length} files`,
+        message: `Uploaded ${successCount} of ${filePaths.length} files${contributionId ? ` via contribution ${contributionId}` : ""}`,
         upload_guid: upload.guid,
+        contribution_id: contributionId,
         results
       });
     }
@@ -2728,15 +2899,24 @@ var webhookTools = {
     },
     {
       name: "create_webhook",
-      description: "Create a webhook",
+      description: "Create a webhook to receive event notifications",
       inputSchema: {
         type: "object",
         properties: {
-          name: { type: "string" },
-          url: { type: "string" },
-          events: { type: "array", items: { type: "string" } }
+          name: { type: "string", description: "Webhook name" },
+          url: { type: "string", description: "Destination URL to POST events to" },
+          events: {
+            type: "string",
+            description: "Comma-separated list of events: asset.created, asset.updated, asset.deleted, asset.restored, collection.updated"
+          },
+          enabled: { type: "boolean", description: "Enable the webhook (default: true)" },
+          asset_group_id: { type: "number", description: "Scope to specific Collection or StorageFolder" },
+          include_download_url: { type: "boolean", description: "Include asset download URL in payload" },
+          group_assets: { type: "boolean", description: "Group multiple asset events into single request" },
+          trash: { type: "boolean", description: "Include trash events" },
+          note: { type: "string", description: "Internal notes" }
         },
-        required: ["name", "url", "events"]
+        required: ["name", "url"]
       }
     },
     {
@@ -2800,21 +2980,22 @@ var adminTools = {
       inputSchema: {
         type: "object",
         properties: {
-          email: { type: "string" },
-          role: { type: "string", enum: ["admin", "global_content", "global_library", "global_tagger", "general", "restricted"] }
+          email: { type: "string", description: "Email address(es) to invite (comma/semicolon separated for multiple)" },
+          role_level: { type: "string", enum: ["admin", "global_content", "global_library", "global_tagger", "general", "restricted"] },
+          note: { type: "string", description: "Note to include in invite email" }
         },
-        required: ["email", "role"]
+        required: ["email", "role_level"]
       }
     },
     {
       name: "update_invite",
-      description: "Update an invite (change email or role)",
+      description: "Update an invite (change role or note)",
       inputSchema: {
         type: "object",
         properties: {
           id: idParam,
-          email: { type: "string" },
-          role: { type: "string", enum: ["admin", "global_content", "global_library", "global_tagger", "general", "restricted"] }
+          role_level: { type: "string", enum: ["admin", "global_content", "global_library", "global_tagger", "general", "restricted"] },
+          note: { type: "string" }
         },
         required: ["id"]
       }
@@ -2830,37 +3011,97 @@ var adminTools = {
       description: "List saved filter groups",
       inputSchema: { type: "object", properties: { ...paginationParams }, required: [] }
     },
+    {
+      name: "get_filter_group",
+      description: "Get filter group details",
+      inputSchema: { type: "object", properties: { id: idParam }, required: ["id"] }
+    },
     {
       name: "create_filter_group",
-      description: "Save a filter group",
+      description: "Create a new filter group with saved filter configurations",
+      inputSchema: {
+        type: "object",
+        properties: {
+          name: { type: "string" },
+          filter_order: { type: "array", items: { type: "string" }, description: "Array of filter names in display order" }
+        },
+        required: ["name"]
+      }
+    },
+    {
+      name: "update_filter_group",
+      description: "Update a filter group",
       inputSchema: {
         type: "object",
         properties: {
+          id: idParam,
           name: { type: "string" },
-          filters: { type: "object", description: "Filter parameters to save" }
+          filter_order: { type: "array", items: { type: "string" }, description: "Array of filter names in display order" }
+        },
+        required: ["id"]
+      }
+    },
+    {
+      name: "update_filter_group_visibility",
+      description: "Update the visibility of a specific filter within a filter group",
+      inputSchema: {
+        type: "object",
+        properties: {
+          id: idParam,
+          name: { type: "string", description: "Filter name" },
+          type: { type: "string", enum: ["explore", "manage"], description: "Visibility type" },
+          visible: { type: "boolean", description: "Visibility status" }
         },
-        required: ["name", "filters"]
+        required: ["id", "name", "type", "visible"]
       }
     },
+    {
+      name: "delete_filter_group",
+      description: "Delete a filter group",
+      inputSchema: { type: "object", properties: { id: idParam }, required: ["id"] }
+    },
     // Search Queries
     {
       name: "list_search_queries",
       description: "List saved search queries",
       inputSchema: { type: "object", properties: { ...paginationParams }, required: [] }
     },
+    {
+      name: "get_search_query",
+      description: "Get search query details",
+      inputSchema: { type: "object", properties: { id: idParam }, required: ["id"] }
+    },
     {
       name: "create_search_query",
-      description: "Save a search query",
+      description: "Save a new search query. The sql field should contain an Elasticsearch SQL WHERE clause.",
       inputSchema: {
         type: "object",
         properties: {
+          name: { type: "string", description: "Search name" },
+          description: { type: "string", description: "Search description" },
+          sql: { type: "string", description: "SQL WHERE clause (Elasticsearch SQL syntax)" }
+        },
+        required: ["name", "sql"]
+      }
+    },
+    {
+      name: "update_search_query",
+      description: "Update a saved search query name or description. Note: The SQL query cannot be changed after creation.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          id: idParam,
           name: { type: "string" },
-          query: { type: "string" },
-          filters: { type: "object" }
+          description: { type: "string" }
         },
-        required: ["name", "query"]
+        required: ["id"]
       }
     },
+    {
+      name: "delete_search_query",
+      description: "Delete a saved search query",
+      inputSchema: { type: "object", properties: { id: idParam }, required: ["id"] }
+    },
     // Crop Presets
     {
       name: "list_crop_presets",
@@ -2906,7 +3147,7 @@ var adminTools = {
     // Contributions
     {
       name: "list_contributions",
-      description: "List contribution portals",
+      description: "List contribution portals (upload links). Use contribution_id with upload_file/upload_files to upload to a specific storage folder or lightbox.",
       inputSchema: { type: "object", properties: { ...paginationParams }, required: [] }
     },
     {
@@ -2964,16 +3205,44 @@ var adminTools = {
     async list_filter_groups(args, { client: client2 }) {
       return successResult(await client2.listFilterGroups(args));
     },
+    async get_filter_group(args, { client: client2 }) {
+      return successResult(await client2.getFilterGroup(args.id));
+    },
     async create_filter_group(args, { client: client2 }) {
       return successResult(await client2.createFilterGroup(args));
     },
+    async update_filter_group(args, { client: client2 }) {
+      const { id, ...data } = args;
+      return successResult(await client2.updateFilterGroup(id, data));
+    },
+    async update_filter_group_visibility(args, { client: client2 }) {
+      return successResult(await client2.updateFilterGroupVisibility(
+        args.id,
+        { name: args.name, type: args.type, visible: args.visible }
+      ));
+    },
+    async delete_filter_group(args, { client: client2 }) {
+      await client2.deleteFilterGroup(args.id);
+      return successResult({ success: true });
+    },
     // Search Queries
     async list_search_queries(args, { client: client2 }) {
       return successResult(await client2.listSearchQueries(args));
     },
+    async get_search_query(args, { client: client2 }) {
+      return successResult(await client2.getSearchQuery(args.id));
+    },
     async create_search_query(args, { client: client2 }) {
       return successResult(await client2.createSearchQuery(args));
     },
+    async update_search_query(args, { client: client2 }) {
+      const { id, ...data } = args;
+      return successResult(await client2.updateSearchQuery(id, data));
+    },
+    async delete_search_query(args, { client: client2 }) {
+      await client2.deleteSearchQuery(args.id);
+      return successResult({ success: true });
+    },
     // Crop Presets
     async list_crop_presets(args, { client: client2 }) {
       return successResult(await client2.listCropPresets(args));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mediagraph/mcp",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "description": "MCP server for Mediagraph - Media Asset Management Platform",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",