@omnisocials/mcp-server 1.4.1 → 1.5.0

package/README.md

@@ -192,6 +192,11 @@ Full API docs: [docs.omnisocials.com](https://docs.omnisocials.com)
 
 ## Changelog
 
+### 1.5.0
+
+- **Added:** Attach uploaded media to any tweet in an X thread. `x.thread_parts[]` now accepts `media_ids` (the same numeric Library IDs returned by `upload_media`) on any part, first tweet or reply, alongside the existing `media_urls`. Combined cap is 4 media per part. This makes graphic-led threads possible without self-hosting image URLs: for example a graphic on the first tweet and the signup link alone in a reply (which keeps the first tweet's reach). Companion server change: media attached to the parent post was previously dropped in thread mode and is now folded into the first tweet.
+- **Changed:** `upload_media` now shows the uploaded file's public URL in its output, so it can be reused anywhere `media_urls` is accepted.
+
 ### 1.4.1
 
 - **Fixed:** Long-form X posts from Premium / Premium+ accounts are no longer wrongly capped at 280 characters. Companion server fix — the API validated X text without checking the account's subscription tier, so single posts over 280 chars were rejected even on Premium. Existing clients benefit automatically once the backend deploys; 1.4.1 only refreshes the tool guidance so agents put Premium long-form (up to 25,000 chars) in `content` instead of force-splitting it into a thread. Note: X *threads* still cap each part at 280 chars regardless of tier.

package/build/client.d.ts

@@ -12,7 +12,9 @@ export declare function capitalize(str: string): string;
 export interface XThreadPartInput {
     /** Tweet text — ≤ 280 chars (the API enforces 280 even for X Premium). */
     text: string;
-    /** Optional per-part media URLs (max 4). Overrides top-level media_urls.x. */
+    /** Optional per-part media as Library IDs from upload_media (max 4 combined with media_urls). */
+    media_ids?: string[];
+    /** Optional per-part media as external URLs (max 4 combined with media_ids). */
     media_urls?: string[];
 }
 export interface XPostOptions {

package/build/tools/media.js

@@ -86,7 +86,9 @@ When the user provides an image in the conversation (not a URL), use base64_data
         md += `| **Type** | ${m.type || "—"} |\n`;
         md += `| **Filename** | ${m.filename || "—"} |\n`;
         md += `| **Size** | ${formatBytes(m.size || 0)} |\n`;
-        md += `\nUse this Media ID with \`media_ids\` when creating posts.`;
+        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.`;
         return {
             content: [{ type: "text", text: md }],
         };

package/build/tools/posts.js

@@ -264,8 +264,9 @@ Do NOT call this tool without media when creating stories, reels, Instagram post
             made_with_ai: z.boolean().optional().describe("Mark as AI-generated content"),
             thread_parts: z.array(z.object({
                 text: z.string().describe("Tweet text (≤ 280 chars)"),
-                media_urls: z.array(z.string()).max(4).optional().describe("Per-tweet media URLs (max 4)"),
-            })).min(2).max(25).optional().describe("Publish as a chained X thread instead of a single tweet. Provide 2–25 parts; each is posted in order via in_reply_to_tweet_id. Per-part media_urls override top-level media for that specific tweet. For a single tweet, omit thread_parts and use content."),
+                media_ids: z.array(z.string()).max(4).optional().describe("Per-tweet media as Library IDs from upload_media (max 4 combined with media_urls). Attach your uploaded graphics to any tweet in the thread."),
+                media_urls: z.array(z.string()).max(4).optional().describe("Per-tweet media as external URLs (max 4 combined with media_ids)"),
+            })).min(2).max(25).optional().describe("Publish as a chained X thread instead of a single tweet. Provide 2–25 parts; each is posted in order via in_reply_to_tweet_id. Attach media to any part (first tweet or reply) via media_ids (from upload_media) or media_urls — max 4 per part. For a single tweet, omit thread_parts and use content."),
         }).optional().describe("X (Twitter) options"),
         google_business: z.object({
             topic_type: z.enum(["STANDARD", "EVENT", "OFFER"]).optional().describe("Local post type. Defaults to STANDARD. ALERT is reserved by Google and not exposed."),
@@ -387,8 +388,9 @@ Do NOT call without required media — it will fail.`, {
             made_with_ai: z.boolean().optional().describe("Mark as AI-generated content"),
             thread_parts: z.array(z.object({
                 text: z.string().describe("Tweet text (≤ 280 chars)"),
-                media_urls: z.array(z.string()).max(4).optional().describe("Per-tweet media URLs (max 4)"),
-            })).min(2).max(25).optional().describe("Publish as a chained X thread (2–25 parts). Each is posted in order via in_reply_to_tweet_id. Per-part media_urls override top-level media."),
+                media_ids: z.array(z.string()).max(4).optional().describe("Per-tweet media as Library IDs from upload_media (max 4 combined with media_urls). Attach your uploaded graphics to any tweet in the thread."),
+                media_urls: z.array(z.string()).max(4).optional().describe("Per-tweet media as external URLs (max 4 combined with media_ids)"),
+            })).min(2).max(25).optional().describe("Publish as a chained X thread (2–25 parts). Each is posted in order via in_reply_to_tweet_id. Attach media to any part via media_ids (from upload_media) or media_urls — max 4 per part."),
         }).optional().describe("X (Twitter) options"),
         google_business: z.object({
             topic_type: z.enum(["STANDARD", "EVENT", "OFFER"]).optional(),
@@ -496,8 +498,9 @@ Do NOT call without required media — it will fail.`, {
             made_with_ai: z.boolean().optional(),
             thread_parts: z.array(z.object({
                 text: z.string().describe("Tweet text (≤ 280 chars)"),
-                media_urls: z.array(z.string()).max(4).optional().describe("Per-tweet media URLs (max 4)"),
-            })).min(2).max(25).nullable().optional().describe("Replace the X thread shape on this post. Pass an array (2–25 parts) to update/create the thread, or `null` to revert to single-tweet mode."),
+                media_ids: z.array(z.string()).max(4).optional().describe("Per-tweet media as Library IDs from upload_media (max 4 combined with media_urls). Attach your uploaded graphics to any tweet in the thread."),
+                media_urls: z.array(z.string()).max(4).optional().describe("Per-tweet media as external URLs (max 4 combined with media_ids)"),
+            })).min(2).max(25).nullable().optional().describe("Replace the X thread shape on this post. Pass an array (2–25 parts) to update/create the thread (attach media to any part via media_ids or media_urls, max 4 per part), or `null` to revert to single-tweet mode."),
         }).optional().describe("X (Twitter) options"),
         google_business: z.object({
             topic_type: z.enum(["STANDARD", "EVENT", "OFFER"]).optional(),

package/package.json

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