@atray/mcp 1.0.5 → 1.0.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atray/mcp",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "MCP server for ATRAY API - manage campaigns, posts and brand profile via AI",
   "type": "module",
   "bin": {

package/src/index.js

@@ -10,7 +10,7 @@ import { tools } from './tools.js';
 import { api } from './api.js';
 
 const server = new Server(
-  { name: 'atray-mcp', version: '1.0.5' },
+  { name: 'atray-mcp', version: '1.0.7' },
   { capabilities: { tools: {} } }
 );
 
@@ -103,7 +103,7 @@ async function callTool(name, a) {
 
 const IMAGE_MIME = { jpg: 'image/jpeg', jpeg: 'image/jpeg', png: 'image/png', webp: 'image/webp' };
 
-async function uploadPostImage({ id, file_path, image_url }) {
+async function uploadPostImage({ id, file_path, image_url, slot_index }) {
   if (!id) throw new Error('id (post UUID) is required');
   if (!file_path && !image_url) throw new Error('Provide file_path (local file) or image_url (public URL)');
 
@@ -129,7 +129,9 @@ async function uploadPostImage({ id, file_path, image_url }) {
 
   const base64 = buffer.toString('base64');
   const ext = m[1] === 'jpg' ? 'jpeg' : m[1];
-  return api.post(`/posts/${id}/image`, { image: `data:image/${ext};base64,${base64}`, filename });
+  const body = { image: `data:image/${ext};base64,${base64}`, filename };
+  if (slot_index != null) body.slot_index = Number(slot_index);
+  return api.post(`/posts/${id}/image`, body);
 }
 
 const VIDEO_MIME = { mp4: 'video/mp4', mov: 'video/quicktime', webm: 'video/webm' };

package/src/tools.js

@@ -146,21 +146,22 @@ export const tools = [
 
   {
     name: 'createPost',
-    description: 'Creates a standalone post draft. Use type="carousel" with image_descriptions[] (3-6 items) for a carousel post. Default type="text" uses image_description for a single image.',
+    description: 'Creates a standalone post draft. Use type="carousel" with image_descriptions[] (3-6 items) for a carousel post. Default type="text" uses image_description for a single image. Set skip_image_generation=true when you plan to upload your own image with uploadPostImage right after — prevents the AI from generating and overwriting your upload.',
     inputSchema: {
       type: 'object',
       properties: {
-        campaign_id:        { type: 'string', description: 'Campaign UUID to link to (optional)' },
-        type:               { type: 'string', enum: ['text', 'carousel'], description: 'Post type (default: text)' },
-        placement:          { type: 'string', enum: ['feed', 'story'], description: 'Publish destination (default: feed). "story" publishes as an Instagram Story (single media only; not for carousel).' },
-        caption_text:       { type: 'string', description: 'Post caption text' },
-        cta:                { type: 'string', description: 'Call-to-action text (e.g. "Link in bio")' },
-        hashtags:           { type: 'array', items: { type: 'string' }, description: 'Hashtags (without #)' },
-        image_description:  { type: 'string', description: 'Image description for single-image posts (type=text)' },
-        image_descriptions: { type: 'array', items: { type: 'string' }, description: 'Image description per slide for carousel posts (type=carousel, 3-6 items)' },
-        context:            { type: 'string', description: 'Context/brief for AI text generation (required for standalone posts)' },
-        image_text_enabled: { type: 'boolean', description: 'Include text overlay in generated image (default: true)' },
-        image_logo_enabled: { type: 'boolean', description: 'Include brand logo in generated image (default: true)' },
+        campaign_id:            { type: 'string', description: 'Campaign UUID to link to (optional)' },
+        type:                   { type: 'string', enum: ['text', 'carousel'], description: 'Post type (default: text)' },
+        placement:              { type: 'string', enum: ['feed', 'story'], description: 'Publish destination (default: feed). "story" publishes as an Instagram Story (single media only; not for carousel).' },
+        caption_text:           { type: 'string', description: 'Post caption text' },
+        cta:                    { type: 'string', description: 'Call-to-action text (e.g. "Link in bio")' },
+        hashtags:               { type: 'array', items: { type: 'string' }, description: 'Hashtags (without #)' },
+        image_description:      { type: 'string', description: 'Image description for single-image posts (type=text)' },
+        image_descriptions:     { type: 'array', items: { type: 'string' }, description: 'Image description per slide for carousel posts (type=carousel, 3-6 items)' },
+        context:                { type: 'string', description: 'Context/brief for AI text generation (required for standalone posts)' },
+        image_text_enabled:     { type: 'boolean', description: 'Include text overlay in generated image (default: true)' },
+        image_logo_enabled:     { type: 'boolean', description: 'Include brand logo in generated image (default: true)' },
+        skip_image_generation:  { type: 'boolean', description: 'Set to true to skip AI image generation. Use when you will upload your own image with uploadPostImage after creating the post.' },
       },
     },
   },
@@ -228,14 +229,15 @@ export const tools = [
 
   {
     name: 'uploadPostImage',
-    description: 'Uploads a custom image (jpg, jpeg, png or webp) as the post media, replacing the current AI-generated image. Provide either file_path (local file) or image_url (public URL to download from).',
+    description: 'Uploads a custom image (jpg, jpeg, png or webp) as the post media, replacing the current AI-generated image. Provide either file_path (local file) or image_url (public URL to download from). For carousel posts, use slot_index (0-based) to target a specific slide; omit to replace slide 0.',
     inputSchema: {
       type: 'object',
       required: ['id'],
       properties: {
-        id:        { type: 'string', description: 'Post UUID' },
-        file_path: { type: 'string', description: 'Absolute path to a local image file (jpg, jpeg, png, webp)' },
-        image_url: { type: 'string', description: 'Public URL of the image to download and upload' },
+        id:         { type: 'string', description: 'Post UUID' },
+        file_path:  { type: 'string', description: 'Absolute path to a local image file (jpg, jpeg, png, webp)' },
+        image_url:  { type: 'string', description: 'Public URL of the image to download and upload' },
+        slot_index: { type: 'number', description: 'Carousel slide index (0-based). Required to fill slides beyond the first one.' },
       },
     },
   },