@omnisocials/mcp-server 1.17.0 → 1.19.0

package/README.md

@@ -218,9 +218,20 @@ Full API docs: [docs.omnisocials.com](https://docs.omnisocials.com)
 
 ## Changelog
 
+### 1.19.0 (2026-08-02)
+
+- **Alt text now reaches Instagram and LinkedIn:** per-media alt text (`{ url, alt }` / `{ id, alt }` entries) is also delivered to Instagram (image posts and carousel image slides — not Reels/Stories) and LinkedIn (images only — not video or documents), alongside Mastodon, Bluesky, X, and Pinterest.
+- **`duration_seconds` on `get_recent_platform_posts`:** video length in whole seconds where the platform's listing API reports it (currently TikTok and YouTube; `null` for images and platforms that don't expose it) — rendered as a Duration column (m:ss) in the summary table and included in the `Structured data` JSON block.
+
+### 1.18.0
+
+- **`retry_post`:** retry the failed platforms of a `failed` or partially failed (`warning`) post on the same post — only failed platforms are re-published, succeeded ones never post twice. Async via the publishing queue; poll `get_post` for the outcome. Max 3 retries per platform. Backed by `POST /api/v1/posts/{id}/retry`.
+- **Retry linkage:** posts expose `retry_of` / `retries`, and `get_post` renders them — a `published` post with empty `published_urls` and `retries` set is a resolved failure, not a second publish.
+- **`get_post` now renders per-platform publish errors** (previously dropped) with a pointer to `retry_post`.
+
 ### 1.17.0
 
-- **Per-media alt text (accessibility descriptions):** `media_urls` / `media_ids` entries now accept `{ url, alt }` / `{ id, alt }` objects everywhere, including thread parts. Delivered to Mastodon (media description), Bluesky (embed alt), X (photos/GIFs), and Pinterest (pin `alt_text` fallback). `get_post` reads alt text back.
+- **Per-media alt text (accessibility descriptions):** `media_urls` / `media_ids` entries now accept `{ url, alt }` / `{ id, alt }` objects everywhere, including thread parts. Delivered to Mastodon (media description), Bluesky (embed alt), X (media metadata, photos/GIFs only) and Pinterest (pin alt_text fallback). `get_post` reads alt text back.
 
 ### 1.16.0
 

package/build/client.d.ts

@@ -213,6 +213,7 @@ export declare class OmniSocialsClient {
     }): Promise<ApiResponse<unknown>>;
     deletePost(id: string): Promise<ApiResponse<unknown>>;
     publishPost(id: string): Promise<ApiResponse<unknown>>;
+    retryPost(id: string): Promise<ApiResponse<unknown>>;
     searchLocations(query: string): Promise<ApiResponse<unknown>>;
     validateLocation(id: string): Promise<ApiResponse<unknown>>;
     searchInstagramAudio(query?: string, type?: "music" | "original_sound"): Promise<ApiResponse<unknown>>;

package/build/client.js

@@ -219,6 +219,11 @@ export class OmniSocialsClient {
     async publishPost(id) {
         return this.request("POST", `/posts/${id}/publish`);
     }
+    // Retry the failed platforms of a failed/warning post on the same post.
+    // Succeeded platforms are never re-published (server-side idempotency guard).
+    async retryPost(id) {
+        return this.request("POST", `/posts/${id}/retry`);
+    }
     // Locations (Instagram place tagging)
     async searchLocations(query) {
         return this.request("GET", "/locations/search", undefined, { q: query });

package/build/index.js

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

package/build/tools/media.js

@@ -142,7 +142,7 @@ When the user provides an image in the conversation (not a URL), use base64_data
         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. To attach alt text (an accessibility description), pass \`{ id: "<Media ID>", alt: "..." }\` instead of the bare ID — delivered to Mastodon, Bluesky, X (photos/GIFs), and Pinterest.`;
+        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. To attach alt text (an accessibility description), pass \`{ id: "<Media ID>", alt: "..." }\` instead of the bare ID — delivered to Mastodon, Bluesky, X, Pinterest, Instagram (images) and LinkedIn (images).`;
         return {
             content: [{ type: "text", text: md }],
         };

package/build/tools/posts.js

@@ -5,9 +5,11 @@ import { formatDateTime, truncate, capitalize, formatNumber, metricRows } from "
 // or an object carrying `alt`: an accessibility description (alt text, max
 // 1500 chars) for that file. Alt text is delivered to Mastodon (media
 // description — the community strongly values alt text), Bluesky (embed alt),
-// X (photos/GIFs only), and Pinterest (used as the pin alt_text when
-// pinterest.alt_text is not set); other platforms ignore it for now.
-const ALT_TEXT_DESCRIBE = "Accessibility description (alt text) for this file, max 1500 chars. Delivered to Mastodon (media description), Bluesky (embed alt), X (photos/GIFs only), and Pinterest (used as the pin alt_text when pinterest.alt_text is not set); other platforms ignore it.";
+// X (media metadata, photos/GIFs only), Pinterest (pin alt_text fallback),
+// Instagram (images and carousel image slides — not Reels/Stories, capped at
+// 1000 chars) and LinkedIn (images only — not video or documents); other
+// platforms ignore it for now.
+const ALT_TEXT_DESCRIBE = "Accessibility description (alt text) for this file, max 1500 chars. Delivered to Mastodon (media description), Bluesky (embed alt), X (media metadata, photos/GIFs only), Pinterest (pin alt_text fallback), Instagram (images and carousel image slides — not Reels/Stories) and LinkedIn (images only — not video or documents). Other platforms ignore it.";
 const mediaUrlEntry = z.union([
     z.string(),
     z.object({
@@ -193,6 +195,14 @@ export function registerPostTools(server, getClient) {
         md += `| **Created** | ${formatDateTime(p.created_at)} |\n`;
         if (appUrl)
             md += `| **Open in OmniSocials** | ${appUrl} |\n`;
+        // Retry linkage: a "published" post with `retries` set and empty
+        // published_urls is a resolved failure — the live URLs are on the retry
+        // post, so don't count both as separate publishes.
+        if (p.retry_of)
+            md += `| **Retry of post** | \`${p.retry_of}\` (this post is a retry of that failed post) |\n`;
+        if (Array.isArray(p.retries) && p.retries.length) {
+            md += `| **Retried by** | ${p.retries.map((r) => `\`${r}\``).join(", ")} (live URLs are on the retry post) |\n`;
+        }
         // Media can be a flat array (same set everywhere) or a per-platform
         // object ({ default: [...], instagram: [...] }). The old `p.media.length`
         // check silently dropped the object shape (`.length` is undefined).
@@ -300,6 +310,21 @@ export function registerPostTools(server, getClient) {
                 md += `- **${capitalize(platform.replace(/_/g, " "))}**: ${url}\n`;
             }
         }
+        // Per-platform publish errors (status failed/warning). Point at
+        // retry_post — only the failed platforms are re-published.
+        const postErrors = (p.errors && typeof p.errors === "object" && !Array.isArray(p.errors))
+            ? p.errors
+            : {};
+        const errorEntries = Object.entries(postErrors);
+        if (errorEntries.length) {
+            md += `\n\n### Publish Errors\n\n`;
+            for (const [platform, message] of errorEntries) {
+                md += `- **${capitalize(platform.replace(/_/g, " "))}**: ${message}\n`;
+            }
+            if (p.status === "failed" || p.status === "warning") {
+                md += `\n_Retry the failed platform(s) with \`retry_post\` — platforms that already succeeded are never re-published._\n`;
+            }
+        }
         // First comments: nested under each platform object by the API. Show the
         // configured text plus, once published, the outcome (posted/failed/skipped).
         const firstCommentPlatforms = ["instagram", "facebook", "linkedin", "linkedin_page", "youtube"];
@@ -398,11 +423,11 @@ Do NOT call this tool without media when creating stories, reels, Instagram post
         media_ids: z.union([
             z.array(mediaIdEntry),
             z.record(z.string(), z.array(mediaIdEntry)),
-        ]).optional().describe("Media IDs from upload — flat array (same for all platforms) or object with platform keys: { default: [...], instagram: [...] }. Each entry is a plain ID string or { id, alt } to attach alt text (accessibility description, max 1500 chars) to that file — delivered to Mastodon, Bluesky, X (photos/GIFs), and Pinterest."),
+        ]).optional().describe("Media IDs from upload — flat array (same for all platforms) or object with platform keys: { default: [...], instagram: [...] }. Each entry is a plain ID string or { id, alt } to attach alt text (accessibility description, max 1500 chars) to that file — delivered to Mastodon, Bluesky, X, Pinterest, Instagram (images) and LinkedIn (images)."),
         media_urls: z.union([
             z.array(mediaUrlEntry),
             z.record(z.string(), z.array(mediaUrlEntry)),
-        ]).optional().describe("External image/video URLs — flat array (same for all platforms) or object with platform keys: { default: [...], instagram: [...], pinterest: [...] }. Each entry is a plain URL string or { url, alt } to attach alt text (accessibility description, max 1500 chars) to that file — delivered to Mastodon, Bluesky, X (photos/GIFs), and Pinterest. Max 10 total, each file ≤ 100 MB. When using per-platform format, 'default' is the fallback for selected platforms without their own key. Pass an empty array (e.g. facebook: []) to opt a platform out of media. For files over 100 MB (up to 1 GB): upload_media with method 'url' first, then pass the returned media id in `media`."),
+        ]).optional().describe("External image/video URLs — flat array (same for all platforms) or object with platform keys: { default: [...], instagram: [...], pinterest: [...] }. Each entry is a plain URL string or { url, alt } to attach alt text (accessibility description, max 1500 chars) to that file — delivered to Mastodon, Bluesky, X, Pinterest, Instagram (images) and LinkedIn (images). Max 10 total, each file ≤ 100 MB. When using per-platform format, 'default' is the fallback for selected platforms without their own key. Pass an empty array (e.g. facebook: []) to opt a platform out of media. For files over 100 MB (up to 1 GB): upload_media with method 'url' first, then pass the returned media id in `media`."),
         type: z.enum(["post", "story", "reel"]).optional().describe("Content type: 'post' (default), 'story' (Instagram/Facebook/Snapchat), 'reel' (Instagram/Facebook/YouTube/TikTok)"),
         link_url: z.string().optional().describe("URL to share as a rich preview card on platforms that support link-share posts (LinkedIn and Facebook). The URL renders as a tile with thumbnail / title / description instead of plain text. Ignored on platforms that don't support link shares, and ignored on posts that already have media attached (media wins)."),
         link_title: z.string().optional().describe("Optional title for the link-share preview. LinkedIn uses this when set; Facebook ignores it and fetches OG metadata server-side. Omit to let LinkedIn auto-fetch the page title."),
@@ -579,11 +604,11 @@ Do NOT call without required media — it will fail.`, {
         media_ids: z.union([
             z.array(mediaIdEntry),
             z.record(z.string(), z.array(mediaIdEntry)),
-        ]).optional().describe("Media IDs from upload — flat array or per-platform object. Each entry is a plain ID string or { id, alt } to attach alt text — delivered to Mastodon, Bluesky, X (photos/GIFs), and Pinterest."),
+        ]).optional().describe("Media IDs from upload — flat array or per-platform object. Each entry is a plain ID string or { id, alt } to attach alt text — delivered to Mastodon, Bluesky, X, Pinterest, Instagram (images) and LinkedIn (images)."),
         media_urls: z.union([
             z.array(mediaUrlEntry),
             z.record(z.string(), z.array(mediaUrlEntry)),
-        ]).optional().describe("External image/video URLs — flat array or per-platform object. Each entry is a plain URL string or { url, alt } to attach alt text — delivered to Mastodon, Bluesky, X (photos/GIFs), and Pinterest. Max 10 total, each file ≤ 100 MB (larger, up to 1 GB: upload_media with method 'url' → pass the media id in `media`). 'default' key is fallback for platforms without their own key. Empty array opts out."),
+        ]).optional().describe("External image/video URLs — flat array or per-platform object. Each entry is a plain URL string or { url, alt } to attach alt text — delivered to Mastodon, Bluesky, X, Pinterest, Instagram (images) and LinkedIn (images). Max 10 total, each file ≤ 100 MB (larger, up to 1 GB: upload_media with method 'url' → pass the media id in `media`). 'default' key is fallback for platforms without their own key. Empty array opts out."),
         type: z.enum(["post", "story", "reel"]).optional().describe("Content type: 'post' (default), 'story', 'reel'"),
         location_id: z.string().optional().describe("Instagram only. Facebook Place ID of a single physical venue to tag the post's location. Applied to single-image and carousel Instagram feed posts. Use the `search_locations` tool to find a valid ID. Ignored by other platforms."),
         collaborators: z.array(z.string()).max(3).optional().describe("Instagram only. Up to 3 public Instagram usernames to invite as co-authors (the 'Collab' feature). Works on image, carousel, and reel posts — NOT Stories. A leading '@' is stripped; usernames are case-insensitive. Private or non-existent usernames are rejected by Instagram at publish time. Ignored by other platforms."),
@@ -722,11 +747,11 @@ Do NOT call without required media — it will fail.`, {
         media_ids: z.union([
             z.array(mediaIdEntry),
             z.record(z.string(), z.array(mediaIdEntry)),
-        ]).optional().describe("Media IDs — flat array or per-platform object. Each entry is a plain ID string or { id, alt } to attach alt text — delivered to Mastodon, Bluesky, X (photos/GIFs), and Pinterest."),
+        ]).optional().describe("Media IDs — flat array or per-platform object. Each entry is a plain ID string or { id, alt } to attach alt text — delivered to Mastodon, Bluesky, X, Pinterest, Instagram (images) and LinkedIn (images)."),
         media_urls: z.union([
             z.array(mediaUrlEntry),
             z.record(z.string(), z.array(mediaUrlEntry)),
-        ]).optional().describe("External URLs — flat array or per-platform object. Each entry is a plain URL string or { url, alt } to attach alt text — delivered to Mastodon, Bluesky, X (photos/GIFs), and Pinterest. Max 10 total, each file ≤ 100 MB (larger, up to 1 GB: upload_media with method 'url' → pass the media id in `media`). 'default' key is fallback for platforms without their own key. Empty array opts out."),
+        ]).optional().describe("External URLs — flat array or per-platform object. Each entry is a plain URL string or { url, alt } to attach alt text — delivered to Mastodon, Bluesky, X, Pinterest, Instagram (images) and LinkedIn (images). Max 10 total, each file ≤ 100 MB (larger, up to 1 GB: upload_media with method 'url' → pass the media id in `media`). 'default' key is fallback for platforms without their own key. Empty array opts out."),
         location_id: z.string().optional().describe("Instagram only. Facebook Place/Page ID to tag the post's location with. Send an empty string to clear an existing location tag. Ignored by other platforms."),
         collaborators: z.array(z.string()).max(3).optional().describe("Instagram only. Up to 3 public Instagram usernames to invite as co-authors. Replaces the existing collaborator list. Send an empty array to clear collaborators. Works on image, carousel, and reel posts — NOT Stories. Ignored by other platforms."),
         user_tags: z.array(z.object({
@@ -854,7 +879,7 @@ Do NOT call without required media — it will fail.`, {
             content: [{ type: "text", text: result.error ? `Error (${result.error.code}): ${result.error.message}` : "Post deleted successfully." }],
         };
     });
-    server.tool("publish_post", `Publish a draft or scheduled post immediately. The post will be queued for publishing.
+    server.tool("publish_post", `Publish a draft or scheduled post immediately. The post will be queued for publishing. Only draft and scheduled posts can be published — for a failed or partially failed (warning) post use \`retry_post\` instead, which re-publishes only the failed platforms.
 
 IMPORTANT: Before publishing, verify the post has all required media. If publishing a story or reel, ensure media was attached when the post was created/updated. If it's missing, use update_post to add media first, or inform the user.`, {
         id: z.string().describe("The post ID to publish"),
@@ -875,6 +900,31 @@ IMPORTANT: Before publishing, verify the post has all required media. If publish
             content: [{ type: "text", text: md }],
         };
     });
+    server.tool("retry_post", `Retry the failed platforms of a failed or partially failed post — on the same post, no duplicate created. Use when a post has status \`failed\` (every platform failed) or \`warning\` (some failed, some published): only the FAILED platforms are re-published; platforms that already succeeded are never posted again.
+
+The retry runs asynchronously (usually within a few minutes). Poll \`get_post\` afterwards: on success the status becomes \`published\` and \`published_urls\` gains the platform's live URL; on another failure the platform's entry reappears under errors. Each platform can be retried at most 3 times — after that, recreate the post. Note \`publish_post\` refuses failed posts; this is the tool for them.`, {
+        id: z.string().describe("The failed or partially failed post ID to retry"),
+    }, async ({ id }) => {
+        const result = await getClient().retryPost(id);
+        if (result.error) {
+            return {
+                content: [{ type: "text", text: `Error (${result.error.code}): ${result.error.message}` }],
+            };
+        }
+        const p = result.data;
+        let md = `## Retry Queued\n\n`;
+        md += `| Field | Value |\n`;
+        md += `|-------|-------|\n`;
+        md += `| **ID** | \`${p.id}\` |\n`;
+        md += `| **Status** | ${capitalize(p.status || "posting")} |\n`;
+        if (Array.isArray(p.platforms) && p.platforms.length) {
+            md += `| **Retrying** | ${p.platforms.map((x) => capitalize(x.replace(/_/g, " "))).join(", ")} |\n`;
+        }
+        md += `\n_Platforms that already succeeded are never re-published. Check \`get_post\` in a minute or two for the outcome._`;
+        return {
+            content: [{ type: "text", text: md }],
+        };
+    });
     server.tool("search_locations", `Search for an Instagram location to tag on a post. Use this whenever the user wants to post WITH a place/location (e.g. "post this at my dealership", "tag the café"). It returns matching real venues with their addresses and a location ID.
 
 Flow: call this with the place name → present the options to the user → once they pick, pass that result's \`id\` as \`location_id\` on create_post / create_and_publish_post / update_post. Only Instagram supports location tagging.
@@ -937,7 +987,7 @@ Notes: only tracks Meta licenses for third-party publishing appear, so the selec
         });
         return { content: [{ type: "text", text: md }] };
     });
-    server.tool("get_recent_platform_posts", "Fetch the user's most recent posts straight from their connected platform APIs (Instagram, TikTok, X, YouTube, Facebook, LinkedIn, and more), INCLUDING content published outside OmniSocials. Use this when list_posts is empty — e.g. a brand-new workspace that has not published through OmniSocials yet — so you can still analyze the user's real content. Each post includes normalized `engagement` plus every raw metric the platform reported (Instagram: reach/views/saves/shares from per-post insights). Metrics only appear where the platform exposes them for historical posts (X, TikTok, Bluesky, Mastodon, Instagram, Facebook, YouTube); Threads, Pinterest, and Google Business return captions only. LinkedIn personal profiles can't be listed live (LinkedIn grants apps no such permission), so their results are posts published through OmniSocials with their latest collected stats. Fetched live, so expect a few seconds of latency. Output is a human-readable summary table PLUS a 'Structured data' JSON block carrying, for every post, the platform's own post id (the stable dedupe key), a permalink, the FULL untruncated caption, and exact-integer metrics — use that block when ingesting or storing native posts rather than the rounded/truncated table. Requires the analytics:read scope.", {
+    server.tool("get_recent_platform_posts", "Fetch the user's most recent posts straight from their connected platform APIs (Instagram, TikTok, X, YouTube, Facebook, LinkedIn, and more), INCLUDING content published outside OmniSocials. Use this when list_posts is empty — e.g. a brand-new workspace that has not published through OmniSocials yet — so you can still analyze the user's real content. Each post includes normalized `engagement` plus every raw metric the platform reported (Instagram: reach/views/saves/shares from per-post insights). Metrics only appear where the platform exposes them for historical posts (X, TikTok, Bluesky, Mastodon, Instagram, Facebook, YouTube); Threads, Pinterest, and Google Business return captions only. Records also carry `duration_seconds` — the video length in whole seconds — where the platform's listing API reports it (currently TikTok and YouTube); null for images and platforms that don't expose it. LinkedIn personal profiles can't be listed live (LinkedIn grants apps no such permission), so their results are posts published through OmniSocials with their latest collected stats. Fetched live, so expect a few seconds of latency. Output is a human-readable summary table PLUS a 'Structured data' JSON block carrying, for every post, the platform's own post id (the stable dedupe key), a permalink, the FULL untruncated caption, and exact-integer metrics — use that block when ingesting or storing native posts rather than the rounded/truncated table. Requires the analytics:read scope.", {
         limit: z
             .string()
             .optional()
@@ -958,6 +1008,14 @@ Notes: only tracks Meta licenses for third-party publishing appear, so the selec
         const errors = result.errors || {};
         const errEntries = Object.entries(errors);
         const clean = (s) => String(s || "").replace(/[|\n\r]+/g, " ").trim();
+        // Video length as m:ss (e.g. 95 → "1:35"); blank for images and
+        // platforms whose listing API reports no duration.
+        const fmtVideoDuration = (secs) => {
+            if (typeof secs !== "number" || !Number.isFinite(secs))
+                return "—";
+            const s = Math.round(secs);
+            return `${Math.floor(s / 60)}:${String(s % 60).padStart(2, "0")}`;
+        };
         if (!posts.length) {
             const note = result.note || "No recent platform posts found.";
             const errLines = errEntries.map(([p, m]) => `- ${capitalize(p)}: ${m}`).join("\n");
@@ -966,8 +1024,8 @@ Notes: only tracks Meta licenses for third-party publishing appear, so the selec
             };
         }
         let md = `## Recent platform posts (${posts.length} across ${connected.length} platform${connected.length === 1 ? "" : "s"})\n\n`;
-        md += `| # | Platform | Format | Content | Engagement | Metrics | Date |\n`;
-        md += `|---|----------|--------|---------|------------|---------|------|\n`;
+        md += `| # | Platform | Format | Duration | Content | Engagement | Metrics | Date |\n`;
+        md += `|---|----------|--------|----------|---------|------------|---------|------|\n`;
         posts.forEach((p, i) => {
             const hasMetrics = p.metrics && Object.keys(p.metrics).length > 0;
             const content = truncate(clean(p.text), 45) || "*(no caption)*";
@@ -979,7 +1037,7 @@ Notes: only tracks Meta licenses for third-party publishing appear, so the selec
                 .map(([label, n]) => `${formatNumber(n)} ${label.toLowerCase()}`)
                 .join(" · ");
             const date = p.timestamp ? formatDateTime(p.timestamp) : "—";
-            md += `| ${i + 1} | ${capitalize(p.platform)} | ${p.format || "post"} | ${content} | ${eng} | ${detail || "—"} | ${date} |\n`;
+            md += `| ${i + 1} | ${capitalize(p.platform)} | ${p.format || "post"} | ${fmtVideoDuration(p.duration_seconds)} | ${content} | ${eng} | ${detail || "—"} | ${date} |\n`;
         });
         if (result.note)
             md += `\n${result.note}\n`;
@@ -1001,6 +1059,7 @@ Notes: only tracks Meta licenses for third-party publishing appear, so the selec
             text: p.text ?? "",
             format: p.format ?? "post",
             media_count: p.media_count ?? 1,
+            duration_seconds: p.duration_seconds ?? null,
             timestamp: p.timestamp ?? null,
             image_url: p.image_url ?? null,
             engagement: p.engagement ?? null,

package/package.json

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