@omnisocials/mcp-server 1.3.8 → 1.3.9

package/build/client.d.ts

@@ -49,11 +49,16 @@ export declare class OmniSocialsClient {
         media_urls?: string[] | Record<string, string[]>;
         type?: string;
         source?: string;
+        link_url?: string;
+        link_title?: string;
+        link_description?: string;
+        link_thumbnail_url?: string;
         pinterest?: Record<string, unknown>;
         youtube?: Record<string, unknown>;
         instagram?: Record<string, unknown>;
         tiktok?: Record<string, unknown>;
         x?: XPostOptions;
+        google_business?: Record<string, unknown>;
     }): Promise<ApiResponse<unknown>>;
     createAndPublishPost(data: {
         content: string | Record<string, string>;
@@ -62,11 +67,16 @@ export declare class OmniSocialsClient {
         media_urls?: string[] | Record<string, string[]>;
         type?: string;
         source?: string;
+        link_url?: string;
+        link_title?: string;
+        link_description?: string;
+        link_thumbnail_url?: string;
         pinterest?: Record<string, unknown>;
         youtube?: Record<string, unknown>;
         instagram?: Record<string, unknown>;
         tiktok?: Record<string, unknown>;
         x?: XPostOptions;
+        google_business?: Record<string, unknown>;
     }): Promise<ApiResponse<unknown>>;
     updatePost(id: string, data: {
         content?: string | Record<string, string>;
@@ -80,6 +90,7 @@ export declare class OmniSocialsClient {
         instagram?: Record<string, unknown>;
         tiktok?: Record<string, unknown>;
         x?: XPostOptionsUpdate;
+        google_business?: Record<string, unknown>;
     }): Promise<ApiResponse<unknown>>;
     deletePost(id: string): Promise<ApiResponse<unknown>>;
     publishPost(id: string): Promise<ApiResponse<unknown>>;

package/build/tools/accounts.js

@@ -5,7 +5,7 @@ export function registerAccountTools(server, getClient) {
         const result = await getClient().listAccounts();
         if (result.error) {
             return {
-                content: [{ type: "text", text: `Error: ${result.error.message}` }],
+                content: [{ type: "text", text: `Error (${result.error.code}): ${result.error.message}` }],
             };
         }
         const accounts = Array.isArray(result.data) ? result.data : result.data?.accounts || [];
@@ -23,8 +23,9 @@ export function registerAccountTools(server, getClient) {
             const name = a.username ? `@${a.username}` : a.display_name || "—";
             const types = (a.content_types || []).join(", ");
             const platform = capitalize(a.platform);
-            const sub = a.platform_details?.subscription_type && a.platform_details.subscription_type !== "None"
-                ? ` (${a.platform_details.subscription_type})`
+            const subType = a.platform_details?.subscription_type;
+            const sub = subType === "Premium" || subType === "PremiumPlus"
+                ? ` (${subType})`
                 : "";
             const statusCell = a.needs_reconnect
                 ? `⚠️ needs_reconnect`
@@ -66,7 +67,7 @@ export function registerAccountTools(server, getClient) {
         const result = await getClient().getAccount(id);
         if (result.error) {
             return {
-                content: [{ type: "text", text: `Error: ${result.error.message}` }],
+                content: [{ type: "text", text: `Error (${result.error.code}): ${result.error.message}` }],
             };
         }
         const a = result.data;
@@ -88,8 +89,9 @@ export function registerAccountTools(server, getClient) {
             md += `| **Reconnect reason** | ${a.reauth_reason} |\n`;
         }
         md += `| **Connected** | ${a.connected_at ? new Date(a.connected_at).toLocaleDateString() : "—"} |\n`;
-        if (a.platform_details?.subscription_type) {
-            md += `| **Subscription** | ${a.platform_details.subscription_type} |\n`;
+        const getSubType = a.platform_details?.subscription_type;
+        if (getSubType === "Premium" || getSubType === "PremiumPlus") {
+            md += `| **Subscription** | ${getSubType} |\n`;
         }
         if (a.boards?.length) {
             md += `\n### Pinterest Boards\n\n`;

package/build/tools/analytics.js

@@ -7,7 +7,7 @@ export function registerAnalyticsTools(server, getClient) {
         const result = await getClient().getPostAnalytics(post_id);
         if (result.error) {
             return {
-                content: [{ type: "text", text: `Error: ${result.error.message}` }],
+                content: [{ type: "text", text: `Error (${result.error.code}): ${result.error.message}` }],
             };
         }
         const d = result.data;
@@ -73,7 +73,7 @@ export function registerAnalyticsTools(server, getClient) {
         const result = await getClient().getAnalyticsOverview(params);
         if (result.error) {
             return {
-                content: [{ type: "text", text: `Error: ${result.error.message}` }],
+                content: [{ type: "text", text: `Error (${result.error.code}): ${result.error.message}` }],
             };
         }
         const d = result.data;
@@ -118,7 +118,7 @@ export function registerAnalyticsTools(server, getClient) {
         const result = await getClient().getAccountAnalytics(params);
         if (result.error) {
             return {
-                content: [{ type: "text", text: `Error: ${result.error.message}` }],
+                content: [{ type: "text", text: `Error (${result.error.code}): ${result.error.message}` }],
             };
         }
         const accounts = result.data || [];

package/build/tools/media.js

@@ -8,7 +8,7 @@ export function registerMediaTools(server, getClient) {
         const result = await getClient().listMedia(params);
         if (result.error) {
             return {
-                content: [{ type: "text", text: `Error: ${result.error.message}` }],
+                content: [{ type: "text", text: `Error (${result.error.code}): ${result.error.message}` }],
             };
         }
         const items = Array.isArray(result.data) ? result.data : result.data?.media || [];
@@ -75,7 +75,7 @@ When the user provides an image in the conversation (not a URL), use base64_data
         }
         if (result.error) {
             return {
-                content: [{ type: "text", text: `Error: ${result.error.message}` }],
+                content: [{ type: "text", text: `Error (${result.error.code}): ${result.error.message}` }],
             };
         }
         const m = result.data;
@@ -96,7 +96,7 @@ When the user provides an image in the conversation (not a URL), use base64_data
     }, async ({ id }) => {
         const result = await getClient().deleteMedia(id);
         return {
-            content: [{ type: "text", text: result.error ? `Error: ${result.error.message}` : "Media deleted successfully." }],
+            content: [{ type: "text", text: result.error ? `Error (${result.error.code}): ${result.error.message}` : "Media deleted successfully." }],
         };
     });
 }

package/build/tools/posts.js

@@ -61,7 +61,7 @@ export function registerPostTools(server, getClient) {
         const result = await getClient().listPosts(params);
         if (result.error) {
             return {
-                content: [{ type: "text", text: `Error: ${result.error.message}` }],
+                content: [{ type: "text", text: `Error (${result.error.code}): ${result.error.message}` }],
             };
         }
         const posts = Array.isArray(result.data) ? result.data : result.data?.posts || [];
@@ -106,7 +106,7 @@ export function registerPostTools(server, getClient) {
         const result = await getClient().getPost(id);
         if (result.error) {
             return {
-                content: [{ type: "text", text: `Error: ${result.error.message}` }],
+                content: [{ type: "text", text: `Error (${result.error.code}): ${result.error.message}` }],
             };
         }
         const p = result.data;
@@ -185,6 +185,21 @@ IMPORTANT — Before calling this tool, make sure you have all required informat
    - TikTok posts: ALWAYS require at least one image or video.
    - Pinterest posts: ALWAYS require an image AND a board_id.
    - Other platforms (LinkedIn, LinkedIn Page, X, Bluesky, etc.): Media is optional.
+
+   **Per-platform max media items (enforced at submit, returns 400 validation_error if exceeded):**
+   - Bluesky, X, Mastodon — max **4** items per post
+   - Instagram, Threads — max **10** items per carousel
+   - TikTok — max **35** photos per photo-post; cannot mix photos and videos in one post
+   - Pinterest carousel — 2–5 images, all same aspect ratio
+
+   **Per-platform video file-size caps (validated via ffprobe at schedule/publish time; drafts exempt):**
+   Mastodon **99 MB** · Bluesky **100 MB** · Instagram **300 MB** · X **512 MB** (free tier) · Threads / Reddit **1 GB** · Pinterest **2 GB** · Facebook / TikTok **4 GB** · LinkedIn **5 GB** · YouTube **256 GB**. Uploads themselves are capped at 1 GB on top.
+
+   **Per-platform video duration caps (validated via ffprobe at schedule/publish time; drafts exempt):**
+   Facebook Reel **90 s** · YouTube Short **3 min** · X **140 s** · Bluesky **180 s** · Threads **5 min** · TikTok **10 min** · LinkedIn **10 min** · Instagram Reel **15 min** · Pinterest **15 min** · Reddit **15 min** · Facebook Post **240 min** · Mastodon (instance-dependent).
+   When a cap is exceeded, the API returns \`400 { code: "validation_error", message: "<Platform> only allows videos up to <cap> — yours is <duration>. Trim the video or deselect <Platform>." }\`. If you know the video is over a platform's cap before sending, warn the user and either trim, deselect that platform, or skip publishing to it.
+
+   When attaching more than these caps to a selected platform, EITHER trim the array OR move to a flat \`media_urls: [...]\` and let the user know which platform will be over the limit so they can split into multiple posts.
 5. **Platform-specific options** (ask only when relevant):
    - **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.
@@ -210,13 +225,17 @@ Do NOT call this tool without media when creating stories, reels, Instagram post
             z.record(z.string(), z.array(z.string())),
         ]).optional().describe("External image/video URLs — flat array (same for all platforms) or object with platform keys: { default: [...], instagram: [...], pinterest: [...] }. Max 10 total. 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."),
         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."),
+        link_description: z.string().optional().describe("Optional description for the link-share preview. LinkedIn uses this when set; Facebook auto-fetches the OG description."),
+        link_thumbnail_url: z.string().optional().describe("Optional thumbnail image URL for the preview card. Reserved for future use — currently not yet applied to LinkedIn (would require uploading to LinkedIn's image API first)."),
         pinterest: z.object({
             board_id: z.string().optional().describe("Pinterest board ID. Required for Pinterest. Use get_account to list boards."),
-            title: z.string().optional().describe("Pin title (max 100 characters)"),
+            title: z.string().optional().describe("Pin title (max 100 characters). For carousel pins (2–5 images) this title applies to the whole pin, not individual slides."),
             link: z.string().optional().describe("Destination URL the pin clicks through to"),
             video_cover: z.string().optional().describe("Cover image URL for video pins (JPEG/PNG). Falls back to a video keyframe if omitted."),
             alt_text: z.string().optional().describe("Accessibility alt text for the pin image (max 500 characters)"),
-        }).optional().describe("Pinterest-specific options"),
+        }).optional().describe("Pinterest-specific options. Attach 2–5 images via media_urls.pinterest (or default) to publish a single carousel pin instead of separate pins. Carousel slides MUST share the same aspect ratio (1% tolerance) — the API returns 400 validation_error with `mismatched_slides: [n, ...]` if you pass mixed-ratio images and try to schedule or publish. Drafts are exempt so you can iterate."),
         youtube: z.object({
             title: z.string().optional().describe("Short title shown on YouTube. Falls back to \"YouTube Short\" when omitted."),
             tags: z.array(z.string()).optional(),
@@ -249,11 +268,32 @@ Do NOT call this tool without media when creating stories, reels, Instagram post
                 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."),
         }).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."),
+            cta: z.object({
+                actionType: z.enum(["LEARN_MORE", "BOOK", "ORDER", "SHOP", "SIGN_UP", "CALL"]).describe("Button rendered under the caption. Phone numbers belong on a CALL button and links on a LEARN_MORE / BOOK / SHOP button — they're rejected if placed in the caption text."),
+                url: z.string().optional().describe("Required for every actionType except CALL. Must be http:// or https://. CALL uses the location's phone number from the business profile."),
+            }).optional().describe("Optional call-to-action button."),
+            event: z.object({
+                title: z.string().max(58).describe("Event title (max 58 chars)."),
+                schedule: z.object({
+                    startDate: z.object({ year: z.number(), month: z.number(), day: z.number() }),
+                    startTime: z.object({ hours: z.number(), minutes: z.number() }).optional(),
+                    endDate: z.object({ year: z.number(), month: z.number(), day: z.number() }).optional(),
+                    endTime: z.object({ hours: z.number(), minutes: z.number() }).optional(),
+                }).optional().describe("Google's split date+time shape. startDate required; end (if present) must be ≥ start."),
+            }).optional().describe("Required when topic_type is EVENT."),
+            offer: z.object({
+                couponCode: z.string().max(58).optional(),
+                redeemOnlineUrl: z.string().optional().describe("Must be https://. http URLs are rejected."),
+                termsConditions: z.string().max(4000).optional(),
+            }).optional().describe("Required when topic_type is OFFER. Must include at least one of couponCode or redeemOnlineUrl."),
+        }).optional().describe("Google Business Profile options. Use to publish EVENT or OFFER posts, attach a CTA button, or both. Shape mirrors Google's LocalPost resource (see https://developers.google.com/my-business/reference/rest/v4/accounts.locations.localPosts#LocalPost).\n\nGoogle Business caption rules (enforced at scheduling — text that violates these will return a `validation_error` 400 before the post is saved):\n  • Phone numbers in the caption are rejected — use a CALL button instead.\n  • Inline URLs / bare domains / emails are rejected — use LEARN_MORE / BOOK / SHOP / SIGN_UP / ORDER buttons instead.\n  • Caption max 1500 characters.\n  • Media is optional (text-only posts are allowed). If attached: exactly one JPEG/PNG/WebP image (no video, no carousels).\n  • The workspace must have a Google Business location selected (Settings → Organisation → Workspaces → Google Business) before scheduling — otherwise returns a 400."),
     }, async (params) => {
         const result = await getClient().createPost({ ...params, source: "mcp" });
         if (result.error) {
             return {
-                content: [{ type: "text", text: `Error: ${result.error.message}` }],
+                content: [{ type: "text", text: `Error (${result.error.code}): ${result.error.message}` }],
             };
         }
         const p = result.data;
@@ -310,6 +350,9 @@ 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.
+   - **Max items per platform** (same caps as create_post — exceeding returns 400): Bluesky/X/Mastodon ≤4, Instagram/Threads ≤10, TikTok ≤35 photos with no photo/video mix, Pinterest carousel 2–5 same-ratio images.
+   - **Video duration caps** (same as create_post): FB Reel **90 s** · YouTube Short **3 min** · X 140 s · Bluesky 180 s · Threads 5 min · TikTok 10 min · IG Reel 15 min. Returns 400 with "<Platform> only allows videos up to <cap> — yours is <duration>" when exceeded.
+   - **Video size caps** (same as create_post): Mastodon 99 MB · Bluesky 100 MB · IG 300 MB · X 512 MB · Threads/Reddit 1 GB · Pinterest 2 GB · Facebook/TikTok 4 GB · LinkedIn 5 GB. Returns 400 with "This video (<size>) is too large for <Platform>" when exceeded.
 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.
 
@@ -327,11 +370,11 @@ Do NOT call without required media — it will fail.`, {
         type: z.enum(["post", "story", "reel"]).optional().describe("Content type: 'post' (default), 'story', 'reel'"),
         pinterest: z.object({
             board_id: z.string().optional().describe("Pinterest board ID. Required for Pinterest. Use get_account to list boards."),
-            title: z.string().optional().describe("Pin title (max 100 characters)"),
+            title: z.string().optional().describe("Pin title (max 100 characters). For carousel pins (2–5 images) this title applies to the whole pin, not individual slides."),
             link: z.string().optional().describe("Destination URL the pin clicks through to"),
             video_cover: z.string().optional().describe("Cover image URL for video pins (JPEG/PNG). Falls back to a video keyframe if omitted."),
             alt_text: z.string().optional().describe("Accessibility alt text for the pin image (max 500 characters)"),
-        }).optional().describe("Pinterest-specific options"),
+        }).optional().describe("Pinterest-specific options. Attach 2–5 images via media_urls.pinterest (or default) to publish a single carousel pin instead of separate pins. Carousel slides MUST share the same aspect ratio (1% tolerance) — the API returns 400 validation_error with `mismatched_slides: [n, ...]` if you pass mixed-ratio images and try to schedule or publish. Drafts are exempt so you can iterate."),
         youtube: z.object({
             title: z.string().optional().describe("Short title shown on YouTube."),
             tags: z.array(z.string()).optional(),
@@ -349,11 +392,32 @@ Do NOT call without required media — it will fail.`, {
                 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."),
         }).optional().describe("X (Twitter) options"),
+        google_business: z.object({
+            topic_type: z.enum(["STANDARD", "EVENT", "OFFER"]).optional(),
+            cta: z.object({
+                actionType: z.enum(["LEARN_MORE", "BOOK", "ORDER", "SHOP", "SIGN_UP", "CALL"]),
+                url: z.string().optional(),
+            }).optional(),
+            event: z.object({
+                title: z.string().max(58),
+                schedule: z.object({
+                    startDate: z.object({ year: z.number(), month: z.number(), day: z.number() }),
+                    startTime: z.object({ hours: z.number(), minutes: z.number() }).optional(),
+                    endDate: z.object({ year: z.number(), month: z.number(), day: z.number() }).optional(),
+                    endTime: z.object({ hours: z.number(), minutes: z.number() }).optional(),
+                }).optional(),
+            }).optional(),
+            offer: z.object({
+                couponCode: z.string().max(58).optional(),
+                redeemOnlineUrl: z.string().optional(),
+                termsConditions: z.string().max(4000).optional(),
+            }).optional(),
+        }).optional().describe("Google Business Profile options (STANDARD/EVENT/OFFER + optional CTA). Same shape as create_post.\n\nGoogle Business caption rules (enforced at scheduling — text that violates these returns a `validation_error` 400):\n  • No phone numbers in the caption — use a CALL button instead.\n  • No inline URLs / bare domains / emails — use LEARN_MORE / BOOK / SHOP / SIGN_UP / ORDER buttons.\n  • Caption max 1500 characters.\n  • Media is optional. If attached: exactly one JPEG/PNG/WebP image (no video, no carousels).\n  • Workspace must have a Google Business location selected before scheduling — otherwise returns a 400."),
     }, async (params) => {
         const result = await getClient().createAndPublishPost({ ...params, source: "mcp" });
         if (result.error) {
             return {
-                content: [{ type: "text", text: `Error: ${result.error.message}` }],
+                content: [{ type: "text", text: `Error (${result.error.code}): ${result.error.message}` }],
             };
         }
         const p = result.data;
@@ -408,11 +472,11 @@ Do NOT call without required media — it will fail.`, {
         }).optional().describe("YouTube Shorts options. Only applies when type is 'reel' and youtube is among the selected channels."),
         pinterest: z.object({
             board_id: z.string().optional().describe("Pinterest board ID. Required for Pinterest. Use get_account to list boards."),
-            title: z.string().optional().describe("Pin title (max 100 characters)"),
+            title: z.string().optional().describe("Pin title (max 100 characters). For carousel pins (2–5 images) this title applies to the whole pin, not individual slides."),
             link: z.string().optional().describe("Destination URL the pin clicks through to"),
             video_cover: z.string().optional().describe("Cover image URL for video pins (JPEG/PNG). Falls back to a video keyframe if omitted."),
             alt_text: z.string().optional().describe("Accessibility alt text for the pin image (max 500 characters)"),
-        }).optional().describe("Pinterest-specific options"),
+        }).optional().describe("Pinterest-specific options. Attach 2–5 images via media_urls.pinterest (or default) to publish a single carousel pin instead of separate pins. Carousel slides MUST share the same aspect ratio (1% tolerance) — the API returns 400 validation_error with `mismatched_slides: [n, ...]` if you pass mixed-ratio images and try to schedule or publish. Drafts are exempt so you can iterate."),
         instagram: z.object({
             share_to_feed: z.boolean().optional(),
             thumbnail_type: z.enum(["from-video", "from-library"]).optional(),
@@ -436,11 +500,32 @@ Do NOT call without required media — it will fail.`, {
                 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."),
         }).optional().describe("X (Twitter) options"),
+        google_business: z.object({
+            topic_type: z.enum(["STANDARD", "EVENT", "OFFER"]).optional(),
+            cta: z.object({
+                actionType: z.enum(["LEARN_MORE", "BOOK", "ORDER", "SHOP", "SIGN_UP", "CALL"]),
+                url: z.string().optional(),
+            }).optional(),
+            event: z.object({
+                title: z.string().max(58),
+                schedule: z.object({
+                    startDate: z.object({ year: z.number(), month: z.number(), day: z.number() }),
+                    startTime: z.object({ hours: z.number(), minutes: z.number() }).optional(),
+                    endDate: z.object({ year: z.number(), month: z.number(), day: z.number() }).optional(),
+                    endTime: z.object({ hours: z.number(), minutes: z.number() }).optional(),
+                }).optional(),
+            }).optional(),
+            offer: z.object({
+                couponCode: z.string().max(58).optional(),
+                redeemOnlineUrl: z.string().optional(),
+                termsConditions: z.string().max(4000).optional(),
+            }).optional(),
+        }).optional().describe("Google Business Profile options (STANDARD/EVENT/OFFER + optional CTA). Same shape as create_post.\n\nGoogle Business caption rules (enforced at scheduling — text that violates these returns a `validation_error` 400):\n  • No phone numbers in the caption — use a CALL button instead.\n  • No inline URLs / bare domains / emails — use LEARN_MORE / BOOK / SHOP / SIGN_UP / ORDER buttons.\n  • Caption max 1500 characters.\n  • Media is optional. If attached: exactly one JPEG/PNG/WebP image (no video, no carousels).\n  • Workspace must have a Google Business location selected before scheduling — otherwise returns a 400."),
     }, async ({ id, ...data }) => {
         const result = await getClient().updatePost(id, data);
         if (result.error) {
             return {
-                content: [{ type: "text", text: `Error: ${result.error.message}` }],
+                content: [{ type: "text", text: `Error (${result.error.code}): ${result.error.message}` }],
             };
         }
         const p = result.data;
@@ -464,7 +549,7 @@ Do NOT call without required media — it will fail.`, {
     }, async ({ id }) => {
         const result = await getClient().deletePost(id);
         return {
-            content: [{ type: "text", text: result.error ? `Error: ${result.error.message}` : "Post deleted successfully." }],
+            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.
@@ -475,7 +560,7 @@ IMPORTANT: Before publishing, verify the post has all required media. If publish
         const result = await getClient().publishPost(id);
         if (result.error) {
             return {
-                content: [{ type: "text", text: `Error: ${result.error.message}` }],
+                content: [{ type: "text", text: `Error (${result.error.code}): ${result.error.message}` }],
             };
         }
         const p = result.data;

package/build/tools/webhooks.js

@@ -5,7 +5,7 @@ export function registerWebhookTools(server, getClient) {
         const result = await getClient().listWebhooks();
         if (result.error) {
             return {
-                content: [{ type: "text", text: `Error: ${result.error.message}` }],
+                content: [{ type: "text", text: `Error (${result.error.code}): ${result.error.message}` }],
             };
         }
         const webhooks = Array.isArray(result.data) ? result.data : result.data?.webhooks || [];
@@ -35,7 +35,7 @@ export function registerWebhookTools(server, getClient) {
         const result = await getClient().createWebhook(params);
         if (result.error) {
             return {
-                content: [{ type: "text", text: `Error: ${result.error.message}` }],
+                content: [{ type: "text", text: `Error (${result.error.code}): ${result.error.message}` }],
             };
         }
         const w = result.data;
@@ -60,7 +60,7 @@ export function registerWebhookTools(server, getClient) {
         const result = await getClient().getWebhook(id);
         if (result.error) {
             return {
-                content: [{ type: "text", text: `Error: ${result.error.message}` }],
+                content: [{ type: "text", text: `Error (${result.error.code}): ${result.error.message}` }],
             };
         }
         const w = result.data;
@@ -87,7 +87,7 @@ export function registerWebhookTools(server, getClient) {
         const result = await getClient().updateWebhook(id, data);
         if (result.error) {
             return {
-                content: [{ type: "text", text: `Error: ${result.error.message}` }],
+                content: [{ type: "text", text: `Error (${result.error.code}): ${result.error.message}` }],
             };
         }
         const w = result.data;
@@ -107,7 +107,7 @@ export function registerWebhookTools(server, getClient) {
     }, async ({ id }) => {
         const result = await getClient().deleteWebhook(id);
         return {
-            content: [{ type: "text", text: result.error ? `Error: ${result.error.message}` : "Webhook deleted successfully." }],
+            content: [{ type: "text", text: result.error ? `Error (${result.error.code}): ${result.error.message}` : "Webhook deleted successfully." }],
         };
     });
     server.tool("rotate_webhook_secret", "Rotate the signing secret for a webhook. The new secret will only be shown once.", {
@@ -116,7 +116,7 @@ export function registerWebhookTools(server, getClient) {
         const result = await getClient().rotateWebhookSecret(id);
         if (result.error) {
             return {
-                content: [{ type: "text", text: `Error: ${result.error.message}` }],
+                content: [{ type: "text", text: `Error (${result.error.code}): ${result.error.message}` }],
             };
         }
         const w = result.data;

package/build/types.d.ts

@@ -14,6 +14,14 @@ export interface Post {
     channels: string[];
     media: string[];
     created_at: string;
+    /**
+     * Per-platform user-friendly error messages, keyed by platform identifier
+     * (facebook, instagram, linkedin, linkedin_page, youtube, tiktok, pinterest,
+     * x, threads, bluesky, mastodon, google_business). Populated when `status`
+     * is `failed` or `warning`. Only failed platforms appear. `null` while the
+     * post is still draft/scheduled/processing or every platform succeeded.
+     */
+    errors?: Record<string, string> | null;
     x?: {
         reply_settings?: string;
         paid_partnership?: boolean;

package/package.json

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