posterly-mcp-server 0.8.2 → 0.8.3

package/README.md

@@ -93,7 +93,7 @@ Add the same server definition to your Cursor MCP settings:
 
 ## Available tools
 
-`posterly-mcp-server@0.8.2` exposes 16 tools:
+`posterly-mcp-server@0.8.3` exposes 17 tools:
 
 - `whoami`
 - `list_accounts`
@@ -104,6 +104,7 @@ Add the same server definition to your Cursor MCP settings:
 - `list_posts`
 - `get_post`
 - `create_post` (supports `thread_posts: string[]` for X / Threads reply chains, plus `platform_settings` for platform-specific composer controls)
+- `create_posts_batch` (create up to 25 confirmed posts in one API request)
 - `update_post` (also accepts `platform_settings`)
 - `delete_post`
 - `upload_media`
@@ -150,11 +151,11 @@ much more reliable than forcing the agent to guess from raw account handles alon
 This package uses the Posterly API/MCP add-on:
 
 - `$3/month` add-on
-- `30 requests/hour` per API key
+- `100 create-post requests/hour` per API key, with separate media/read limits
 - user-created API keys per plan: Starter 1, Pro 2, Power User 3, Agency 4
 - works across all 11 supported platforms
 
-Each API call counts as one request, so you can still schedule multiple posts in a single request to maximize throughput.
+Each API call counts as one request, so use `create_posts_batch` when you need to schedule multiple posts in one confirmed operation.
 
 Details: [poster.ly/dashboard/api](https://www.poster.ly/dashboard/api)
 

package/dist/index.js

@@ -8,6 +8,7 @@ import { getBrandTool } from './tools/get-brand.js';
 import { listBrandAccountsTool } from './tools/list-brand-accounts.js';
 import { getBrandProfileTool } from './tools/get-brand-profile.js';
 import { createPostTool } from './tools/create-post.js';
+import { createPostsBatchTool } from './tools/create-posts-batch.js';
 import { findSlotTool } from './tools/find-slot.js';
 import { listPostsTool } from './tools/list-posts.js';
 import { uploadMediaTool } from './tools/upload-media.js';
@@ -94,6 +95,15 @@ server.tool(createPostTool.name, createPostTool.description, createPostTool.inpu
         return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
     }
 });
+server.tool(createPostsBatchTool.name, createPostsBatchTool.description, createPostsBatchTool.inputSchema.shape, async (input) => {
+    try {
+        const text = await createPostsBatchTool.execute(client, input);
+        return { content: [{ type: 'text', text }] };
+    }
+    catch (err) {
+        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+    }
+});
 server.tool(findSlotTool.name, findSlotTool.description, findSlotTool.inputSchema.shape, async (input) => {
     try {
         const text = await findSlotTool.execute(client, input);

package/dist/lib/api-client.d.ts

@@ -79,6 +79,47 @@ export interface InstagramPostSettings {
     reel_thumb_offset?: number;
 }
 export type PlatformPostSettings = Record<string, unknown>;
+export type CreatePostPayload = {
+    account_id?: string;
+    username?: string;
+    platform?: string;
+    caption: string;
+    scheduled_at?: string;
+    post_type?: string;
+    media_url?: string;
+    media_urls?: string[];
+    metadata?: Record<string, unknown>;
+    settings?: PlatformPostSettings;
+    reel_cover_url?: string;
+    reel_cover_method?: string;
+    reel_thumb_offset?: number;
+    workspace_id?: string;
+};
+export type CreatePostResponse = {
+    post: Post;
+    workspace: {
+        id: string;
+        name: string;
+        is_personal: boolean;
+        resolved_from: 'explicit' | 'account' | 'personal';
+    };
+};
+export type BatchCreatePostsResponse = {
+    posts: Array<CreatePostResponse & {
+        index: number;
+        replayed: boolean;
+    }>;
+    errors: Array<{
+        index: number;
+        status: number;
+        error: string;
+        validation_errors?: unknown;
+    }>;
+    total: number;
+    created: number;
+    replayed: number;
+    failed: number;
+};
 export interface Slot {
     time: string;
     local_time: string;
@@ -221,30 +262,10 @@ export declare class PosterlyClient {
         posts: Post[];
         total: number;
     }>;
-    createPost(data: {
-        account_id?: string;
-        username?: string;
-        platform?: string;
-        caption: string;
-        scheduled_at?: string;
-        post_type?: string;
-        media_url?: string;
-        media_urls?: string[];
-        metadata?: Record<string, unknown>;
-        settings?: PlatformPostSettings;
-        reel_cover_url?: string;
-        reel_cover_method?: string;
-        reel_thumb_offset?: number;
-        workspace_id?: string;
-    }): Promise<{
-        post: Post;
-        workspace: {
-            id: string;
-            name: string;
-            is_personal: boolean;
-            resolved_from: 'explicit' | 'account' | 'personal';
-        };
-    }>;
+    createPost(data: CreatePostPayload): Promise<CreatePostResponse>;
+    createPostsBatch(data: {
+        posts: CreatePostPayload[];
+    }): Promise<BatchCreatePostsResponse>;
     getPost(id: number): Promise<{
         post: Post;
     }>;

package/dist/lib/api-client.js

@@ -79,6 +79,9 @@ export class PosterlyClient {
     async createPost(data) {
         return this.request('POST', '/posts', data);
     }
+    async createPostsBatch(data) {
+        return this.request('POST', '/posts/batch', data);
+    }
     async getPost(id) {
         return this.request('GET', `/posts/${id}`);
     }

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

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import type { PosterlyClient } from '../lib/api-client.js';
-declare const instagramSettingsSchema: z.ZodObject<{
+export declare const instagramSettingsSchema: z.ZodObject<{
     __type: z.ZodOptional<z.ZodEnum<["instagram", "instagram-standalone"]>>;
     post_type: z.ZodOptional<z.ZodEnum<["post", "feed", "story", "reel", "carousel"]>>;
     is_trial_reel: z.ZodOptional<z.ZodBoolean>;
@@ -74,7 +74,7 @@ declare const instagramSettingsSchema: z.ZodObject<{
     reel_cover_url?: string | undefined;
     reel_thumb_offset?: number | undefined;
 }>;
-declare const platformSettingsSchema: z.ZodObject<{
+export declare const platformSettingsSchema: z.ZodObject<{
     __type: z.ZodOptional<z.ZodString>;
     post_type: z.ZodOptional<z.ZodString>;
     content_type: z.ZodOptional<z.ZodString>;
@@ -219,6 +219,399 @@ declare const platformSettingsSchema: z.ZodObject<{
     cta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     langs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, z.ZodTypeAny, "passthrough">>;
+export declare const createPostInputSchema: z.ZodObject<{
+    account_id: z.ZodOptional<z.ZodString>;
+    username: z.ZodOptional<z.ZodString>;
+    platform: z.ZodOptional<z.ZodString>;
+    caption: z.ZodOptional<z.ZodString>;
+    scheduled_at: z.ZodOptional<z.ZodString>;
+    media_url: z.ZodOptional<z.ZodString>;
+    media_urls: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    post_type: z.ZodOptional<z.ZodString>;
+    thread_posts: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    instagram_settings: z.ZodOptional<z.ZodObject<{
+        __type: z.ZodOptional<z.ZodEnum<["instagram", "instagram-standalone"]>>;
+        post_type: z.ZodOptional<z.ZodEnum<["post", "feed", "story", "reel", "carousel"]>>;
+        is_trial_reel: z.ZodOptional<z.ZodBoolean>;
+        graduation_strategy: z.ZodOptional<z.ZodEnum<["MANUAL", "SS_PERFORMANCE"]>>;
+        collaborators: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+            label: z.ZodOptional<z.ZodString>;
+            username: z.ZodOptional<z.ZodString>;
+            handle: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            label?: string | undefined;
+            username?: string | undefined;
+            handle?: string | undefined;
+        }, {
+            label?: string | undefined;
+            username?: string | undefined;
+            handle?: string | undefined;
+        }>]>, "many">>;
+        user_tags: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+            username: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            handle: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            label?: string | undefined;
+            username?: string | undefined;
+            handle?: string | undefined;
+        }, {
+            label?: string | undefined;
+            username?: string | undefined;
+            handle?: string | undefined;
+        }>]>, "many">>;
+        first_comment: z.ZodOptional<z.ZodString>;
+        media_alt_texts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        reel_cover_url: z.ZodOptional<z.ZodString>;
+        reel_thumb_offset: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        __type?: "instagram" | "instagram-standalone" | undefined;
+        post_type?: "post" | "feed" | "story" | "reel" | "carousel" | undefined;
+        is_trial_reel?: boolean | undefined;
+        graduation_strategy?: "MANUAL" | "SS_PERFORMANCE" | undefined;
+        collaborators?: (string | {
+            label?: string | undefined;
+            username?: string | undefined;
+            handle?: string | undefined;
+        })[] | undefined;
+        user_tags?: (string | {
+            label?: string | undefined;
+            username?: string | undefined;
+            handle?: string | undefined;
+        })[] | undefined;
+        first_comment?: string | undefined;
+        media_alt_texts?: Record<string, string> | undefined;
+        reel_cover_url?: string | undefined;
+        reel_thumb_offset?: number | undefined;
+    }, {
+        __type?: "instagram" | "instagram-standalone" | undefined;
+        post_type?: "post" | "feed" | "story" | "reel" | "carousel" | undefined;
+        is_trial_reel?: boolean | undefined;
+        graduation_strategy?: "MANUAL" | "SS_PERFORMANCE" | undefined;
+        collaborators?: (string | {
+            label?: string | undefined;
+            username?: string | undefined;
+            handle?: string | undefined;
+        })[] | undefined;
+        user_tags?: (string | {
+            label?: string | undefined;
+            username?: string | undefined;
+            handle?: string | undefined;
+        })[] | undefined;
+        first_comment?: string | undefined;
+        media_alt_texts?: Record<string, string> | undefined;
+        reel_cover_url?: string | undefined;
+        reel_thumb_offset?: number | undefined;
+    }>>;
+    platform_settings: z.ZodOptional<z.ZodObject<{
+        __type: z.ZodOptional<z.ZodString>;
+        post_type: z.ZodOptional<z.ZodString>;
+        content_type: z.ZodOptional<z.ZodString>;
+        media_alt_texts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        reel_cover_url: z.ZodOptional<z.ZodString>;
+        reel_thumb_offset: z.ZodOptional<z.ZodNumber>;
+        reply_settings: z.ZodOptional<z.ZodEnum<["everyone", "following", "mentionedUsers"]>>;
+        poll: z.ZodOptional<z.ZodObject<{
+            options: z.ZodArray<z.ZodString, "many">;
+            duration_minutes: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            options: string[];
+            duration_minutes?: number | undefined;
+        }, {
+            options: string[];
+            duration_minutes?: number | undefined;
+        }>>;
+        reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only"]>>;
+        text_attachment: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        text_format_preset_id: z.ZodOptional<z.ZodString>;
+        document_title: z.ZodOptional<z.ZodString>;
+        document_filename: z.ZodOptional<z.ZodString>;
+        mentions: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
+        thumbnail_url: z.ZodOptional<z.ZodString>;
+        thumbnail_method: z.ZodOptional<z.ZodString>;
+        privacy_level: z.ZodOptional<z.ZodString>;
+        allow_comment: z.ZodOptional<z.ZodBoolean>;
+        allow_duet: z.ZodOptional<z.ZodBoolean>;
+        allow_stitch: z.ZodOptional<z.ZodBoolean>;
+        title: z.ZodOptional<z.ZodString>;
+        is_commercial_content: z.ZodOptional<z.ZodBoolean>;
+        is_your_brand: z.ZodOptional<z.ZodBoolean>;
+        is_branded_content: z.ZodOptional<z.ZodBoolean>;
+        privacy_status: z.ZodOptional<z.ZodEnum<["public", "unlisted", "private"]>>;
+        made_for_kids: z.ZodOptional<z.ZodBoolean>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        category_id: z.ZodOptional<z.ZodString>;
+        playlist_id: z.ZodOptional<z.ZodString>;
+        board_id: z.ZodOptional<z.ZodString>;
+        link: z.ZodOptional<z.ZodString>;
+        cover_image_url: z.ZodOptional<z.ZodString>;
+        video_cover_url: z.ZodOptional<z.ZodString>;
+        cover_image_method: z.ZodOptional<z.ZodEnum<["upload", "frame", "api"]>>;
+        event: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        offer: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        cta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        langs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        __type: z.ZodOptional<z.ZodString>;
+        post_type: z.ZodOptional<z.ZodString>;
+        content_type: z.ZodOptional<z.ZodString>;
+        media_alt_texts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        reel_cover_url: z.ZodOptional<z.ZodString>;
+        reel_thumb_offset: z.ZodOptional<z.ZodNumber>;
+        reply_settings: z.ZodOptional<z.ZodEnum<["everyone", "following", "mentionedUsers"]>>;
+        poll: z.ZodOptional<z.ZodObject<{
+            options: z.ZodArray<z.ZodString, "many">;
+            duration_minutes: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            options: string[];
+            duration_minutes?: number | undefined;
+        }, {
+            options: string[];
+            duration_minutes?: number | undefined;
+        }>>;
+        reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only"]>>;
+        text_attachment: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        text_format_preset_id: z.ZodOptional<z.ZodString>;
+        document_title: z.ZodOptional<z.ZodString>;
+        document_filename: z.ZodOptional<z.ZodString>;
+        mentions: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
+        thumbnail_url: z.ZodOptional<z.ZodString>;
+        thumbnail_method: z.ZodOptional<z.ZodString>;
+        privacy_level: z.ZodOptional<z.ZodString>;
+        allow_comment: z.ZodOptional<z.ZodBoolean>;
+        allow_duet: z.ZodOptional<z.ZodBoolean>;
+        allow_stitch: z.ZodOptional<z.ZodBoolean>;
+        title: z.ZodOptional<z.ZodString>;
+        is_commercial_content: z.ZodOptional<z.ZodBoolean>;
+        is_your_brand: z.ZodOptional<z.ZodBoolean>;
+        is_branded_content: z.ZodOptional<z.ZodBoolean>;
+        privacy_status: z.ZodOptional<z.ZodEnum<["public", "unlisted", "private"]>>;
+        made_for_kids: z.ZodOptional<z.ZodBoolean>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        category_id: z.ZodOptional<z.ZodString>;
+        playlist_id: z.ZodOptional<z.ZodString>;
+        board_id: z.ZodOptional<z.ZodString>;
+        link: z.ZodOptional<z.ZodString>;
+        cover_image_url: z.ZodOptional<z.ZodString>;
+        video_cover_url: z.ZodOptional<z.ZodString>;
+        cover_image_method: z.ZodOptional<z.ZodEnum<["upload", "frame", "api"]>>;
+        event: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        offer: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        cta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        langs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        __type: z.ZodOptional<z.ZodString>;
+        post_type: z.ZodOptional<z.ZodString>;
+        content_type: z.ZodOptional<z.ZodString>;
+        media_alt_texts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        reel_cover_url: z.ZodOptional<z.ZodString>;
+        reel_thumb_offset: z.ZodOptional<z.ZodNumber>;
+        reply_settings: z.ZodOptional<z.ZodEnum<["everyone", "following", "mentionedUsers"]>>;
+        poll: z.ZodOptional<z.ZodObject<{
+            options: z.ZodArray<z.ZodString, "many">;
+            duration_minutes: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            options: string[];
+            duration_minutes?: number | undefined;
+        }, {
+            options: string[];
+            duration_minutes?: number | undefined;
+        }>>;
+        reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only"]>>;
+        text_attachment: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        text_format_preset_id: z.ZodOptional<z.ZodString>;
+        document_title: z.ZodOptional<z.ZodString>;
+        document_filename: z.ZodOptional<z.ZodString>;
+        mentions: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
+        thumbnail_url: z.ZodOptional<z.ZodString>;
+        thumbnail_method: z.ZodOptional<z.ZodString>;
+        privacy_level: z.ZodOptional<z.ZodString>;
+        allow_comment: z.ZodOptional<z.ZodBoolean>;
+        allow_duet: z.ZodOptional<z.ZodBoolean>;
+        allow_stitch: z.ZodOptional<z.ZodBoolean>;
+        title: z.ZodOptional<z.ZodString>;
+        is_commercial_content: z.ZodOptional<z.ZodBoolean>;
+        is_your_brand: z.ZodOptional<z.ZodBoolean>;
+        is_branded_content: z.ZodOptional<z.ZodBoolean>;
+        privacy_status: z.ZodOptional<z.ZodEnum<["public", "unlisted", "private"]>>;
+        made_for_kids: z.ZodOptional<z.ZodBoolean>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        category_id: z.ZodOptional<z.ZodString>;
+        playlist_id: z.ZodOptional<z.ZodString>;
+        board_id: z.ZodOptional<z.ZodString>;
+        link: z.ZodOptional<z.ZodString>;
+        cover_image_url: z.ZodOptional<z.ZodString>;
+        video_cover_url: z.ZodOptional<z.ZodString>;
+        cover_image_method: z.ZodOptional<z.ZodEnum<["upload", "frame", "api"]>>;
+        event: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        offer: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        cta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        langs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, z.ZodTypeAny, "passthrough">>>;
+    workspace_id: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    workspace_id?: string | undefined;
+    platform?: string | undefined;
+    account_id?: string | undefined;
+    post_type?: string | undefined;
+    username?: string | undefined;
+    caption?: string | undefined;
+    scheduled_at?: string | undefined;
+    media_url?: string | undefined;
+    media_urls?: string[] | undefined;
+    thread_posts?: string[] | undefined;
+    instagram_settings?: {
+        __type?: "instagram" | "instagram-standalone" | undefined;
+        post_type?: "post" | "feed" | "story" | "reel" | "carousel" | undefined;
+        is_trial_reel?: boolean | undefined;
+        graduation_strategy?: "MANUAL" | "SS_PERFORMANCE" | undefined;
+        collaborators?: (string | {
+            label?: string | undefined;
+            username?: string | undefined;
+            handle?: string | undefined;
+        })[] | undefined;
+        user_tags?: (string | {
+            label?: string | undefined;
+            username?: string | undefined;
+            handle?: string | undefined;
+        })[] | undefined;
+        first_comment?: string | undefined;
+        media_alt_texts?: Record<string, string> | undefined;
+        reel_cover_url?: string | undefined;
+        reel_thumb_offset?: number | undefined;
+    } | undefined;
+    platform_settings?: z.objectOutputType<{
+        __type: z.ZodOptional<z.ZodString>;
+        post_type: z.ZodOptional<z.ZodString>;
+        content_type: z.ZodOptional<z.ZodString>;
+        media_alt_texts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        reel_cover_url: z.ZodOptional<z.ZodString>;
+        reel_thumb_offset: z.ZodOptional<z.ZodNumber>;
+        reply_settings: z.ZodOptional<z.ZodEnum<["everyone", "following", "mentionedUsers"]>>;
+        poll: z.ZodOptional<z.ZodObject<{
+            options: z.ZodArray<z.ZodString, "many">;
+            duration_minutes: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            options: string[];
+            duration_minutes?: number | undefined;
+        }, {
+            options: string[];
+            duration_minutes?: number | undefined;
+        }>>;
+        reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only"]>>;
+        text_attachment: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        text_format_preset_id: z.ZodOptional<z.ZodString>;
+        document_title: z.ZodOptional<z.ZodString>;
+        document_filename: z.ZodOptional<z.ZodString>;
+        mentions: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
+        thumbnail_url: z.ZodOptional<z.ZodString>;
+        thumbnail_method: z.ZodOptional<z.ZodString>;
+        privacy_level: z.ZodOptional<z.ZodString>;
+        allow_comment: z.ZodOptional<z.ZodBoolean>;
+        allow_duet: z.ZodOptional<z.ZodBoolean>;
+        allow_stitch: z.ZodOptional<z.ZodBoolean>;
+        title: z.ZodOptional<z.ZodString>;
+        is_commercial_content: z.ZodOptional<z.ZodBoolean>;
+        is_your_brand: z.ZodOptional<z.ZodBoolean>;
+        is_branded_content: z.ZodOptional<z.ZodBoolean>;
+        privacy_status: z.ZodOptional<z.ZodEnum<["public", "unlisted", "private"]>>;
+        made_for_kids: z.ZodOptional<z.ZodBoolean>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        category_id: z.ZodOptional<z.ZodString>;
+        playlist_id: z.ZodOptional<z.ZodString>;
+        board_id: z.ZodOptional<z.ZodString>;
+        link: z.ZodOptional<z.ZodString>;
+        cover_image_url: z.ZodOptional<z.ZodString>;
+        video_cover_url: z.ZodOptional<z.ZodString>;
+        cover_image_method: z.ZodOptional<z.ZodEnum<["upload", "frame", "api"]>>;
+        event: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        offer: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        cta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        langs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, z.ZodTypeAny, "passthrough"> | undefined;
+}, {
+    workspace_id?: string | undefined;
+    platform?: string | undefined;
+    account_id?: string | undefined;
+    post_type?: string | undefined;
+    username?: string | undefined;
+    caption?: string | undefined;
+    scheduled_at?: string | undefined;
+    media_url?: string | undefined;
+    media_urls?: string[] | undefined;
+    thread_posts?: string[] | undefined;
+    instagram_settings?: {
+        __type?: "instagram" | "instagram-standalone" | undefined;
+        post_type?: "post" | "feed" | "story" | "reel" | "carousel" | undefined;
+        is_trial_reel?: boolean | undefined;
+        graduation_strategy?: "MANUAL" | "SS_PERFORMANCE" | undefined;
+        collaborators?: (string | {
+            label?: string | undefined;
+            username?: string | undefined;
+            handle?: string | undefined;
+        })[] | undefined;
+        user_tags?: (string | {
+            label?: string | undefined;
+            username?: string | undefined;
+            handle?: string | undefined;
+        })[] | undefined;
+        first_comment?: string | undefined;
+        media_alt_texts?: Record<string, string> | undefined;
+        reel_cover_url?: string | undefined;
+        reel_thumb_offset?: number | undefined;
+    } | undefined;
+    platform_settings?: z.objectInputType<{
+        __type: z.ZodOptional<z.ZodString>;
+        post_type: z.ZodOptional<z.ZodString>;
+        content_type: z.ZodOptional<z.ZodString>;
+        media_alt_texts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        reel_cover_url: z.ZodOptional<z.ZodString>;
+        reel_thumb_offset: z.ZodOptional<z.ZodNumber>;
+        reply_settings: z.ZodOptional<z.ZodEnum<["everyone", "following", "mentionedUsers"]>>;
+        poll: z.ZodOptional<z.ZodObject<{
+            options: z.ZodArray<z.ZodString, "many">;
+            duration_minutes: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            options: string[];
+            duration_minutes?: number | undefined;
+        }, {
+            options: string[];
+            duration_minutes?: number | undefined;
+        }>>;
+        reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only"]>>;
+        text_attachment: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        text_format_preset_id: z.ZodOptional<z.ZodString>;
+        document_title: z.ZodOptional<z.ZodString>;
+        document_filename: z.ZodOptional<z.ZodString>;
+        mentions: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
+        thumbnail_url: z.ZodOptional<z.ZodString>;
+        thumbnail_method: z.ZodOptional<z.ZodString>;
+        privacy_level: z.ZodOptional<z.ZodString>;
+        allow_comment: z.ZodOptional<z.ZodBoolean>;
+        allow_duet: z.ZodOptional<z.ZodBoolean>;
+        allow_stitch: z.ZodOptional<z.ZodBoolean>;
+        title: z.ZodOptional<z.ZodString>;
+        is_commercial_content: z.ZodOptional<z.ZodBoolean>;
+        is_your_brand: z.ZodOptional<z.ZodBoolean>;
+        is_branded_content: z.ZodOptional<z.ZodBoolean>;
+        privacy_status: z.ZodOptional<z.ZodEnum<["public", "unlisted", "private"]>>;
+        made_for_kids: z.ZodOptional<z.ZodBoolean>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        category_id: z.ZodOptional<z.ZodString>;
+        playlist_id: z.ZodOptional<z.ZodString>;
+        board_id: z.ZodOptional<z.ZodString>;
+        link: z.ZodOptional<z.ZodString>;
+        cover_image_url: z.ZodOptional<z.ZodString>;
+        video_cover_url: z.ZodOptional<z.ZodString>;
+        cover_image_method: z.ZodOptional<z.ZodEnum<["upload", "frame", "api"]>>;
+        event: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        offer: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        cta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        langs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, z.ZodTypeAny, "passthrough"> | undefined;
+}>;
+export type CreatePostInput = z.infer<typeof createPostInputSchema>;
+export declare function buildCreatePostPayload(input: CreatePostInput): Parameters<PosterlyClient['createPost']>[0];
 export declare const createPostTool: {
     name: string;
     description: string;
@@ -628,4 +1021,3 @@ export declare const createPostTool: {
         workspace_id?: string;
     }): Promise<string>;
 };
-export {};