@atray/mcp 1.0.2 → 1.0.4

package/README.md

@@ -59,6 +59,8 @@ Restart the client and the ATRAY tools become available.
 | `listPosts` / `createPost` / `getPost` / `updatePost` | Manage posts (text and carousel). |
 | `regeneratePostText` / `regeneratePostImage` | Regenerate caption or image with AI. |
 | `uploadPostVideo` | Upload a video (mp4/mov/webm, up to 120 MB) as the post media; published to Instagram as a Reel. |
+| `listSocialConnections` | List your connected social accounts (read-only) to pick a publish target. |
+| `schedulePost` | Schedule/publish a post (omit `scheduled_at` to publish as soon as possible). |
 
 Each AI-generated post consumes 1 content credit from your plan. Creating a campaign
 requires a completed brand profile.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atray/mcp",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "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.2' },
+  { name: 'atray-mcp', version: '1.0.4' },
   { capabilities: { tools: {} } }
 );
 
@@ -83,6 +83,16 @@ async function callTool(name, a) {
     case 'uploadPostVideo':
       return uploadPostVideo(a);
 
+    // ─── SOCIAL CONNECTIONS (read-only) ───────────────────────────────────────
+    case 'listSocialConnections':
+      return api.get('/social-connections');
+
+    // ─── PUBLISH / SCHEDULE ───────────────────────────────────────────────────
+    case 'schedulePost': {
+      const { id, ...body } = a;
+      return api.post(`/posts/${id}/schedule`, body);
+    }
+
     default:
       throw new Error(`Unknown tool: ${name}`);
   }

package/src/tools.js

@@ -152,6 +152,7 @@ export const tools = [
       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 #)' },
@@ -190,6 +191,7 @@ export const tools = [
         image_description:  { type: 'string', description: 'Image description for single-image posts' },
         image_descriptions: { type: 'array', items: { type: 'string' }, description: 'Image descriptions per slide for carousel posts (3-6 items)' },
         context:            { type: 'string', description: 'Context/brief for AI text generation' },
+        placement:          { type: 'string', enum: ['feed', 'story'], description: 'Publish destination: feed or story (Instagram Story). Carousel posts are always feed.' },
         status:             { type: 'string', enum: ['draft', 'scheduled', 'published'] },
         scheduled_at:       { type: 'string', description: 'Publish datetime (ISO-8601, must be in the future)' },
         image_text_enabled: { type: 'boolean' },
@@ -237,4 +239,31 @@ export const tools = [
       },
     },
   },
+
+  // ─── SOCIAL CONNECTIONS (read-only) ─────────────────────────────────────────
+
+  {
+    name: 'listSocialConnections',
+    description: "Lists the user's connected social accounts (Instagram, etc.) with id, platform, username and status. Use the connection id as social_connection_id when scheduling a standalone post. Read-only: connecting and managing accounts is done in the Studio.",
+    inputSchema: {
+      type: 'object',
+      properties: {},
+    },
+  },
+
+  // ─── PUBLISH / SCHEDULE ─────────────────────────────────────────────────────
+
+  {
+    name: 'schedulePost',
+    description: 'Schedules a post for publishing: marks it as scheduled and creates the delivery job (the worker publishes at scheduled_at). Omit scheduled_at to publish as soon as possible. For standalone posts (no campaign) you MUST pass social_connection_id (get it from listSocialConnections). Campaign posts publish to the campaign accounts.',
+    inputSchema: {
+      type: 'object',
+      required: ['id'],
+      properties: {
+        id:                   { type: 'string', description: 'Post UUID' },
+        scheduled_at:         { type: 'string', description: 'Publish datetime (ISO-8601). Omit to publish as soon as possible.' },
+        social_connection_id: { type: 'string', description: 'Target account UUID (from listSocialConnections). Required for standalone posts.' },
+      },
+    },
+  },
 ];