@omnisocials/mcp-server 1.3.1 → 1.3.3

package/README.md

@@ -189,6 +189,17 @@ The agent-skills package uses a CLI + SKILL.md approach that works in any AI cod
 
 Full API docs: [docs.omnisocials.com](https://docs.omnisocials.com)
 
+## Changelog
+
+### 1.3.2 / 1.3.3
+
+- **Fixed:** `create_post` and `create_and_publish_post` no longer throw `str.replace is not a function` when the API returns per-platform `content` as an object. Response formatters now wrapped in a safe fallback so a formatting throw can never surface as a tool error (closes the duplicate-on-retry trap).
+- **Fixed:** `list_posts` and `get_post` now render the correct **Channels** and **Scheduled** values. Previously read the wrong field names (`p.channels` / `p.scheduled_at`) and fell through to `created_at` for the date.
+- **Fixed:** Date rendering always includes an explicit `UTC` suffix. Agents convert to local time when answering the user.
+- **Fixed:** `list_media` now labels video files as `Video` (was showing `Image` for every `.mp4`).
+
+(1.3.3 is a metadata republish of 1.3.2 to refresh the README on npmjs.com. No code changes between 1.3.2 and 1.3.3.)
+
 ## License
 
 MIT

package/build/client.d.ts

@@ -7,7 +7,7 @@ export declare function formatNumber(n: number): string;
 export declare function formatBytes(bytes: number): string;
 export declare function formatDate(iso: string | null): string;
 export declare function formatDateTime(iso: string | null): string;
-export declare function truncate(str: string, len: number): string;
+export declare function truncate(value: unknown, len: number): string;
 export declare function capitalize(str: string): string;
 export interface XThreadPartInput {
     /** Tweet text — ≤ 280 chars (the API enforces 280 even for X Premium). */

package/build/client.js

@@ -51,16 +51,36 @@ export function formatDateTime(iso) {
     if (!iso)
         return "—";
     const d = new Date(iso);
+    // Always render in UTC with an explicit "UTC" suffix so the timezone is
+    // unambiguous regardless of which Node runtime / ICU build the MCP runs in.
+    // Agents can convert to the user's local time when answering.
     return d.toLocaleDateString("en-US", {
         month: "short",
         day: "numeric",
         year: "numeric",
         hour: "numeric",
         minute: "2-digit",
-        timeZoneName: "short",
-    });
+        timeZone: "UTC",
+    }) + " UTC";
 }
-export function truncate(str, len) {
+// Render any caption-like value (string or per-platform object) to a single
+// display string, then truncate. The backend returns `content` as an object
+// with one key per platform plus `default`; older callers may pass a string.
+export function truncate(value, len) {
+    let str;
+    if (typeof value === "string") {
+        str = value;
+    }
+    else if (value && typeof value === "object") {
+        const obj = value;
+        const first = (typeof obj.default === "string" && obj.default) ||
+            Object.values(obj).find((v) => typeof v === "string" && v.length > 0) ||
+            "";
+        str = first;
+    }
+    else {
+        return "";
+    }
     if (!str)
         return "";
     const clean = str.replace(/\n/g, " ");

package/build/tools/media.js

@@ -22,13 +22,20 @@ export function registerMediaTools(server, getClient) {
         md += `|---|------|----------|------|----------|\n`;
         for (let i = 0; i < items.length; i++) {
             const m = items[i];
-            const type = m.type === "video" ? "Video" : "Image";
+            // `type` may be "video"/"image" (normalized) or a raw MIME like "video/mp4".
+            const rawType = typeof m.type === "string" ? m.type : "";
+            const isVideo = rawType === "video" || rawType.startsWith("video/");
+            const type = isVideo ? "Video" : "Image";
             md += `| ${i + 1} | ${type} | ${m.filename || "—"} | ${formatBytes(m.size || 0)} | \`${m.id}\` |\n`;
         }
         md += `\nUse the **Media ID** with \`media_ids\` when creating posts.`;
         // Fetch thumbnails for image files (max 4)
         const content = [];
-        const imageItems = items.filter((m) => m.type !== "video" && m.url).slice(0, 4);
+        const imageItems = items.filter((m) => {
+            const t = typeof m.type === "string" ? m.type : "";
+            const isVideo = t === "video" || t.startsWith("video/");
+            return !isVideo && m.url;
+        }).slice(0, 4);
         const imagePromises = imageItems.map(async (m) => {
             const img = await fetchImageAsBase64(m.url);
             return img ? { ...img, id: m.id } : null;

package/build/tools/posts.js

@@ -18,6 +18,27 @@ function renderContent(content) {
         .map(([key, value]) => `**${key === "default" ? "Default (fallback)" : capitalize(key.replace(/_/g, " "))}**\n\n${value}`)
         .join("\n\n---\n\n");
 }
+// The API returns `accounts` as either an array of platform IDs or an object
+// map `{platform: true|false}`. Older clients may still receive `channels`.
+// Normalize to an array of selected platform names.
+function selectedChannels(p) {
+    const src = p?.accounts ?? p?.channels;
+    if (!src)
+        return [];
+    if (Array.isArray(src))
+        return src.filter((x) => typeof x === "string" && !!x);
+    if (typeof src === "object") {
+        return Object.entries(src)
+            .filter(([, v]) => !!v)
+            .map(([k]) => k);
+    }
+    return [];
+}
+// Pick the most informative timestamp to display. API returns `schedule_at`;
+// `scheduled_at` is kept as a defensive fallback for older response shapes.
+function displayDate(p) {
+    return p?.schedule_at ?? p?.scheduled_at ?? p?.published_at ?? p?.created_at ?? null;
+}
 export function registerPostTools(server, getClient) {
     server.tool("list_posts", "List all posts in the workspace. Optionally filter by status. The content column shows a preview of the default caption; if a post has per-platform overrides (e.g. a custom X version), the preview is suffixed with *(per-platform)* — call `get_post` to see every variant.", {
         status: z.string().optional().describe("Filter by status: draft, scheduled, published, failed"),
@@ -57,13 +78,9 @@ export function registerPostTools(server, getClient) {
             else {
                 content = truncate(rawContent, hasOverrides ? 35 : 50) + (hasOverrides ? " *(per-platform)*" : "");
             }
-            const channels = (p.channels || []).join(", ");
+            const channels = selectedChannels(p).join(", ") || "—";
             const status = capitalize(p.status || "—");
-            const date = p.scheduled_at
-                ? formatDateTime(p.scheduled_at)
-                : p.published_at
-                    ? formatDateTime(p.published_at)
-                    : formatDateTime(p.created_at);
+            const date = formatDateTime(displayDate(p));
             md += `| ${i + 1} | ${content} | ${channels} | ${status} | ${date} | \`${p.id}\` |\n`;
         }
         return {
@@ -88,12 +105,13 @@ export function registerPostTools(server, getClient) {
         let md = `## Post Details\n\n`;
         md += `| Field | Value |\n`;
         md += `|-------|-------|\n`;
+        const schedAt = p.schedule_at ?? p.scheduled_at;
         md += `| **ID** | \`${p.id}\` |\n`;
         md += `| **Status** | ${capitalize(p.status || "—")} |\n`;
         md += `| **Type** | ${p.type || "post"} |\n`;
-        md += `| **Channels** | ${(p.channels || []).join(", ") || "—"} |\n`;
-        if (p.scheduled_at)
-            md += `| **Scheduled** | ${formatDateTime(p.scheduled_at)} |\n`;
+        md += `| **Channels** | ${selectedChannels(p).join(", ") || "—"} |\n`;
+        if (schedAt)
+            md += `| **Scheduled** | ${formatDateTime(schedAt)} |\n`;
         if (p.published_at)
             md += `| **Published** | ${formatDateTime(p.published_at)} |\n`;
         md += `| **Created** | ${formatDateTime(p.created_at)} |\n`;
@@ -148,7 +166,11 @@ IMPORTANT — Before calling this tool, make sure you have all required informat
    - Pinterest posts: ALWAYS require an image AND a board_id.
    - Other platforms (LinkedIn, LinkedIn Page, X, Bluesky, etc.): Media is optional.
 5. **Platform-specific options** (ask only when relevant):
-   - Pinterest: Which board? Any link to attach?
+   - **Pinterest board (auto-default to first board)**: If Pinterest is in \`channels\` and \`pinterest.board_id\` is NOT provided, do NOT block on asking the user — and do NOT skip Pinterest. Instead:
+     1. Call \`get_account\` on the Pinterest account ID — the response includes a \`Pinterest Boards\` table with each board's name and ID.
+     2. Use the FIRST board in that list as \`pinterest.board_id\` automatically.
+     3. In your reply to the user after the post is created/scheduled, explicitly mention which board you used (e.g. "Posted to your 'Marketing' board on Pinterest — let me know if you'd prefer a different one and I'll move it.") so they can correct course.
+     If the user named a board ("post to my Marketing board") or specified one in the request, use that one instead of the first — match on name (case-insensitive) against the boards list.
    - YouTube: Title, privacy status, tags?
    - TikTok: Privacy level?
    - **X threads**: When the user asks for an X/Twitter "thread" (or anything that exceeds 280 chars on X), DO NOT cram it into \`content\` with "1/", "2/" prefixes. Instead pass \`x.thread_parts\` as an array of 2–25 \`{ text }\` objects (each ≤ 280 chars). The \`content\` field is then ignored for X. For a single tweet, omit \`thread_parts\` and use \`content\` normally.
@@ -213,19 +235,30 @@ Do NOT call this tool without media when creating stories, reels, Instagram post
             };
         }
         const p = result.data;
-        let md = `## Post Created\n\n`;
-        md += `| Field | Value |\n`;
-        md += `|-------|-------|\n`;
-        md += `| **ID** | \`${p.id}\` |\n`;
-        md += `| **Status** | ${capitalize(p.status || "draft")} |\n`;
-        if (p.scheduled_at)
-            md += `| **Scheduled** | ${formatDateTime(p.scheduled_at)} |\n`;
-        if (p.channels?.length)
-            md += `| **Channels** | ${p.channels.join(", ")} |\n`;
-        md += `\n**Content:** ${truncate(p.content || "", 100)}`;
-        return {
-            content: [{ type: "text", text: md }],
-        };
+        // The post is already created by the time this runs. If response
+        // formatting throws, we must NOT surface it as a tool error — agents
+        // retry on errors and that produces orphan duplicate posts.
+        try {
+            const schedAt = p.schedule_at ?? p.scheduled_at;
+            const channels = selectedChannels(p);
+            let md = `## Post Created\n\n`;
+            md += `| Field | Value |\n`;
+            md += `|-------|-------|\n`;
+            md += `| **ID** | \`${p.id}\` |\n`;
+            md += `| **Status** | ${capitalize(p.status || "draft")} |\n`;
+            if (schedAt)
+                md += `| **Scheduled** | ${formatDateTime(schedAt)} |\n`;
+            if (channels.length)
+                md += `| **Channels** | ${channels.join(", ")} |\n`;
+            md += `\n**Content:** ${truncate(p.content, 100)}`;
+            return { content: [{ type: "text", text: md }] };
+        }
+        catch {
+            // Fall back to the minimum the agent needs to confirm success — never error.
+            return {
+                content: [{ type: "text", text: `## Post Created\n\n- **ID:** \`${p.id}\`\n- **Status:** ${p.status || "draft"}\n\n_Post was created successfully. Use \`get_post\` with the ID above to see full details._` }],
+            };
+        }
     });
     server.tool("create_and_publish_post", `Create a new post and publish it immediately (no scheduling).
 
@@ -240,7 +273,8 @@ IMPORTANT — Before calling this tool, make sure you have all required informat
    - Instagram/TikTok posts: ALWAYS need at least one image or video.
    - Pinterest: ALWAYS need an image + board_id.
    - Ask the user which media to use. Use list_media to show options.
-4. **X threads**: When the user asks for an X/Twitter "thread" (or anything > 280 chars on X), pass \`x.thread_parts\` as a 2–25 entry array of \`{ text }\` objects. Do NOT split into "1/", "2/" inside \`content\` — that produces a single tweet, not a thread.
+4. **Pinterest board (auto-default to first board)**: If Pinterest is in \`channels\` and \`pinterest.board_id\` is NOT provided, do NOT block on asking — and do NOT skip Pinterest. Call \`get_account\` on the Pinterest account, take the FIRST board from the returned boards list, and pass its \`id\` as \`pinterest.board_id\`. In your reply, mention which board you used (e.g. "Published to your 'Marketing' board on Pinterest — let me know if you'd prefer a different one.") so the user can redirect. If the user named a specific board in the request, match it (case-insensitive) against the list and use that one instead.
+5. **X threads**: When the user asks for an X/Twitter "thread" (or anything > 280 chars on X), pass \`x.thread_parts\` as a 2–25 entry array of \`{ text }\` objects. Do NOT split into "1/", "2/" inside \`content\` — that produces a single tweet, not a thread.
 
 Do NOT call without required media — it will fail.`, {
         content: z.union([z.string(), z.record(z.string(), z.string())]).describe("Post caption. String for same text on all channels, or object with platform keys for per-channel captions: { \"default\": \"fallback\", \"linkedin\": \"long version\", \"threads\": \"short version\" }. The \"default\" key is used for any selected channel without its own key."),
@@ -284,17 +318,24 @@ Do NOT call without required media — it will fail.`, {
             };
         }
         const p = result.data;
-        let md = `## Post Created & Publishing\n\n`;
-        md += `| Field | Value |\n`;
-        md += `|-------|-------|\n`;
-        md += `| **ID** | \`${p.id}\` |\n`;
-        md += `| **Status** | ${capitalize(p.status || "publishing")} |\n`;
-        if (p.channels?.length)
-            md += `| **Channels** | ${p.channels.join(", ")} |\n`;
-        md += `\n**Content:** ${truncate(p.content || "", 100)}`;
-        return {
-            content: [{ type: "text", text: md }],
-        };
+        try {
+            const channels = selectedChannels(p);
+            let md = `## Post Created & Publishing\n\n`;
+            md += `| Field | Value |\n`;
+            md += `|-------|-------|\n`;
+            md += `| **ID** | \`${p.id}\` |\n`;
+            md += `| **Status** | ${capitalize(p.status || "publishing")} |\n`;
+            if (channels.length)
+                md += `| **Channels** | ${channels.join(", ")} |\n`;
+            md += `\n**Content:** ${truncate(p.content, 100)}`;
+            return { content: [{ type: "text", text: md }] };
+        }
+        catch {
+            // The post is already queued; never let a formatting throw look like an API error.
+            return {
+                content: [{ type: "text", text: `## Post Created & Publishing\n\n- **ID:** \`${p.id}\`\n- **Status:** ${p.status || "publishing"}\n\n_Post was queued successfully. Use \`get_post\` with the ID above for full details._` }],
+            };
+        }
     });
     server.tool("update_post", `Update an existing post. Only draft and scheduled posts can be updated.
 
@@ -328,13 +369,14 @@ Do NOT call without required media — it will fail.`, {
             };
         }
         const p = result.data;
+        const schedAt = p.schedule_at ?? p.scheduled_at;
         let md = `## Post Updated\n\n`;
         md += `| Field | Value |\n`;
         md += `|-------|-------|\n`;
         md += `| **ID** | \`${p.id}\` |\n`;
         md += `| **Status** | ${capitalize(p.status || "—")} |\n`;
-        if (p.scheduled_at)
-            md += `| **Scheduled** | ${formatDateTime(p.scheduled_at)} |\n`;
+        if (schedAt)
+            md += `| **Scheduled** | ${formatDateTime(schedAt)} |\n`;
         return {
             content: [{ type: "text", text: md }],
         };

package/package.json

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