@kolbo/mcp 1.47.0 → 1.48.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kolbo/mcp",
-  "version": "1.47.0",
+  "version": "1.48.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/_shared.js

@@ -254,6 +254,14 @@ const projectIdField = z.string().optional().describe(
   'Project ObjectId to drop this generation into. Call `list_projects` to discover IDs (the API has no concept of project names — only ObjectIds). IMPORTANT: this is per-call, NOT sticky — once the user has named a working project, pass its id on EVERY generation call in the conversation; any call that omits it silently lands in the default "API Generations" project instead. Requires owner / edit / full permission on the project; view-only is rejected.'
 );
 
+// Read-scope variant for list/get tools that can surface a SHARED project's
+// assets (a teammate's Visual DNAs / moodboards). Pass a project id you have
+// edit+ on to also see that project owner's shared assets; omit to see only your
+// own + global/org. View-only members and non-members get nothing extra.
+const projectScopeReadField = z.string().optional().describe(
+  "Project ObjectId (from `list_projects`) to ALSO surface that shared project's assets (a teammate's, when the project is shared with you). Requires edit / full / owner on the project — view-only members and non-members get only their own. Omit to see just your own + global/org."
+);
+
 // ─── Optional inline-image content blocks ────────────────────────────────────
 // When a host opts in (the remote HTTP connector sets inlineImages:true), turn
 // generated IMAGE urls into MCP `image` content blocks so clients render them
@@ -440,6 +448,7 @@ module.exports = {
   resolveToBuffer,
   creditFields,
   projectIdField,
+  projectScopeReadField,
   inlineImageBlocks,
   buildOpenUrl,
   uiGenerating,

package/src/tools/moodboards.js

@@ -5,6 +5,7 @@
 
 const { z } = require('zod');
 const { UI, uiResult, appsEnabled } = require('../apps');
+const { projectScopeReadField } = require('./_shared');
 
 function registerMoodboardTools(server, client, options = {}) {
   const ui = () => appsEnabled(server, options);
@@ -13,11 +14,13 @@ function registerMoodboardTools(server, client, options = {}) {
     'list_moodboards',
     'List moodboards. By default returns ALL (personal + system presets + organization). Use "scope" to filter: "personal" (user\'s own), "preset" or "global" (system presets), or "organization" (org-shared). Returns id, name, master_prompt, thumbnail, and image URLs for each.',
     {
-      scope: z.enum(['all', 'personal', 'preset', 'global', 'organization']).optional().describe('Filter by scope. Default: "all" (everything accessible). "personal" = only your own. "preset"/"global" = system presets. "organization" = org-shared.')
+      scope: z.enum(['all', 'personal', 'preset', 'global', 'organization']).optional().describe('Filter by scope. Default: "all" (everything accessible). "personal" = only your own. "preset"/"global" = system presets. "organization" = org-shared.'),
+      project_id: projectScopeReadField
     },
-    async ({ scope } = {}) => {
+    async ({ scope, project_id } = {}) => {
       const params = new URLSearchParams();
       if (scope && scope !== 'all') params.set('scope', scope);
+      if (project_id) params.set('project_id', project_id);
       const qs = params.toString();
       const result = await client.get(`/v1/moodboards${qs ? '?' + qs : ''}`);
       const moodboards = result.moodboards || [];

package/src/tools/visual_dna.js

@@ -5,7 +5,7 @@
 
 const { z } = require('zod');
 const FormData = require('form-data');
-const { resolveToBuffer: sharedResolveToBuffer, VISUAL_DNA_MAX_BYTES } = require('./_shared');
+const { resolveToBuffer: sharedResolveToBuffer, VISUAL_DNA_MAX_BYTES, projectScopeReadField } = require('./_shared');
 const { UI, uiResult, appsEnabled } = require('../apps');
 
 // Visual DNA caps reference media at 25MB per file (stricter than the
@@ -85,14 +85,16 @@ function registerVisualDnaTools(server, client, options = {}) {
       scope: z.enum(['all', 'personal', 'global', 'organization']).optional().describe('Filter by scope. Default: "all" (everything accessible). "personal" = only your own. "global" = system presets/cast. "organization" = org-shared.'),
       search: z.string().optional().describe('Search by name, tags, or description (case-insensitive)'),
       collection: z.string().optional().describe('Filter global presets by collection: cast, influencers, props, locations, styles, glamour, street'),
-      tags: z.string().optional().describe('Comma-separated tags to filter by (OR logic)')
+      tags: z.string().optional().describe('Comma-separated tags to filter by (OR logic)'),
+      project_id: projectScopeReadField
     },
-    async ({ scope, search, collection, tags } = {}) => {
+    async ({ scope, search, collection, tags, project_id } = {}) => {
       const params = new URLSearchParams();
       if (scope && scope !== 'all') params.set('scope', scope);
       if (search) params.set('search', search);
       if (collection) params.set('collection', collection);
       if (tags) params.set('tags', tags);
+      if (project_id) params.set('project_id', project_id);
       const qs = params.toString();
       const result = await client.get(`/v1/visual-dna${qs ? '?' + qs : ''}`);
       const dnas = result.visual_dnas || [];
@@ -125,12 +127,14 @@ function registerVisualDnaTools(server, client, options = {}) {
   // ─── get_visual_dna ────────────────────────────────────────
   server.tool(
     'get_visual_dna',
-    'Fetch a single Visual DNA profile by ID. Returns the full profile including system_prompt and all reference images.',
+    'Fetch a single Visual DNA profile by ID. Returns the full profile including system_prompt and all reference images. To fetch a teammate\'s Visual DNA that lives in a shared project, pass project_id (you need edit+ on it).',
     {
-      visual_dna_id: z.string().describe('The Visual DNA profile ID')
+      visual_dna_id: z.string().describe('The Visual DNA profile ID'),
+      project_id: projectScopeReadField
     },
-    async ({ visual_dna_id }) => {
-      const result = await client.get(`/v1/visual-dna/${encodeURIComponent(visual_dna_id)}`);
+    async ({ visual_dna_id, project_id }) => {
+      const suffix = project_id ? `?project_id=${encodeURIComponent(project_id)}` : '';
+      const result = await client.get(`/v1/visual-dna/${encodeURIComponent(visual_dna_id)}` + suffix);
       return {
         content: [{
           type: 'text',