@omnisocials/mcp-server 1.17.0 → 1.18.0

package/README.md

@@ -218,6 +218,12 @@ Full API docs: [docs.omnisocials.com](https://docs.omnisocials.com)
 
 ## Changelog
 
+### 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.

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.18.0",
 });
 // Register all tools - pass getter function so tools always use the active workspace's client
 registerPostTools(server, getActiveClient);

package/build/tools/posts.js

@@ -193,6 +193,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 +308,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"];
@@ -854,7 +877,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 +898,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.

package/package.json

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