posterly-mcp-server 0.50.4 → 0.51.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Grassroots Marketing LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -25,7 +25,7 @@ Posterly also exposes the same authenticated toolset over HTTP at [poster.ly/mcp
 - Agent reference: `https://www.poster.ly/llms-full.txt`
 - Signup and API-key acquisition: `https://www.poster.ly/agents/signup`
 - Smithery: `https://smithery.ai/servers/awpthorp/posterly`
-- Source: `https://github.com/awpthorp/posterly/tree/main/mcp-server`
+- Source: `https://github.com/awpthorp/posterly-mcp-server`
 
 The official MCP Registry metadata is in `server.json`. Its canonical registry
 name is `io.github.awpthorp/posterly`, matching this package's `mcpName`.
@@ -123,7 +123,7 @@ Add the same server definition to your Cursor MCP settings:
 
 ## Available tools
 
-`posterly-mcp-server@0.50.4` exposes 64 tools covering 100 actions. The hosted HTTP endpoint exposes the same catalog minus the three signup tools: 61 tools covering 97 actions.
+`posterly-mcp-server@0.51.0` exposes 64 tools covering 100 actions. The hosted HTTP endpoint exposes the same catalog minus the three signup tools: 61 tools covering 97 actions.
 
 Many tools pick what to do with one parameter: `view` (reads), `action` (writes), or `type`. A few pick their mode from which parameters you pass (for example `update_post` with `status` changes the status instead of editing). Every tool description names all of its views and actions.
 

package/dist/lib/version.d.ts

@@ -1 +1 @@
-export declare const POSTERLY_MCP_VERSION = "0.50.4";
+export declare const POSTERLY_MCP_VERSION = "0.51.0";

package/dist/lib/version.js

@@ -5,4 +5,4 @@
 // tool set (minus the intentional pre-auth signup tools that only this stdio
 // package exposes). `npm run check:mcp-parity` enforces both the version match
 // and the tool-list match, and runs in the pre-commit hook.
-export const POSTERLY_MCP_VERSION = '0.50.4';
+export const POSTERLY_MCP_VERSION = '0.51.0';

package/dist/tools/create-post.d.ts

@@ -265,6 +265,16 @@ export declare const platformSettingsSchema: z.ZodObject<{
         question?: string | undefined;
         allows_multiple_answers?: boolean | undefined;
     }>>;
+    article: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        title: z.ZodString;
+        cover: z.ZodOptional<z.ZodEnum<["first_image", "none"]>>;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        cover?: "none" | "first_image" | undefined;
+    }, {
+        title: string;
+        cover?: "none" | "first_image" | undefined;
+    }>>>;
     reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only", "followers_only", "parent_post_author_only"]>>;
     topic_tag: z.ZodOptional<z.ZodString>;
     share_to_instagram: z.ZodOptional<z.ZodBoolean>;
@@ -404,6 +414,16 @@ export declare const platformSettingsSchema: z.ZodObject<{
         question?: string | undefined;
         allows_multiple_answers?: boolean | undefined;
     }>>;
+    article: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        title: z.ZodString;
+        cover: z.ZodOptional<z.ZodEnum<["first_image", "none"]>>;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        cover?: "none" | "first_image" | undefined;
+    }, {
+        title: string;
+        cover?: "none" | "first_image" | undefined;
+    }>>>;
     reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only", "followers_only", "parent_post_author_only"]>>;
     topic_tag: z.ZodOptional<z.ZodString>;
     share_to_instagram: z.ZodOptional<z.ZodBoolean>;
@@ -543,6 +563,16 @@ export declare const platformSettingsSchema: z.ZodObject<{
         question?: string | undefined;
         allows_multiple_answers?: boolean | undefined;
     }>>;
+    article: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        title: z.ZodString;
+        cover: z.ZodOptional<z.ZodEnum<["first_image", "none"]>>;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        cover?: "none" | "first_image" | undefined;
+    }, {
+        title: string;
+        cover?: "none" | "first_image" | undefined;
+    }>>>;
     reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only", "followers_only", "parent_post_author_only"]>>;
     topic_tag: z.ZodOptional<z.ZodString>;
     share_to_instagram: z.ZodOptional<z.ZodBoolean>;
@@ -915,6 +945,16 @@ export declare const createPostPayloadInputSchema: z.ZodObject<{
             question?: string | undefined;
             allows_multiple_answers?: boolean | undefined;
         }>>;
+        article: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            title: z.ZodString;
+            cover: z.ZodOptional<z.ZodEnum<["first_image", "none"]>>;
+        }, "strip", z.ZodTypeAny, {
+            title: string;
+            cover?: "none" | "first_image" | undefined;
+        }, {
+            title: string;
+            cover?: "none" | "first_image" | undefined;
+        }>>>;
         reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only", "followers_only", "parent_post_author_only"]>>;
         topic_tag: z.ZodOptional<z.ZodString>;
         share_to_instagram: z.ZodOptional<z.ZodBoolean>;
@@ -1054,6 +1094,16 @@ export declare const createPostPayloadInputSchema: z.ZodObject<{
             question?: string | undefined;
             allows_multiple_answers?: boolean | undefined;
         }>>;
+        article: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            title: z.ZodString;
+            cover: z.ZodOptional<z.ZodEnum<["first_image", "none"]>>;
+        }, "strip", z.ZodTypeAny, {
+            title: string;
+            cover?: "none" | "first_image" | undefined;
+        }, {
+            title: string;
+            cover?: "none" | "first_image" | undefined;
+        }>>>;
         reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only", "followers_only", "parent_post_author_only"]>>;
         topic_tag: z.ZodOptional<z.ZodString>;
         share_to_instagram: z.ZodOptional<z.ZodBoolean>;
@@ -1193,6 +1243,16 @@ export declare const createPostPayloadInputSchema: z.ZodObject<{
             question?: string | undefined;
             allows_multiple_answers?: boolean | undefined;
         }>>;
+        article: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            title: z.ZodString;
+            cover: z.ZodOptional<z.ZodEnum<["first_image", "none"]>>;
+        }, "strip", z.ZodTypeAny, {
+            title: string;
+            cover?: "none" | "first_image" | undefined;
+        }, {
+            title: string;
+            cover?: "none" | "first_image" | undefined;
+        }>>>;
         reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only", "followers_only", "parent_post_author_only"]>>;
         topic_tag: z.ZodOptional<z.ZodString>;
         share_to_instagram: z.ZodOptional<z.ZodBoolean>;
@@ -1395,6 +1455,16 @@ export declare const createPostPayloadInputSchema: z.ZodObject<{
             question?: string | undefined;
             allows_multiple_answers?: boolean | undefined;
         }>>;
+        article: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            title: z.ZodString;
+            cover: z.ZodOptional<z.ZodEnum<["first_image", "none"]>>;
+        }, "strip", z.ZodTypeAny, {
+            title: string;
+            cover?: "none" | "first_image" | undefined;
+        }, {
+            title: string;
+            cover?: "none" | "first_image" | undefined;
+        }>>>;
         reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only", "followers_only", "parent_post_author_only"]>>;
         topic_tag: z.ZodOptional<z.ZodString>;
         share_to_instagram: z.ZodOptional<z.ZodBoolean>;
@@ -1596,6 +1666,16 @@ export declare const createPostPayloadInputSchema: z.ZodObject<{
             question?: string | undefined;
             allows_multiple_answers?: boolean | undefined;
         }>>;
+        article: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            title: z.ZodString;
+            cover: z.ZodOptional<z.ZodEnum<["first_image", "none"]>>;
+        }, "strip", z.ZodTypeAny, {
+            title: string;
+            cover?: "none" | "first_image" | undefined;
+        }, {
+            title: string;
+            cover?: "none" | "first_image" | undefined;
+        }>>>;
         reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only", "followers_only", "parent_post_author_only"]>>;
         topic_tag: z.ZodOptional<z.ZodString>;
         share_to_instagram: z.ZodOptional<z.ZodBoolean>;
@@ -1969,6 +2049,16 @@ export declare const createPostInputSchema: z.ZodObject<{
             question?: string | undefined;
             allows_multiple_answers?: boolean | undefined;
         }>>;
+        article: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            title: z.ZodString;
+            cover: z.ZodOptional<z.ZodEnum<["first_image", "none"]>>;
+        }, "strip", z.ZodTypeAny, {
+            title: string;
+            cover?: "none" | "first_image" | undefined;
+        }, {
+            title: string;
+            cover?: "none" | "first_image" | undefined;
+        }>>>;
         reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only", "followers_only", "parent_post_author_only"]>>;
         topic_tag: z.ZodOptional<z.ZodString>;
         share_to_instagram: z.ZodOptional<z.ZodBoolean>;
@@ -2108,6 +2198,16 @@ export declare const createPostInputSchema: z.ZodObject<{
             question?: string | undefined;
             allows_multiple_answers?: boolean | undefined;
         }>>;
+        article: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            title: z.ZodString;
+            cover: z.ZodOptional<z.ZodEnum<["first_image", "none"]>>;
+        }, "strip", z.ZodTypeAny, {
+            title: string;
+            cover?: "none" | "first_image" | undefined;
+        }, {
+            title: string;
+            cover?: "none" | "first_image" | undefined;
+        }>>>;
         reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only", "followers_only", "parent_post_author_only"]>>;
         topic_tag: z.ZodOptional<z.ZodString>;
         share_to_instagram: z.ZodOptional<z.ZodBoolean>;
@@ -2247,6 +2347,16 @@ export declare const createPostInputSchema: z.ZodObject<{
             question?: string | undefined;
             allows_multiple_answers?: boolean | undefined;
         }>>;
+        article: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            title: z.ZodString;
+            cover: z.ZodOptional<z.ZodEnum<["first_image", "none"]>>;
+        }, "strip", z.ZodTypeAny, {
+            title: string;
+            cover?: "none" | "first_image" | undefined;
+        }, {
+            title: string;
+            cover?: "none" | "first_image" | undefined;
+        }>>>;
         reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only", "followers_only", "parent_post_author_only"]>>;
         topic_tag: z.ZodOptional<z.ZodString>;
         share_to_instagram: z.ZodOptional<z.ZodBoolean>;
@@ -2452,6 +2562,16 @@ export declare const createPostInputSchema: z.ZodObject<{
             question?: string | undefined;
             allows_multiple_answers?: boolean | undefined;
         }>>;
+        article: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            title: z.ZodString;
+            cover: z.ZodOptional<z.ZodEnum<["first_image", "none"]>>;
+        }, "strip", z.ZodTypeAny, {
+            title: string;
+            cover?: "none" | "first_image" | undefined;
+        }, {
+            title: string;
+            cover?: "none" | "first_image" | undefined;
+        }>>>;
         reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only", "followers_only", "parent_post_author_only"]>>;
         topic_tag: z.ZodOptional<z.ZodString>;
         share_to_instagram: z.ZodOptional<z.ZodBoolean>;
@@ -2654,6 +2774,16 @@ export declare const createPostInputSchema: z.ZodObject<{
             question?: string | undefined;
             allows_multiple_answers?: boolean | undefined;
         }>>;
+        article: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            title: z.ZodString;
+            cover: z.ZodOptional<z.ZodEnum<["first_image", "none"]>>;
+        }, "strip", z.ZodTypeAny, {
+            title: string;
+            cover?: "none" | "first_image" | undefined;
+        }, {
+            title: string;
+            cover?: "none" | "first_image" | undefined;
+        }>>>;
         reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only", "followers_only", "parent_post_author_only"]>>;
         topic_tag: z.ZodOptional<z.ZodString>;
         share_to_instagram: z.ZodOptional<z.ZodBoolean>;
@@ -3056,6 +3186,16 @@ export declare const createPostTool: {
                 question?: string | undefined;
                 allows_multiple_answers?: boolean | undefined;
             }>>;
+            article: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                title: z.ZodString;
+                cover: z.ZodOptional<z.ZodEnum<["first_image", "none"]>>;
+            }, "strip", z.ZodTypeAny, {
+                title: string;
+                cover?: "none" | "first_image" | undefined;
+            }, {
+                title: string;
+                cover?: "none" | "first_image" | undefined;
+            }>>>;
             reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only", "followers_only", "parent_post_author_only"]>>;
             topic_tag: z.ZodOptional<z.ZodString>;
             share_to_instagram: z.ZodOptional<z.ZodBoolean>;
@@ -3195,6 +3335,16 @@ export declare const createPostTool: {
                 question?: string | undefined;
                 allows_multiple_answers?: boolean | undefined;
             }>>;
+            article: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                title: z.ZodString;
+                cover: z.ZodOptional<z.ZodEnum<["first_image", "none"]>>;
+            }, "strip", z.ZodTypeAny, {
+                title: string;
+                cover?: "none" | "first_image" | undefined;
+            }, {
+                title: string;
+                cover?: "none" | "first_image" | undefined;
+            }>>>;
             reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only", "followers_only", "parent_post_author_only"]>>;
             topic_tag: z.ZodOptional<z.ZodString>;
             share_to_instagram: z.ZodOptional<z.ZodBoolean>;
@@ -3334,6 +3484,16 @@ export declare const createPostTool: {
                 question?: string | undefined;
                 allows_multiple_answers?: boolean | undefined;
             }>>;
+            article: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                title: z.ZodString;
+                cover: z.ZodOptional<z.ZodEnum<["first_image", "none"]>>;
+            }, "strip", z.ZodTypeAny, {
+                title: string;
+                cover?: "none" | "first_image" | undefined;
+            }, {
+                title: string;
+                cover?: "none" | "first_image" | undefined;
+            }>>>;
             reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only", "followers_only", "parent_post_author_only"]>>;
             topic_tag: z.ZodOptional<z.ZodString>;
             share_to_instagram: z.ZodOptional<z.ZodBoolean>;
@@ -3539,6 +3699,16 @@ export declare const createPostTool: {
                 question?: string | undefined;
                 allows_multiple_answers?: boolean | undefined;
             }>>;
+            article: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                title: z.ZodString;
+                cover: z.ZodOptional<z.ZodEnum<["first_image", "none"]>>;
+            }, "strip", z.ZodTypeAny, {
+                title: string;
+                cover?: "none" | "first_image" | undefined;
+            }, {
+                title: string;
+                cover?: "none" | "first_image" | undefined;
+            }>>>;
             reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only", "followers_only", "parent_post_author_only"]>>;
             topic_tag: z.ZodOptional<z.ZodString>;
             share_to_instagram: z.ZodOptional<z.ZodBoolean>;
@@ -3741,6 +3911,16 @@ export declare const createPostTool: {
                 question?: string | undefined;
                 allows_multiple_answers?: boolean | undefined;
             }>>;
+            article: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                title: z.ZodString;
+                cover: z.ZodOptional<z.ZodEnum<["first_image", "none"]>>;
+            }, "strip", z.ZodTypeAny, {
+                title: string;
+                cover?: "none" | "first_image" | undefined;
+            }, {
+                title: string;
+                cover?: "none" | "first_image" | undefined;
+            }>>>;
             reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only", "followers_only", "parent_post_author_only"]>>;
             topic_tag: z.ZodOptional<z.ZodString>;
             share_to_instagram: z.ZodOptional<z.ZodBoolean>;

package/dist/tools/create-post.js

@@ -71,6 +71,10 @@ export const platformSettingsSchema = z.object({
         duration: z.enum(['ONE_DAY', 'THREE_DAYS', 'SEVEN_DAYS', 'FOURTEEN_DAYS']).optional(), // LinkedIn poll length
         allows_multiple_answers: z.boolean().optional(), // Telegram poll: allow multiple selections
     }).optional(),
+    article: z.object({
+        title: z.string(), // X Article title (required)
+        cover: z.enum(['first_image', 'none']).optional(), // Use the first attached image as the cover (default) or none
+    }).nullable().optional(), // X Article (needs X Premium): the caption is the Markdown body. null turns Article mode off
     // Threads
     reply_control: z.enum(['everyone', 'accounts_you_follow', 'mentioned_only', 'followers_only', 'parent_post_author_only']).optional(),
     topic_tag: z.string().optional(), // Threads single discovery topic tag
@@ -322,6 +326,7 @@ export const createPostTool = {
         'Provide either account_id OR username+platform to identify the account. If scheduled_at is omitted, the post publishes immediately. If workspace_id is omitted, the server resolves one from the social account, falling back to the caller\'s default (personal) workspace - pass workspace_id explicitly if the user has more than one workspace.\n\n' +
         'MEDIA URLS: Posterly storage URLs are used as-is. Third-party HTTP(S) media URLs are copied into posterly storage before the post is saved, so API-created posts do not later fail on expired signed URLs. Short-lived signed URLs must still be live when this tool runs. You can also call `upload_media` with `url` first if you want to upload once and reuse the returned posterly URL across posts.\n\n' +
         'THREADS: Pass `thread_posts` (an array of 2+ strings) to schedule a multi-post thread on X (Twitter) or Threads (Meta). The first entry is the lead post; the rest are published as replies in the same chain. X entries are capped at 280 characters each (4000 for verified, 25000 for organization accounts); Threads entries are capped at 500 characters each. When `thread_posts` is set, `caption` is ignored.\n\n' +
+        'X ARTICLES: To publish on X as a long-form Article, pass `platform_settings.article` ({ title, cover?: "first_image" | "none" }) for an X account. The caption becomes the Article body and is written as Markdown (headings, bold, italic, lists, quotes, code blocks, tables, dividers). Reference attached images with `![caption](media:1)`. Needs an X Premium account; polls, threads, paid partnership, video, and GIFs are not allowed with an Article.\n\n' +
         'PLATFORM SETTINGS: Pass `platform_settings` for composer-equivalent controls: Facebook story/reel/backgrounds, YouTube title/privacy/thumbnail/brandPartner, LinkedIn document titles/mentions/polls/content_call_to_action_label (including BUY_NOW and SHOP_NOW), TikTok direct-post privacy/toggles/commercial disclosure, Pinterest board/title/link/product_tags, GBP event/offer/CTA/recurrence, X reply settings/polls/paid_partnership, Threads reply controls/text attachments/ghost posts/spoilers/reply approvals/GIPHY, Telegram polls/buttons/video cover/live photo, Slack markdown/blocks, Mastodon visibility/quote/poll (media+poll allowed), and Instagram feed/story/reel/carousel/native media tags/collaborators/first comments/trial Reels/is_ai_generated/audio_id/caption add-ons. Instagram caption add-ons (`caption_addon`, or `poll_attachment` / `is_comment_prompt_used`) need a Facebook Login account, a non-empty caption, and a feed photo, Reel, or carousel parent. Stories are rejected. A poll and a comment prompt cannot be combined. For Instagram, @username in caption is only a caption mention; `user_tags` creates native media tags and `collaborators` sends co-author invitations only when the selected Meta-linked account reports those capabilities. Call `list_platforms` with `view: "schema"` and the account ID first. `instagram_settings` remains as a backwards-compatible alias.\n\n' +
         'TIKTOK MEDIA: TikTok supports a single video or a photo slideshow of 1 to 35 images, never multiple videos. Image media auto-detects as a slideshow, so you usually do not set post_type or media_type for photos and every image is posted. Pass `platform_settings.media_type: "PHOTO"` to force a slideshow explicitly.',
     inputSchema: createPostInputSchema,

package/dist/tools/create-posts-batch.d.ts

@@ -280,6 +280,16 @@ export declare const createPostsBatchTool: {
                     question?: string | undefined;
                     allows_multiple_answers?: boolean | undefined;
                 }>>;
+                article: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                    title: z.ZodString;
+                    cover: z.ZodOptional<z.ZodEnum<["first_image", "none"]>>;
+                }, "strip", z.ZodTypeAny, {
+                    title: string;
+                    cover?: "none" | "first_image" | undefined;
+                }, {
+                    title: string;
+                    cover?: "none" | "first_image" | undefined;
+                }>>>;
                 reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only", "followers_only", "parent_post_author_only"]>>;
                 topic_tag: z.ZodOptional<z.ZodString>;
                 share_to_instagram: z.ZodOptional<z.ZodBoolean>;
@@ -419,6 +429,16 @@ export declare const createPostsBatchTool: {
                     question?: string | undefined;
                     allows_multiple_answers?: boolean | undefined;
                 }>>;
+                article: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                    title: z.ZodString;
+                    cover: z.ZodOptional<z.ZodEnum<["first_image", "none"]>>;
+                }, "strip", z.ZodTypeAny, {
+                    title: string;
+                    cover?: "none" | "first_image" | undefined;
+                }, {
+                    title: string;
+                    cover?: "none" | "first_image" | undefined;
+                }>>>;
                 reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only", "followers_only", "parent_post_author_only"]>>;
                 topic_tag: z.ZodOptional<z.ZodString>;
                 share_to_instagram: z.ZodOptional<z.ZodBoolean>;
@@ -558,6 +578,16 @@ export declare const createPostsBatchTool: {
                     question?: string | undefined;
                     allows_multiple_answers?: boolean | undefined;
                 }>>;
+                article: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                    title: z.ZodString;
+                    cover: z.ZodOptional<z.ZodEnum<["first_image", "none"]>>;
+                }, "strip", z.ZodTypeAny, {
+                    title: string;
+                    cover?: "none" | "first_image" | undefined;
+                }, {
+                    title: string;
+                    cover?: "none" | "first_image" | undefined;
+                }>>>;
                 reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only", "followers_only", "parent_post_author_only"]>>;
                 topic_tag: z.ZodOptional<z.ZodString>;
                 share_to_instagram: z.ZodOptional<z.ZodBoolean>;
@@ -760,6 +790,16 @@ export declare const createPostsBatchTool: {
                     question?: string | undefined;
                     allows_multiple_answers?: boolean | undefined;
                 }>>;
+                article: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                    title: z.ZodString;
+                    cover: z.ZodOptional<z.ZodEnum<["first_image", "none"]>>;
+                }, "strip", z.ZodTypeAny, {
+                    title: string;
+                    cover?: "none" | "first_image" | undefined;
+                }, {
+                    title: string;
+                    cover?: "none" | "first_image" | undefined;
+                }>>>;
                 reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only", "followers_only", "parent_post_author_only"]>>;
                 topic_tag: z.ZodOptional<z.ZodString>;
                 share_to_instagram: z.ZodOptional<z.ZodBoolean>;
@@ -961,6 +1001,16 @@ export declare const createPostsBatchTool: {
                     question?: string | undefined;
                     allows_multiple_answers?: boolean | undefined;
                 }>>;
+                article: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                    title: z.ZodString;
+                    cover: z.ZodOptional<z.ZodEnum<["first_image", "none"]>>;
+                }, "strip", z.ZodTypeAny, {
+                    title: string;
+                    cover?: "none" | "first_image" | undefined;
+                }, {
+                    title: string;
+                    cover?: "none" | "first_image" | undefined;
+                }>>>;
                 reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only", "followers_only", "parent_post_author_only"]>>;
                 topic_tag: z.ZodOptional<z.ZodString>;
                 share_to_instagram: z.ZodOptional<z.ZodBoolean>;
@@ -1166,6 +1216,16 @@ export declare const createPostsBatchTool: {
                     question?: string | undefined;
                     allows_multiple_answers?: boolean | undefined;
                 }>>;
+                article: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                    title: z.ZodString;
+                    cover: z.ZodOptional<z.ZodEnum<["first_image", "none"]>>;
+                }, "strip", z.ZodTypeAny, {
+                    title: string;
+                    cover?: "none" | "first_image" | undefined;
+                }, {
+                    title: string;
+                    cover?: "none" | "first_image" | undefined;
+                }>>>;
                 reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only", "followers_only", "parent_post_author_only"]>>;
                 topic_tag: z.ZodOptional<z.ZodString>;
                 share_to_instagram: z.ZodOptional<z.ZodBoolean>;
@@ -1370,6 +1430,16 @@ export declare const createPostsBatchTool: {
                     question?: string | undefined;
                     allows_multiple_answers?: boolean | undefined;
                 }>>;
+                article: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                    title: z.ZodString;
+                    cover: z.ZodOptional<z.ZodEnum<["first_image", "none"]>>;
+                }, "strip", z.ZodTypeAny, {
+                    title: string;
+                    cover?: "none" | "first_image" | undefined;
+                }, {
+                    title: string;
+                    cover?: "none" | "first_image" | undefined;
+                }>>>;
                 reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only", "followers_only", "parent_post_author_only"]>>;
                 topic_tag: z.ZodOptional<z.ZodString>;
                 share_to_instagram: z.ZodOptional<z.ZodBoolean>;

package/dist/tools/manage-google-business-media.js

@@ -40,7 +40,7 @@ export const manageGoogleBusinessMediaTool = {
         workspace_id: z.string().optional().describe('Filter to a workspace ID from whoami.'),
         account_id: z.number().int().positive().optional().describe('Google Business account ID from list_accounts.'),
         location_id: z.string().optional().describe(LOCATION_ID_DESCRIPTION),
-        source_url: z.string().url().optional().describe('add: public https URL of the photo or video (from upload_media).'),
+        source_url: z.string().url().optional().describe('add: public https URL of the photo or video (from upload_media). Photos must be JPG or PNG, 10 KB to 5 MB.'),
         category: z.enum(CATEGORIES).optional().describe('add: which gallery category to add the media to.'),
         media_format: z.enum(['PHOTO', 'VIDEO']).optional().describe('add: defaults to PHOTO. Use VIDEO for videos (Google caps profile videos at 30s / 75MB).'),
         media_name: z.string().min(1).optional().describe('delete: full media resource name from list_google_business_media (accounts/.../locations/.../media/...).'),

package/dist/tools/update-post.d.ts

@@ -270,6 +270,16 @@ declare const platformSettingsSchema: z.ZodObject<{
         question?: string | undefined;
         allows_multiple_answers?: boolean | undefined;
     }>>;
+    article: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        title: z.ZodString;
+        cover: z.ZodOptional<z.ZodEnum<["first_image", "none"]>>;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        cover?: "none" | "first_image" | undefined;
+    }, {
+        title: string;
+        cover?: "none" | "first_image" | undefined;
+    }>>>;
     reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only", "followers_only", "parent_post_author_only"]>>;
     topic_tag: z.ZodOptional<z.ZodString>;
     share_to_instagram: z.ZodOptional<z.ZodBoolean>;
@@ -409,6 +419,16 @@ declare const platformSettingsSchema: z.ZodObject<{
         question?: string | undefined;
         allows_multiple_answers?: boolean | undefined;
     }>>;
+    article: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        title: z.ZodString;
+        cover: z.ZodOptional<z.ZodEnum<["first_image", "none"]>>;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        cover?: "none" | "first_image" | undefined;
+    }, {
+        title: string;
+        cover?: "none" | "first_image" | undefined;
+    }>>>;
     reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only", "followers_only", "parent_post_author_only"]>>;
     topic_tag: z.ZodOptional<z.ZodString>;
     share_to_instagram: z.ZodOptional<z.ZodBoolean>;
@@ -548,6 +568,16 @@ declare const platformSettingsSchema: z.ZodObject<{
         question?: string | undefined;
         allows_multiple_answers?: boolean | undefined;
     }>>;
+    article: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        title: z.ZodString;
+        cover: z.ZodOptional<z.ZodEnum<["first_image", "none"]>>;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        cover?: "none" | "first_image" | undefined;
+    }, {
+        title: string;
+        cover?: "none" | "first_image" | undefined;
+    }>>>;
     reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only", "followers_only", "parent_post_author_only"]>>;
     topic_tag: z.ZodOptional<z.ZodString>;
     share_to_instagram: z.ZodOptional<z.ZodBoolean>;
@@ -945,6 +975,16 @@ export declare const updatePostTool: {
                 question?: string | undefined;
                 allows_multiple_answers?: boolean | undefined;
             }>>;
+            article: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                title: z.ZodString;
+                cover: z.ZodOptional<z.ZodEnum<["first_image", "none"]>>;
+            }, "strip", z.ZodTypeAny, {
+                title: string;
+                cover?: "none" | "first_image" | undefined;
+            }, {
+                title: string;
+                cover?: "none" | "first_image" | undefined;
+            }>>>;
             reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only", "followers_only", "parent_post_author_only"]>>;
             topic_tag: z.ZodOptional<z.ZodString>;
             share_to_instagram: z.ZodOptional<z.ZodBoolean>;
@@ -1084,6 +1124,16 @@ export declare const updatePostTool: {
                 question?: string | undefined;
                 allows_multiple_answers?: boolean | undefined;
             }>>;
+            article: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                title: z.ZodString;
+                cover: z.ZodOptional<z.ZodEnum<["first_image", "none"]>>;
+            }, "strip", z.ZodTypeAny, {
+                title: string;
+                cover?: "none" | "first_image" | undefined;
+            }, {
+                title: string;
+                cover?: "none" | "first_image" | undefined;
+            }>>>;
             reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only", "followers_only", "parent_post_author_only"]>>;
             topic_tag: z.ZodOptional<z.ZodString>;
             share_to_instagram: z.ZodOptional<z.ZodBoolean>;
@@ -1223,6 +1273,16 @@ export declare const updatePostTool: {
                 question?: string | undefined;
                 allows_multiple_answers?: boolean | undefined;
             }>>;
+            article: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                title: z.ZodString;
+                cover: z.ZodOptional<z.ZodEnum<["first_image", "none"]>>;
+            }, "strip", z.ZodTypeAny, {
+                title: string;
+                cover?: "none" | "first_image" | undefined;
+            }, {
+                title: string;
+                cover?: "none" | "first_image" | undefined;
+            }>>>;
             reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only", "followers_only", "parent_post_author_only"]>>;
             topic_tag: z.ZodOptional<z.ZodString>;
             share_to_instagram: z.ZodOptional<z.ZodBoolean>;
@@ -1433,6 +1493,16 @@ export declare const updatePostTool: {
                 question?: string | undefined;
                 allows_multiple_answers?: boolean | undefined;
             }>>;
+            article: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                title: z.ZodString;
+                cover: z.ZodOptional<z.ZodEnum<["first_image", "none"]>>;
+            }, "strip", z.ZodTypeAny, {
+                title: string;
+                cover?: "none" | "first_image" | undefined;
+            }, {
+                title: string;
+                cover?: "none" | "first_image" | undefined;
+            }>>>;
             reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only", "followers_only", "parent_post_author_only"]>>;
             topic_tag: z.ZodOptional<z.ZodString>;
             share_to_instagram: z.ZodOptional<z.ZodBoolean>;
@@ -1641,6 +1711,16 @@ export declare const updatePostTool: {
                 question?: string | undefined;
                 allows_multiple_answers?: boolean | undefined;
             }>>;
+            article: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                title: z.ZodString;
+                cover: z.ZodOptional<z.ZodEnum<["first_image", "none"]>>;
+            }, "strip", z.ZodTypeAny, {
+                title: string;
+                cover?: "none" | "first_image" | undefined;
+            }, {
+                title: string;
+                cover?: "none" | "first_image" | undefined;
+            }>>>;
             reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only", "followers_only", "parent_post_author_only"]>>;
             topic_tag: z.ZodOptional<z.ZodString>;
             share_to_instagram: z.ZodOptional<z.ZodBoolean>;

package/dist/tools/update-post.js

@@ -66,6 +66,7 @@ const platformSettingsSchema = z.object({
     reel_thumb_offset: z.number().nonnegative().optional(),
     reply_settings: z.enum(['everyone', 'following', 'mentionedUsers', 'subscribers', 'verified']).optional(),
     poll: z.object({ options: z.array(z.string()), duration_minutes: z.number().positive().optional(), question: z.string().optional(), duration: z.enum(['ONE_DAY', 'THREE_DAYS', 'SEVEN_DAYS', 'FOURTEEN_DAYS']).optional(), allows_multiple_answers: z.boolean().optional() }).optional(),
+    article: z.object({ title: z.string(), cover: z.enum(['first_image', 'none']).optional() }).nullable().optional(),
     reply_control: z.enum(['everyone', 'accounts_you_follow', 'mentioned_only', 'followers_only', 'parent_post_author_only']).optional(),
     topic_tag: z.string().optional(),
     share_to_instagram: z.boolean().optional(), // Threads: also share the published post to the linked Instagram account as a Story