@omnisocials/mcp-server 1.7.0 → 1.7.1

package/build/client.d.ts

@@ -141,6 +141,17 @@ export declare class OmniSocialsClient {
         name?: string;
         folder?: string;
     }): Promise<ApiResponse<unknown>>;
+    /**
+     * Preflight a file's compatibility with the workspace's connected platforms
+     * BEFORE uploading. Provide one of: a public `url`, an existing `media_id`,
+     * or `size_bytes` + `mime`.
+     */
+    checkMediaCompatibility(data: {
+        url?: string;
+        media_id?: string;
+        size_bytes?: number;
+        mime?: string;
+    }): Promise<ApiResponse<unknown>>;
     deleteMedia(id: string): Promise<ApiResponse<unknown>>;
     updateMedia(id: string, data: {
         name?: string;

package/build/client.js

@@ -162,11 +162,22 @@ export class OmniSocialsClient {
         return this.request("GET", "/media", undefined, params);
     }
     async uploadMedia(data) {
+        // Videos up to 1 GB: the API streams files >100 MB in the background and
+        // responds with the item in `processing` state. Includes a `compatibility`
+        // block listing connected platforms that would reject the file.
         return this.request("POST", "/media/upload-from-url", data);
     }
     async uploadMediaFromBase64(data) {
         return this.request("POST", "/media/upload-from-base64", data);
     }
+    /**
+     * Preflight a file's compatibility with the workspace's connected platforms
+     * BEFORE uploading. Provide one of: a public `url`, an existing `media_id`,
+     * or `size_bytes` + `mime`.
+     */
+    async checkMediaCompatibility(data) {
+        return this.request("POST", "/media/check", data);
+    }
     async deleteMedia(id) {
         return this.request("DELETE", `/media/${id}`);
     }

package/build/index.js

@@ -27,7 +27,7 @@ const sessionState = { activeIndex: 0 };
 const getActiveClient = () => workspaceClients[sessionState.activeIndex].client;
 const server = new McpServer({
     name: "OmniSocials",
-    version: "1.7.0",
+    version: "1.7.1",
 });
 // Register all tools - pass getter function so tools always use the active workspace's client
 registerPostTools(server, getActiveClient);

package/build/tools/media.js

@@ -32,7 +32,7 @@ export function registerMediaTools(server, getClient) {
             const isVideo = rawType === "video" || rawType.startsWith("video/");
             const type = isVideo ? "Video" : "Image";
             const folder = m.folder_id ? `\`${m.folder_id}\`` : "—";
-            md += `| ${i + 1} | ${type} | ${m.name || m.filename || "—"} | ${folder} | ${formatBytes(m.size || 0)} | \`${m.id}\` |\n`;
+            md += `| ${i + 1} | ${type} | ${m.name || m.filename || "—"} | ${folder} | ${(m.size || "—")} | \`${m.id}\` |\n`;
         }
         md += `\nUse the **Media ID** with \`media_ids\` when creating posts. Rename or move a file with \`update_media\`. See folders with \`list_folders\`.`;
         // Fetch thumbnails for image files (max 4)
@@ -55,7 +55,13 @@ export function registerMediaTools(server, getClient) {
         content.push({ type: "text", text: md });
         return { content };
     });
-    server.tool("upload_media", `Upload media to the library. Accepts EITHER a public URL OR base64-encoded image data (e.g. when the user pastes an image directly in chat). Max 50MB. Supported: JPEG, PNG, GIF, WebP, MP4, MOV, AVI.
+    server.tool("upload_media", `Upload media to the library. Accepts EITHER a public URL OR base64-encoded image data (e.g. when the user pastes an image directly in chat). Supported: JPEG, PNG, GIF, WebP, MP4, MOV, AVI.
+
+Size limits: base64 and direct uploads are capped at 100 MB (and base64 inflates the request body, so the practical ceiling is ~75 MB). For anything larger — up to 1 GB — use ONE of: (a) pass a public 'url' and the server fetches it (handles up to 1 GB), or (b) have the user upload the file in the OmniSocials Library UI at https://app.omnisocials.com/library . IMPORTANT: if the user has a large LOCAL file (over ~100 MB) with no public URL, do NOT tell them to compress or shrink it — instead point them to the Library UI link above, which uploads files up to 1 GB directly.
+
+Large videos (over 100 MB) are processed in the background: the response comes back with status "processing" — the file is NOT usable in a post until its status is "ready". Re-check with list_media (search by the name you gave it) until its status is "ready".
+
+Compatibility: the response includes a "compatibility" summary of any CONNECTED platforms that would reject the file (e.g. too large for Instagram). If there are warnings, RELAY them to the user and ask whether to continue before using the media in a post — the file still uploads and can post to the platforms that DO accept it. To check BEFORE uploading, use check_media_compatibility first.
 
 When the user provides an image in the conversation (not a URL), use base64_data + mime_type to upload it directly.`, {
         url: z.string().optional().describe("Public URL of the media file to upload. Use this OR base64_data, not both."),
@@ -89,22 +95,72 @@ When the user provides an image in the conversation (not a URL), use base64_data
             };
         }
         const m = result.data;
-        let md = `## Media Uploaded\n\n`;
+        const compatibility = result.compatibility;
+        const isProcessing = m.status === "processing";
+        let md = isProcessing ? `## Media Processing\n\n` : `## Media Uploaded\n\n`;
         md += `| Field | Value |\n`;
         md += `|-------|-------|\n`;
         md += `| **Media ID** | \`${m.id}\` |\n`;
         md += `| **Name** | ${m.name || m.filename || "—"} |\n`;
         md += `| **Type** | ${m.type || "—"} |\n`;
+        if (m.status)
+            md += `| **Status** | ${m.status} |\n`;
         if (m.folder_id)
             md += `| **Folder** | \`${m.folder_id}\` |\n`;
-        md += `| **Size** | ${formatBytes(m.size || 0)} |\n`;
+        md += `| **Size** | ${(m.size || "—")} |\n`;
         if (m.url)
             md += `| **URL** | ${m.url} |\n`;
-        md += `\nUse this Media ID with \`media_ids\` when creating posts (including inside \`x.thread_parts[].media_ids\`). The public URL above also works anywhere \`media_urls\` is accepted.`;
+        if (isProcessing) {
+            md += `\n⏳ This large video is still being processed. Re-check with list_media (search by its name) until its status is **ready** before using it in a post.`;
+        }
+        if (compatibility && compatibility.compatible === false && compatibility.summary) {
+            md += `\n\n⚠️ **${compatibility.summary}** It will still post to your other connected platforms. Ask the user whether to continue before adding it to a post.`;
+        }
+        md += `\n\nUse this Media ID with \`media_ids\` when creating posts (including inside \`x.thread_parts[].media_ids\`). The public URL above also works anywhere \`media_urls\` is accepted.`;
         return {
             content: [{ type: "text", text: md }],
         };
     });
+    server.tool("check_media_compatibility", `Check whether a video/image will be accepted by the platforms CONNECTED to this workspace, BEFORE uploading or posting. Use this when the user gives you a file (URL) so you can warn them upfront — e.g. "this 995 MB video won't post to Instagram (max 300 MB), continue?" — and confirm before uploading.
+
+Provide ONE of: a public 'url' (its size/type is read via a HEAD request), an existing 'media_id', or explicit 'size_bytes' + 'mime'. Returns the connected platforms and any that would reject the file by size or format.`, {
+        url: z.string().optional().describe("Public URL of the file to check. Use this OR media_id OR size_bytes+mime."),
+        media_id: z.string().optional().describe("Id of an already-uploaded library item to check."),
+        size_bytes: z.number().optional().describe("File size in bytes (use with mime when you already know them)."),
+        mime: z.string().optional().describe("MIME type, e.g. 'video/mp4' (use with size_bytes)."),
+    }, async (params) => {
+        if (!params.url && !params.media_id && !(params.size_bytes && params.mime)) {
+            return {
+                content: [{ type: "text", text: "Error: Provide one of 'url', 'media_id', or 'size_bytes' + 'mime'." }],
+            };
+        }
+        const result = await getClient().checkMediaCompatibility(params);
+        if (result.error) {
+            return {
+                content: [{ type: "text", text: `Error (${result.error.code}): ${result.error.message}` }],
+            };
+        }
+        const r = result;
+        const connected = r.connected_platforms || [];
+        let md = `## Compatibility Check\n\n`;
+        if (r.file) {
+            const sz = r.file.size_known ? formatBytes(r.file.size_bytes) : "unknown size";
+            md += `File: ${sz}${r.file.mime ? ` · ${r.file.mime}` : ""}\n`;
+        }
+        md += `Connected platforms: ${connected.length ? connected.join(", ") : "none"}\n\n`;
+        if (r.compatible) {
+            md += `✅ This file posts to all your connected platforms.`;
+        }
+        else {
+            md += `⚠️ ${r.summary || "Some connected platforms would reject this file:"}\n\n`;
+            md += `| Platform | Why |\n|----------|-----|\n`;
+            for (const w of r.warnings || []) {
+                md += `| ${w.display_name} | ${(w.reasons || []).join(", ")} |\n`;
+            }
+            md += `\nAsk the user whether to continue. It will still post to the platforms not listed above.`;
+        }
+        return { content: [{ type: "text", text: md }] };
+    });
     server.tool("update_media", "Rename an existing media file or move it into a folder (so it's findable later instead of re-uploading it). Only the fields you pass are changed.", {
         id: z.string().describe("The media ID to update"),
         name: z.string().optional().describe('New human-readable label, e.g. "pp-play5get50". Pass an empty string to clear it.'),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@omnisocials/mcp-server",
-  "version": "1.7.0",
+  "version": "1.7.1",
   "description": "MCP server for OmniSocials API - manage social media posts, media, accounts, analytics, and webhooks",
   "type": "module",
   "main": "build/index.js",