@kolbo/mcp 1.120.3 → 1.121.0

package/README.md

@@ -321,6 +321,7 @@ Requires DaVinci Resolve Studio with the Kolbo plugin open (Workspace → Workfl
 | `generate_character_sheet` | Generate a multi-angle character sheet from reference images (credits) → pass URL to create_visual_dna or update_visual_dna |
 | `list_visual_dna_folders` / `create_visual_dna_folder` / `update_visual_dna_folder` / `delete_visual_dna_folder` / `move_visual_dna_to_folder` | Organize Visual DNA characters into user folders (create/rename/recolor/delete + move DNAs in/out) |
 | `create_project` / `update_project` / `archive_project` / `unarchive_project` | Project lifecycle (create/rename/describe/archive; deletion stays in-app) |
+| `publish_project` / `get_project_publication` / `unpublish_project` / `submit_project_to_catalog` / `remove_project_hero_video` | Publish a project as a public showcase link, with write-up and final video as hero |
 | `transfer_visual_dna` / `list_visual_dna_transfers` / `respond_visual_dna_transfer` | Send Visual DNAs you own to another Kolbo account (they accept a copy with new ids; optionally move instead of copy) |
 | `transfer_project` / `list_project_transfers` / `respond_project_transfer` | Hand a project you own to another Kolbo account (they accept; same ids; cast assets copied; payer history unchanged) |
 | `list_skills` / `create_skill` / `update_skill` / `delete_skill` | Skills — reusable named personas for the chat tool; `description` is the system instruction |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kolbo/mcp",
-  "version": "1.120.3",
+  "version": "1.121.0",
   "description": "Kolbo AI MCP Server - Generate images, videos, music, speech, and sound effects from Claude Code",
   "main": "src/index.js",
   "bin": {

package/src/toolAnnotations.js

@@ -8,15 +8,15 @@
  * or non-boolean entries whenever the registered tool surface changes.
  */
 
-const READ_ONLY = [
-  'get_video_inspection',
-  'get_flow_schema', 'list_flow_sessions', 'get_flow_session', 'validate_flow_session',
-  'estimate_flow_run', 'get_flow_run', 'list_flow_runs',
-  'list_morphious_styles',
-  'list_trends', 'get_trend', 'estimate_trend_run', 'get_trend_run', 'list_trend_runs',
+const READ_ONLY = [
+  'get_video_inspection',
+  'get_flow_schema', 'list_flow_sessions', 'get_flow_session', 'validate_flow_session',
+  'estimate_flow_run', 'get_flow_run', 'list_flow_runs',
+  'list_morphious_styles',
+  'list_trends', 'get_trend', 'estimate_trend_run', 'get_trend_run', 'list_trend_runs',
   'get_download_status',
-  'get_video_editor_schema', 'list_video_editor_sessions', 'get_video_editor_session',
-  'list_fonts', 'get_font', 'get_font_upload_status',
+  'get_video_editor_schema', 'list_video_editor_sessions', 'get_video_editor_session',
+  'list_fonts', 'get_font', 'get_font_upload_status',
   'get_creative_director_status', 'get_generation_status', 'list_models',
   'check_credits', 'show_plans', 'get_session_usage', 'list_voices',
   'chat_list_conversations', 'chat_get_messages',
@@ -25,7 +25,7 @@ const READ_ONLY = [
   'list_color_palettes', 'analyze_color_palette',
   'list_media', 'list_media_folders', 'get_media', 'get_media_stats',
   'list_presets', 'list_cinematic_presets',
-  'list_projects', 'get_project', 'list_sessions', 'list_project_context', 'get_project_profile',
+  'list_projects', 'get_project', 'get_project_publication', 'list_sessions', 'list_project_context', 'get_project_profile',
   'list_project_assets',
   'list_project_transfers', 'list_visual_dna_transfers',
   'list_session_generations',
@@ -41,18 +41,18 @@ const READ_ONLY = [
   'create_music_composition_plan',
 ];
 
-const OPEN_WORLD_READ_ONLY = [
-  // Reads public source media into private ephemeral scratch evidence, no library writes.
-  'prepare_video_inspection', 'inspect_video',
+const OPEN_WORLD_READ_ONLY = [
+  // Reads public source media into private ephemeral scratch evidence, no library writes.
+  'prepare_video_inspection', 'inspect_video',
   'blender_list_sessions', 'blender_get_scene', 'blender_search_docs',
   'blender_get_command_status',
   'adobe_list_sessions', 'adobe_get_project', 'adobe_get_timeline', 'adobe_get_command_status',
   'resolve_list_sessions', 'resolve_get_project', 'resolve_get_timeline', 'resolve_get_command_status',
 ];
 
-const PRIVATE_WRITE = [
-  'create_flow_session', 'duplicate_flow_session', 'move_flow_session', 'restore_flow_session',
-  'upload_font', 'rename_font', 'create_font_upload_ticket', 'font_upload_widget',
+const PRIVATE_WRITE = [
+  'create_flow_session', 'duplicate_flow_session', 'move_flow_session', 'restore_flow_session',
+  'upload_font', 'rename_font', 'create_font_upload_ticket', 'font_upload_widget',
   'create_video_editor_session',
   'media_upload_widget', 'create_upload_ticket', 'upload_media',
   'favorite_media', 'unfavorite_media', 'dislike_media', 'undislike_media', 'rate_media', 'clear_media_rating',
@@ -70,7 +70,7 @@ const PRIVATE_WRITE = [
   'split_session', 'undo_session_organization',
   'rename_session', 'restore_session',
   'create_project', 'duplicate_project', 'update_project',
-  'archive_project', 'unarchive_project', 'add_project_context',
+  'archive_project', 'unarchive_project', 'add_project_context', 'remove_project_hero_video',
   'link_project_asset', 'unlink_project_asset',
   'create_agent', 'create_skill',
   'create_doc',
@@ -81,14 +81,14 @@ const PRIVATE_WRITE = [
   'import_stock_asset',
 ];
 
-const DESTRUCTIVE_WRITE = [
-  'update_flow_session', 'undo_flow_edit', 'trash_flow_session',
-  'run_flow_session', 'cancel_flow_run', 'retry_flow_run',
-  'run_trend', 'cancel_trend_run',
+const DESTRUCTIVE_WRITE = [
+  'update_flow_session', 'undo_flow_edit', 'trash_flow_session',
+  'run_flow_session', 'cancel_flow_run', 'retry_flow_run',
+  'run_trend', 'cancel_trend_run',
   'cancel_download',
-  'extend_music', 'cover_music',
-  'update_video_editor_session',
-  'delete_font',
+  'extend_music', 'cover_music',
+  'update_video_editor_session',
+  'delete_font',
   'export_video_editor_session',
   // These actions spend credits, enqueue irreversible work, or cancel it.
   'generate_image', 'generate_image_edit', 'generate_creative_director',
@@ -103,8 +103,8 @@ const DESTRUCTIVE_WRITE = [
   'chat_send_message', 'generate_character_sheet',
   'acquire_clean_music_track', 'import_music_track_to_library',
   'separate_audio_stems', 'clean_dialogue_leftovers', 'separate_ambience',
-  'analyze_video',
-  'analyze_video_evidence', 'transcribe_video_evidence', 'cancel_video_inspection',
+  'analyze_video',
+  'analyze_video_evidence', 'transcribe_video_evidence', 'cancel_video_inspection',
 
   // Deletes and whole-value replacement updates are conservatively destructive.
   'delete_voice', 'update_visual_dna', 'delete_visual_dna', 'delete_visual_dna_folder',
@@ -125,10 +125,12 @@ const DESTRUCTIVE_WRITE = [
   'edit_review_comment', 'delete_review_comment',
 ];
 
-const OPEN_WORLD_WRITE = [
+const OPEN_WORLD_WRITE = [
   'download_media_from_url',
-  'import_music_audio',
+  'import_music_audio',
   'publish_html_artifact', 'create_review_share_link', 'blender_capture_viewport',
+  // Public showcase link for a project / catalog submission.
+  'publish_project', 'submit_project_to_catalog',
   // Adobe edits add bins, clips, sequences or caption tracks; none delete or overwrite.
   'adobe_import_media', 'adobe_place_on_timeline', 'adobe_create_sequence', 'adobe_import_captions',
   'adobe_capture_frame',
@@ -137,7 +139,7 @@ const OPEN_WORLD_WRITE = [
 ];
 
 const OPEN_WORLD_DESTRUCTIVE = [
-  'share_doc', 'revoke_review_share_link',
+  'share_doc', 'revoke_review_share_link', 'unpublish_project',
   'blender_apply_operations', 'blender_import_media', 'blender_render',
   'blender_undo', 'blender_file_operation', 'blender_execute_python',
   // Can delete layers; approved once per batch in the Kolbo panel.

package/src/tools/projects.js

@@ -315,6 +315,61 @@ function registerProjectTools(server, client) {
     }
   );
 
+  // ─── publish a project (public showcase link) ──────────────
+  const pubText = (r, hint) => ({ content: [{ type: 'text', text: JSON.stringify({ ...r, success: undefined, ...(hint ? { _hint: hint } : {}) }, null, 2) }] });
+
+  server.tool(
+    'publish_project',
+    'PUBLISH one of YOUR OWN projects as a public showcase page with a shareable link (the same as the app\'s Publish tab) and return the public `url`. Safe to call again: it never changes the URL, it only updates what you pass. In one call you can also set `allow_fork` (let viewers copy the project into their account), the public write-up `showcase_about`, and the project\'s FINAL VIDEO as the page hero. HERO VIDEO: the video must already be in THIS project — a generated video made with `project_id`, or a file you put there with `upload_media` (pass `project_id`; a local file is uploaded from disk). Then pass its media id as `hero_video_media_id` (or its Kolbo URL as `hero_video_url`). Anyone with the link can see the project\'s media, so ALWAYS confirm with the user before publishing, and consider `duplicate_project` first to publish a clean copy. Undo with `unpublish_project`.',
+    {
+      project_id: z.string().describe('ObjectId of a project you OWN (from list_projects).'),
+      allow_fork: z.boolean().optional().describe('Let viewers copy the project into their own account. Default true on first publish; omit to keep the current setting.'),
+      showcase_about: z.string().optional().describe('Public "About" write-up shown on the page (max 10000 chars, plain text). Omit on first publish and Kolbo drafts one for you; pass "" to clear.'),
+      hero_video_media_id: z.string().optional().describe('Media id (from upload_media / list_media) of a VIDEO already in this project, shown as the full-bleed hero of the public page.'),
+      hero_video_url: z.string().optional().describe('Alternative to hero_video_media_id: the Kolbo CDN URL of a video already in this project.')
+    },
+    async ({ project_id, allow_fork, showcase_about, hero_video_media_id, hero_video_url }) => {
+      const body = {};
+      if (allow_fork !== undefined) body.allow_fork = allow_fork;
+      if (showcase_about !== undefined) body.showcase_about = showcase_about;
+      if (hero_video_media_id) body.hero_video_media_id = hero_video_media_id;
+      if (hero_video_url) body.hero_video_url = hero_video_url;
+      const result = await client.post(`/v1/projects/${encodeURIComponent(project_id)}/publish`, body);
+      return pubText(result, 'Share `url` with the user — it is live now. To list it in the public catalog call `submit_project_to_catalog` (review is manual).');
+    }
+  );
+
+  server.tool(
+    'get_project_publication',
+    'Check whether a project is published and read its public `url`, allow_fork, showcase_about, hero video, catalog listing status (none / pending / approved / rejected) and fork count. Returns `{ published: false }` when it is not published.',
+    { project_id: z.string().describe('ObjectId of a project you OWN.') },
+    async ({ project_id }) => pubText(await client.get(`/v1/projects/${encodeURIComponent(project_id)}/publish`))
+  );
+
+  server.tool(
+    'unpublish_project',
+    'Take a published project OFFLINE: the public link stops working immediately. Copies other people already made stay theirs. Re-publishing with `publish_project` creates a new link. Confirm with the user first.',
+    { project_id: z.string().describe('ObjectId of a project you OWN.') },
+    async ({ project_id }) => pubText(await client.delete(`/v1/projects/${encodeURIComponent(project_id)}/publish`))
+  );
+
+  server.tool(
+    'submit_project_to_catalog',
+    'Submit a PUBLISHED project to Kolbo\'s public catalog (status becomes `pending`; a Kolbo admin approves it — you cannot approve your own). Pass `submit: false` to withdraw. Fails with NOT_PUBLISHED if `publish_project` has not been called.',
+    {
+      project_id: z.string().describe('ObjectId of a project you OWN.'),
+      submit: z.boolean().optional().describe('true (default) = submit for review, false = withdraw.')
+    },
+    async ({ project_id, submit }) => pubText(await client.post(`/v1/projects/${encodeURIComponent(project_id)}/publish/listing`, { submit: submit !== false }))
+  );
+
+  server.tool(
+    'remove_project_hero_video',
+    'Clear the hero video of a published project (the page falls back to a mosaic of the project\'s stills). The video file itself stays in the project\'s media.',
+    { project_id: z.string().describe('ObjectId of a project you OWN.') },
+    async ({ project_id }) => pubText(await client.delete(`/v1/projects/${encodeURIComponent(project_id)}/publish/hero-video`))
+  );
+
   // ─── project transfer (hand a project to another account) ──
   server.tool(
     'transfer_project',