posterly-mcp-server 0.1.1 → 0.2.1

package/dist/lib/api-client.d.ts

@@ -54,6 +54,12 @@ export declare class PosterlyClient {
         timezone?: string;
         count?: number;
     }): Promise<Slot[]>;
+    getSignedUploadUrl(filename: string, contentType: string, size: number): Promise<{
+        upload_url: string;
+        token: string;
+        path: string;
+        public_url: string;
+    }>;
     uploadMedia(input: {
         filePath?: string;
         base64Data?: string;

package/dist/lib/api-client.js

@@ -62,20 +62,45 @@ export class PosterlyClient {
         const data = await this.request('GET', `/slots/next${qs ? `?${qs}` : ''}`);
         return data.slots;
     }
+    async getSignedUploadUrl(filename, contentType, size) {
+        return this.request('POST', '/media/signed-upload', {
+            filename,
+            content_type: contentType,
+            size,
+        });
+    }
     async uploadMedia(input) {
-        let data;
+        let fileBuffer;
         if (input.filePath) {
-            const buffer = await readFile(resolve(input.filePath));
-            data = buffer.toString('base64');
+            fileBuffer = await readFile(resolve(input.filePath));
         }
         else if (input.base64Data) {
-            data = input.base64Data;
+            fileBuffer = Buffer.from(input.base64Data, 'base64');
         }
         else {
             throw new Error('Provide filePath or base64Data');
         }
         const contentType = input.contentType ||
             guessContentType(input.filename);
+        const SIZE_THRESHOLD = 3 * 1024 * 1024; // 3MB
+        if (fileBuffer.length > SIZE_THRESHOLD) {
+            // Large file: use signed URL to upload directly to Supabase Storage
+            const signed = await this.getSignedUploadUrl(input.filename, contentType, fileBuffer.length);
+            const uploadRes = await fetch(signed.upload_url, {
+                method: 'PUT',
+                headers: {
+                    'Content-Type': contentType,
+                },
+                body: new Uint8Array(fileBuffer),
+            });
+            if (!uploadRes.ok) {
+                const errText = await uploadRes.text().catch(() => uploadRes.statusText);
+                throw new Error(`Direct upload failed: ${errText}`);
+            }
+            return { url: signed.public_url, path: signed.path };
+        }
+        // Small file: use existing base64 flow through Vercel
+        const data = fileBuffer.toString('base64');
         return this.request('POST', '/media/upload', {
             filename: input.filename,
             data,

package/dist/tools/upload-media.js

@@ -1,16 +1,16 @@
 import { z } from 'zod';
 export const uploadMediaTool = {
     name: 'upload_media',
-    description: 'Upload an image or video file to posterly. Returns a URL that can be used with create_post. Supports JPEG, PNG, GIF, WebP, MP4, MOV, WebM. Max 5MB.',
+    description: 'Upload an image or video file to posterly. Returns a URL that can be used with create_post. Supports JPEG, PNG, GIF, WebP, MP4, MOV, WebM. Images up to 10MB, videos up to 50MB. IMPORTANT: If the user shares an image in the chat, use base64_data (not file_path) since chat-uploaded images are not on the local filesystem. Only use file_path when the user provides an actual local filesystem path.',
     inputSchema: z.object({
         file_path: z
             .string()
             .optional()
-            .describe('Absolute path to a local file to upload'),
+            .describe('Absolute local filesystem path (e.g. /Users/name/photo.jpg). Only use when the user gives you an explicit path. Do NOT guess paths for images uploaded in chat.'),
         base64_data: z
             .string()
             .optional()
-            .describe('Base64-encoded file data (alternative to file_path)'),
+            .describe('Base64-encoded file data. PREFERRED for images shared directly in chat — extract the image data as base64 and pass it here.'),
         filename: z
             .string()
             .describe('Filename with extension (e.g. photo.jpg, video.mp4)'),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "posterly-mcp-server",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "description": "MCP server for posterly — schedule social media posts from Claude Desktop",
   "license": "MIT",
   "type": "module",

package/src/lib/api-client.ts

@@ -119,19 +119,30 @@ export class PosterlyClient {
     return data.slots;
   }
 
+  async getSignedUploadUrl(
+    filename: string,
+    contentType: string,
+    size: number,
+  ): Promise<{ upload_url: string; token: string; path: string; public_url: string }> {
+    return this.request('POST', '/media/signed-upload', {
+      filename,
+      content_type: contentType,
+      size,
+    });
+  }
+
   async uploadMedia(input: {
     filePath?: string;
     base64Data?: string;
     filename: string;
     contentType?: string;
   }): Promise<{ url: string; path: string }> {
-    let data: string;
+    let fileBuffer: Buffer;
 
     if (input.filePath) {
-      const buffer = await readFile(resolve(input.filePath));
-      data = buffer.toString('base64');
+      fileBuffer = await readFile(resolve(input.filePath));
     } else if (input.base64Data) {
-      data = input.base64Data;
+      fileBuffer = Buffer.from(input.base64Data, 'base64');
     } else {
       throw new Error('Provide filePath or base64Data');
     }
@@ -140,6 +151,35 @@ export class PosterlyClient {
       input.contentType ||
       guessContentType(input.filename);
 
+    const SIZE_THRESHOLD = 3 * 1024 * 1024; // 3MB
+
+    if (fileBuffer.length > SIZE_THRESHOLD) {
+      // Large file: use signed URL to upload directly to Supabase Storage
+      const signed = await this.getSignedUploadUrl(
+        input.filename,
+        contentType,
+        fileBuffer.length,
+      );
+
+      const uploadRes = await fetch(signed.upload_url, {
+        method: 'PUT',
+        headers: {
+          'Content-Type': contentType,
+        },
+        body: new Uint8Array(fileBuffer),
+      });
+
+      if (!uploadRes.ok) {
+        const errText = await uploadRes.text().catch(() => uploadRes.statusText);
+        throw new Error(`Direct upload failed: ${errText}`);
+      }
+
+      return { url: signed.public_url, path: signed.path };
+    }
+
+    // Small file: use existing base64 flow through Vercel
+    const data = fileBuffer.toString('base64');
+
     return this.request('POST', '/media/upload', {
       filename: input.filename,
       data,

package/src/tools/upload-media.ts

@@ -4,16 +4,16 @@ import type { PosterlyClient } from '../lib/api-client.js';
 export const uploadMediaTool = {
   name: 'upload_media',
   description:
-    'Upload an image or video file to posterly. Returns a URL that can be used with create_post. Supports JPEG, PNG, GIF, WebP, MP4, MOV, WebM. Max 5MB.',
+    'Upload an image or video file to posterly. Returns a URL that can be used with create_post. Supports JPEG, PNG, GIF, WebP, MP4, MOV, WebM. Images up to 10MB, videos up to 50MB. IMPORTANT: If the user shares an image in the chat, use base64_data (not file_path) since chat-uploaded images are not on the local filesystem. Only use file_path when the user provides an actual local filesystem path.',
   inputSchema: z.object({
     file_path: z
       .string()
       .optional()
-      .describe('Absolute path to a local file to upload'),
+      .describe('Absolute local filesystem path (e.g. /Users/name/photo.jpg). Only use when the user gives you an explicit path. Do NOT guess paths for images uploaded in chat.'),
     base64_data: z
       .string()
       .optional()
-      .describe('Base64-encoded file data (alternative to file_path)'),
+      .describe('Base64-encoded file data. PREFERRED for images shared directly in chat — extract the image data as base64 and pass it here.'),
     filename: z
       .string()
       .describe('Filename with extension (e.g. photo.jpg, video.mp4)'),