@kolbo/mcp 1.102.0 → 1.103.0

package/package.json

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

package/src/tools/color_palettes.js

@@ -5,6 +5,7 @@
 
 const { z } = require('zod');
 const { UI, uiResult, appsEnabled } = require('../apps');
+const { projectScopeReadField } = require('./_shared');
 
 /** SVG strip of the palette's colors as a data URI — every palette gets a real
  *  thumbnail in the media-grid widget even when it has no source images. */
@@ -25,9 +26,10 @@ function registerColorPaletteTools(server, client, options = {}) {
   server.tool(
     'list_color_palettes',
     'List the user\'s Color DNA palettes (personal + org). Each has a name, 1-10 colors, and an is_active flag — at most one palette is active per account at a time, and the active one auto-applies to every generation.',
-    {},
-    async () => {
-      const result = await client.get('/v1/color-palettes');
+    { project_id: projectScopeReadField },
+    async ({ project_id } = {}) => {
+      const suffix = project_id ? `?project_id=${encodeURIComponent(project_id)}` : '';
+      const result = await client.get(`/v1/color-palettes${suffix}`);
       const palettes = result.color_palettes || [];
       const text = JSON.stringify({ color_palettes: palettes, pagination: result.pagination }, null, 2);
 
@@ -82,10 +84,11 @@ function registerColorPaletteTools(server, client, options = {}) {
         role: z.enum(['dominant', 'secondary', 'accent', 'background']).optional().describe('Role of this color in the palette. Default: "accent".')
       })).min(1).max(10).describe('1-10 colors.'),
       source_image_urls: z.array(z.string()).max(5).optional().describe('Optional reference image URLs this palette was derived from.'),
-      is_active: z.boolean().optional().describe('Activate immediately on save. Default: true (saving auto-activates and unsets any other active palette).')
+      is_active: z.boolean().optional().describe('Activate immediately on save. Default: true (saving auto-activates and unsets any other active palette).'),
+      project_id: z.string().optional().describe('Save the palette inside this project so teammates with edit access see it in list_color_palettes (with the same project_id). Requires edit access; ignored otherwise.')
     },
-    async ({ name, colors, source_image_urls, is_active }) => {
-      const result = await client.post('/v1/color-palettes', { name, colors, source_image_urls, is_active });
+    async ({ name, colors, source_image_urls, is_active, project_id }) => {
+      const result = await client.post('/v1/color-palettes', { name, colors, source_image_urls, is_active, ...(project_id ? { project_id } : {}) });
       return { content: [{ type: 'text', text: JSON.stringify({ color_palette: result.color_palette }, null, 2) }] };
     }
   );
@@ -125,9 +128,12 @@ function registerColorPaletteTools(server, client, options = {}) {
   server.tool(
     'activate_color_palette',
     `Make this the account's sticky active Color DNA palette (unsets any other active palette first). ${STICKY_NOTE}`,
-    { color_palette_id: z.string().describe('Palette id to activate.') },
-    async ({ color_palette_id }) => {
-      const result = await client.post(`/v1/color-palettes/${encodeURIComponent(color_palette_id)}/activate`, {});
+    {
+      color_palette_id: z.string().describe('Palette id to activate.'),
+      project_id: z.string().optional().describe('Shared project the palette belongs to — needed to activate a teammate palette from that project (edit access required).')
+    },
+    async ({ color_palette_id, project_id }) => {
+      const result = await client.post(`/v1/color-palettes/${encodeURIComponent(color_palette_id)}/activate`, project_id ? { project_id } : {});
       return { content: [{ type: 'text', text: JSON.stringify({ color_palette: result.color_palette }, null, 2) }] };
     }
   );

package/src/tools/generate.js

@@ -1391,6 +1391,9 @@ function registerGenerateTools(server, client, options = {}) {
             type: single.type,
           },
           state: single.state,
+          // The failure reason. The SDK always sends it, but this card dropped it, so a
+          // failed generation surfaced as a bare "failed" with no way to act on it.
+          error: single.state === 'failed' ? single.error : undefined,
           urls: done ? urls : undefined,
           thumbnail_url: res.thumbnail_url,
           // Transcription results ride the same status tool as media
@@ -1419,6 +1422,7 @@ function registerGenerateTools(server, client, options = {}) {
           items: [{
             id: single.generation_id,
             state: single.state,
+            error: single.state === 'failed' ? single.error : undefined,
             title: res.prompt_used || res.prompt || undefined,
             url: Array.isArray(res.urls) ? res.urls[0] : undefined,
           }],
@@ -1487,6 +1491,7 @@ function registerGenerateTools(server, client, options = {}) {
           return {
             id: r.generation_id,
             state: r.state,
+            error: r.state === 'failed' ? r.error : undefined,
             title: res.prompt_used || res.prompt || undefined,
             url: Array.isArray(res.urls) ? res.urls[0] : undefined,
             // A live batch card reads these from structuredContent (its only

package/src/tools/moodboards.js

@@ -59,10 +59,12 @@ function registerMoodboardTools(server, client, options = {}) {
     'get_moodboard',
     'Fetch a single moodboard by ID. Returns the full moodboard including master_prompt, style_guide, and all image URLs.',
     {
-      moodboard_id: z.string().describe('The moodboard ID')
+      moodboard_id: z.string().describe('The moodboard ID'),
+      project_id: projectScopeReadField
     },
-    async ({ moodboard_id }) => {
-      const result = await client.get(`/v1/moodboards/${encodeURIComponent(moodboard_id)}`);
+    async ({ moodboard_id, project_id }) => {
+      const suffix = project_id ? `?project_id=${encodeURIComponent(project_id)}` : '';
+      const result = await client.get(`/v1/moodboards/${encodeURIComponent(moodboard_id)}${suffix}`);
       return {
         content: [{
           type: 'text',
@@ -79,13 +81,15 @@ function registerMoodboardTools(server, client, options = {}) {
     {
       name: z.string().describe('Moodboard name (1–100 chars).'),
       image_urls: z.array(z.string()).min(1).max(15).describe('1–15 public image URLs. For local files, get URLs first via the LOCAL FILE route in this tool\'s description.'),
-      style_guide: z.string().optional().describe('Optional style notes (max 500 chars) that steer the analysis, e.g. "focus on the color grading, not the subjects".')
+      style_guide: z.string().optional().describe('Optional style notes (max 500 chars) that steer the analysis, e.g. "focus on the color grading, not the subjects".'),
+      project_id: z.string().optional().describe('Create the moodboard inside this project so every teammate with edit access can list, fetch and use it as #Name (pass the same project_id to list_moodboards / get_moodboard). Requires edit access; otherwise it is created private.')
     },
-    async ({ name, image_urls, style_guide }) => {
+    async ({ name, image_urls, style_guide, project_id }) => {
       const body = {
         name,
         images: image_urls.map(u => ({ type: 'url', url: u })),
-        ...(style_guide ? { style_guide } : {})
+        ...(style_guide ? { style_guide } : {}),
+        ...(project_id ? { project_id } : {})
       };
       const result = await client.post('/v1/moodboards', body);
       return { content: [{ type: 'text', text: JSON.stringify({ moodboard: result.moodboard, _hint: 'Pass this id as moodboard_id on generate_image / generate_creative_director to apply the style.' }, null, 2) }] };

package/src/tools/visual_dna.js

@@ -37,9 +37,10 @@ function registerVisualDnaTools(server, client, options = {}) {
       audio: z.string().optional().describe('Optional audio source (URL or absolute local path) — the character\'s voice, 5-30s of clean speech. Stored on the DNA and used two ways: (1) as REFERENCE AUDIO in video generation — attaching this DNA to an image-to-video generation on a model with audio slots (Seedance 2.x, Wan 3.0) auto-attaches the clip and tells the model it is that character\'s voice; (2) as the source for a real speaking voice, but ONLY when you ask for one — see `voice_source`.'),
       voice_source: z.enum(['none', 'clone', 'assign', 'design']).optional().describe('What to do about a SPEAKING voice. **Pass "none" when the audio is just a reference clip** (the usual case for video work) — the clip is stored and usable as video reference audio, and nothing else happens. "clone" mints an ElevenLabs voice from the uploaded audio, which consumes a voice slot and may EVICT another of the user\'s voices to free one; it also makes the DNA addressable as `dna_<id>` in text-to-speech. "assign" points at an existing voice (pass `assigned_voice_id`). "design" generates a voice from the character\'s look. ⚠️ Omitting this while passing `audio` keeps the legacy behaviour and CLONES — pass "none" explicitly unless the user asked for a voice.'),
       assigned_voice_id: z.string().optional().describe('Voice to attach when voice_source="assign" — a `custom_<id>` from the user\'s clones or a voice_id from `list_voices`.'),
-      character_sheet_url: z.string().optional().describe('URL of a reference sheet (from `generate_character_sheet`, any sheet_type) to set as the DNA\'s primary reference. Works for ALL DNA types — character turnaround, product detail sheet, location sheet, or style board — and is the single biggest consistency booster. Omit only when the user declines.')
+      character_sheet_url: z.string().optional().describe('URL of a reference sheet (from `generate_character_sheet`, any sheet_type) to set as the DNA\'s primary reference. Works for ALL DNA types — character turnaround, product detail sheet, location sheet, or style board — and is the single biggest consistency booster. Omit only when the user declines.'),
+      project_id: z.string().optional().describe('Create the DNA inside this project so every teammate with edit access to it can list, fetch and generate with it (pass the same project_id to list_visual_dnas / get_visual_dna / generations). Requires edit access to the project. Omit for a private DNA.')
     },
-    async ({ name, dna_type, prompt_helper, description, images, video, audio, voice_source, assigned_voice_id, character_sheet_url }) => {
+    async ({ name, dna_type, prompt_helper, description, images, video, audio, voice_source, assigned_voice_id, character_sheet_url, project_id }) => {
       const helper = prompt_helper !== undefined ? prompt_helper : description;
       if (!name || !name.trim()) {
         throw new Error('name is required');
@@ -71,6 +72,7 @@ function registerVisualDnaTools(server, client, options = {}) {
       // long-standing behaviour older installs depend on. Only an explicit choice is forwarded.
       if (voice_source) form.append('voiceSource', voice_source);
       if (assigned_voice_id) form.append('assignedVoiceId', assigned_voice_id);
+      if (project_id) form.append('project_id', project_id);
 
       for (const f of imageFiles) {
         form.append('images', f.buffer, { filename: f.filename, contentType: f.contentType });