posterly-mcp-server 0.19.7 → 0.19.9

package/README.md

@@ -10,10 +10,11 @@ This package gives Claude Desktop, Cursor, Windsurf, Cline, and other local MCP
 - resolve brands/clients into the right accounts
 - schedule and manage posts
 - upload media
+- generate captions
 - generate images
 - read account and post analytics
 
-Posterly also exposes the same toolset over HTTP at [poster.ly/mcp](https://www.poster.ly/mcp), but this npm package is the local `stdio` transport.
+Posterly also exposes the same authenticated toolset over HTTP at [poster.ly/mcp](https://www.poster.ly/mcp), but this npm package is the local `stdio` transport.
 
 ## Requirements
 
@@ -63,6 +64,10 @@ After paid signup is complete and Posterly shows an API key, add `POSTERLY_API_K
 5. Restart your AI client.
 6. Ask the AI to call `whoami`, then continue by connecting your first social account.
 
+The signup and connect tools return user-facing next steps by default, so agents should report progress in plain language instead of showing raw curl, HTTP payloads, or JSON. Pass `debug: true` to `start_signup`, `get_signup_session`, `get_connect_link`, `create_connect_session`, or `get_connect_session` only when troubleshooting.
+
+Post tools return `View in Posterly` dashboard links. After scheduling, listing, reading, or deleting posts, share the returned link with the user. Current-month scheduled posts open in Calendar with the post selected; broader/future post views use Table.
+
 ## Example configs
 
 ### Claude Desktop
@@ -103,7 +108,7 @@ Add the same server definition to your Cursor MCP settings:
 
 ## Available tools
 
-`posterly-mcp-server@0.19.7` exposes 54 tools.
+`posterly-mcp-server@0.19.9` exposes 55 tools.
 
 Public signup tools work before `POSTERLY_API_KEY` exists:
 
@@ -144,6 +149,7 @@ Authenticated tools require `POSTERLY_API_KEY`:
 - `upload_media_from_url`
 - `create_signed_upload`
 - `find_available_slot`
+- `generate_captions`
 - `generate_image`
 - `get_video_options`
 - `run_video_function` (read-only Veo helpers for cost estimation and request validation)
@@ -198,6 +204,7 @@ much more reliable than forcing the agent to guess from raw account handles alon
 - `Schedule this as an Instagram Story with a first comment and @partner as collaborator`
 - `Schedule this YouTube video as unlisted, add the thumbnail URL, and put it in our launch playlist`
 - `Post this TikTok with direct-post privacy set to public and stitch disabled`
+- `Schedule these 5 photos as a TikTok` (image posts auto-detect as a photo slideshow of 1 to 35 images, no post type needed)
 - `How did Grassroots perform on Instagram in the last 30 days?`
 
 ## Pricing

package/dist/generated/platform-manifest.d.ts

@@ -93,7 +93,7 @@ export declare const PLATFORM_MANIFEST: {
         readonly label: "TikTok";
         readonly status: "supported";
         readonly aliases: readonly [];
-        readonly postTypes: readonly ["video", "image"];
+        readonly postTypes: readonly ["video", "image", "carousel"];
         readonly analyticsSupported: false;
         readonly helpers: readonly ["tiktok.creator_info"];
     }, {

package/dist/generated/platform-manifest.js

@@ -279,7 +279,8 @@ export const PLATFORM_MANIFEST = {
             "aliases": [],
             "postTypes": [
                 "video",
-                "image"
+                "image",
+                "carousel"
             ],
             "analyticsSupported": false,
             "helpers": [

package/dist/index.js

@@ -24,6 +24,7 @@ import { updatePostReleaseIdTool } from './tools/update-post-release-id.js';
 import { deletePostTool } from './tools/delete-post.js';
 import { deletePostGroupTool } from './tools/delete-post-group.js';
 import { whoamiTool } from './tools/whoami.js';
+import { generateCaptionsTool } from './tools/generate-captions.js';
 import { generateImageTool } from './tools/generate-image.js';
 import { getVideoOptionsTool } from './tools/get-video-options.js';
 import { runVideoFunctionTool } from './tools/run-video-function.js';
@@ -58,7 +59,7 @@ import { updateOAuthClientTool } from './tools/update-oauth-client.js';
 import { deleteOAuthClientTool } from './tools/delete-oauth-client.js';
 const server = new McpServer({
     name: 'posterly',
-    version: '0.19.7',
+    version: '0.19.8',
 });
 const client = new PosterlyClient();
 // Register tools
@@ -341,6 +342,15 @@ server.tool(getVideoJobTool.name, getVideoJobTool.description, getVideoJobTool.i
         return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
     }
 });
+server.tool(generateCaptionsTool.name, generateCaptionsTool.description, generateCaptionsTool.inputSchema.shape, async (input) => {
+    try {
+        const text = await generateCaptionsTool.execute(client, input);
+        return { content: [{ type: 'text', text }] };
+    }
+    catch (err) {
+        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+    }
+});
 server.tool(generateImageTool.name, generateImageTool.description, generateImageTool.inputSchema.shape, async (input) => {
     try {
         const text = await generateImageTool.execute(client, input);

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

@@ -120,6 +120,35 @@ export type BatchCreatePostsResponse = {
     replayed: number;
     failed: number;
 };
+export type CaptionPlatform = 'instagram' | 'facebook' | 'tiktok' | 'twitter' | 'threads' | 'linkedin' | 'youtube' | 'pinterest' | 'google_business';
+export type GenerateCaptionsPayload = {
+    platforms: CaptionPlatform[];
+    brief?: string;
+    tone?: string;
+    allow_emojis?: boolean;
+    hashtag_strategy?: 'none' | 'smart' | 'minimal' | 'aggressive';
+    count?: number;
+    mode?: 'generate' | 'adapt';
+    source_caption?: string;
+    source_platform?: CaptionPlatform;
+    preserve_links?: boolean;
+    preserve_mentions?: boolean;
+    preserve_call_to_action?: boolean;
+    social_account_id?: string;
+    workspace_id?: string;
+    manual_brand_voice?: {
+        summary: string;
+        traits?: string[];
+        style_guidelines?: string[];
+    };
+};
+export type GenerateCaptionsResponse = {
+    success: boolean;
+    suggestions: Record<string, string[]>;
+    workspace_id?: string | null;
+    social_account_id?: number | null;
+    usage?: Record<string, unknown>;
+};
 export interface Slot {
     time: string;
     local_time: string;
@@ -552,6 +581,7 @@ export declare class PosterlyClient {
     createPostsBatch(data: {
         posts: CreatePostPayload[];
     }): Promise<BatchCreatePostsResponse>;
+    generateCaptions(data: GenerateCaptionsPayload): Promise<GenerateCaptionsResponse>;
     getPost(id: number): Promise<{
         post: Post;
     }>;

package/dist/lib/api-client.js

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

package/dist/lib/format.d.ts

@@ -1,4 +1,5 @@
 import type { Account, Post } from './api-client.js';
+type CellValue = string | number | boolean | null | undefined;
 export declare const DASHBOARD_CALENDAR_URL: string;
 export declare const DASHBOARD_TABLE_URL: string;
 export declare const DASHBOARD_CONNECT_URL: string;
@@ -9,3 +10,23 @@ export declare function dashboardUrlForPostList(posts: Array<Pick<Post, 'schedul
 export declare function truncateText(value: string | null | undefined, max?: number): string;
 export declare function formatAccountLabel(account: Account): string;
 export declare function formatConnectedAccounts(accounts?: Account[]): string;
+export declare function mdTitle(title: string, subtitle?: string): string;
+export declare function mdTable(headers: string[], rows: CellValue[][]): string;
+export declare function mdKeyValue(rows: Array<[string, CellValue]>): string;
+export declare function mdSection(title: string, body?: string): string;
+export declare function mdBullets(items: Array<string | null | undefined>): string;
+export declare function mdJson(title: string, value: unknown): string;
+export declare function mdQuote(text: string): string;
+export declare function mdEmpty(title: string, detail: string, nextStep?: string): string;
+export declare function mdSuccess(title: string, rows: Array<[string, CellValue]>, nextStep?: string): string;
+export declare function mdError(message: string): string;
+export declare function formatNumber(value: number | null | undefined): string;
+export declare function formatPercent(value: number | null | undefined): string;
+export declare function formatDelta(value: number | null | undefined): string;
+export declare function formatDateTime(value: string | null | undefined): string;
+export declare function formatDate(value: string | null | undefined): string;
+export declare function formatBytes(value: number | null | undefined): string;
+export declare function compactText(value: string | null | undefined, maxLength?: number): string;
+export declare function statusLabel(status: string | null | undefined): string;
+export declare function code(value: CellValue): string;
+export {};

package/dist/lib/format.js

@@ -40,6 +40,131 @@ export function formatConnectedAccounts(accounts) {
         return 'none yet';
     return accounts.map(formatAccountLabel).join(', ');
 }
+export function mdTitle(title, subtitle) {
+    return [`## ${title}`, subtitle ? `_${subtitle}_` : ''].filter(Boolean).join('\n');
+}
+export function mdTable(headers, rows) {
+    const visibleRows = rows.filter((row) => row.some((cell) => cell !== undefined && cell !== null && cell !== ''));
+    if (visibleRows.length === 0)
+        return '';
+    const header = `| ${headers.map(escapeCell).join(' | ')} |`;
+    const divider = `| ${headers.map(() => '---').join(' | ')} |`;
+    const body = visibleRows.map((row) => `| ${row.map((cell) => escapeCell(formatCell(cell))).join(' | ')} |`);
+    return [header, divider, ...body].join('\n');
+}
+export function mdKeyValue(rows) {
+    return mdTable(['Field', 'Value'], rows);
+}
+export function mdSection(title, body) {
+    if (!body)
+        return '';
+    return [`### ${title}`, body].join('\n');
+}
+export function mdBullets(items) {
+    return items.filter(Boolean).map((item) => `- ${item}`).join('\n');
+}
+export function mdJson(title, value) {
+    return [`### ${title}`, '```json', JSON.stringify(value, null, 2), '```'].join('\n');
+}
+export function mdQuote(text) {
+    return text.split('\n').map((line) => `> ${line}`).join('\n');
+}
+export function mdEmpty(title, detail, nextStep) {
+    return [
+        mdTitle(`No ${title}`),
+        detail,
+        nextStep ? `\n**Next step:** ${nextStep}` : '',
+    ].filter(Boolean).join('\n');
+}
+export function mdSuccess(title, rows, nextStep) {
+    return [
+        mdTitle(`✅ ${title}`),
+        mdKeyValue(rows),
+        nextStep ? `\n**Next step:** ${nextStep}` : '',
+    ].filter(Boolean).join('\n');
+}
+export function mdError(message) {
+    return [
+        mdTitle('⚠️ Posterly tool error'),
+        `**Message:** ${message}`,
+    ].join('\n');
+}
+export function formatNumber(value) {
+    return value == null ? 'n/a' : value.toLocaleString();
+}
+export function formatPercent(value) {
+    return value == null ? 'n/a' : `${value.toLocaleString()}%`;
+}
+export function formatDelta(value) {
+    if (value == null)
+        return 'n/a';
+    return value >= 0 ? `+${value.toLocaleString()}` : value.toLocaleString();
+}
+export function formatDateTime(value) {
+    if (!value)
+        return 'n/a';
+    const date = new Date(value);
+    if (Number.isNaN(date.getTime()))
+        return value;
+    return date.toLocaleString();
+}
+export function formatDate(value) {
+    if (!value)
+        return 'n/a';
+    const date = new Date(value);
+    if (Number.isNaN(date.getTime()))
+        return value;
+    return date.toLocaleDateString('en-US', { weekday: 'short', month: 'short', day: 'numeric', year: 'numeric' });
+}
+export function formatBytes(value) {
+    if (value == null)
+        return 'n/a';
+    if (value < 1024)
+        return `${value} B`;
+    const units = ['KB', 'MB', 'GB', 'TB'];
+    let size = value / 1024;
+    let unitIndex = 0;
+    while (size >= 1024 && unitIndex < units.length - 1) {
+        size /= 1024;
+        unitIndex += 1;
+    }
+    return `${size.toFixed(size >= 10 ? 0 : 1)} ${units[unitIndex]}`;
+}
+export function compactText(value, maxLength = 90) {
+    const text = String(value || '').replace(/\s+/g, ' ').trim();
+    if (!text)
+        return '';
+    return text.length > maxLength ? `${text.slice(0, Math.max(0, maxLength - 1))}…` : text;
+}
+export function statusLabel(status) {
+    const value = String(status || 'unknown').toLowerCase();
+    if (['created', 'success', 'succeeded', 'completed', 'published', 'active'].includes(value))
+        return `✅ ${status}`;
+    if (['scheduled', 'queued', 'pending', 'processing', 'opened', 'awaiting_provider', 'awaiting_credentials'].includes(value))
+        return `🕒 ${status}`;
+    if (['failed', 'error', 'inactive', 'deleted', 'cancelled', 'expired'].includes(value))
+        return `⚠️ ${status}`;
+    if (['draft', 'paused'].includes(value))
+        return `⏸️ ${status}`;
+    return status || 'unknown';
+}
+export function code(value) {
+    return `\`${formatCell(value).replace(/`/g, '\\`')}\``;
+}
+function formatCell(value) {
+    if (value === null || value === undefined || value === '')
+        return 'n/a';
+    if (typeof value === 'boolean')
+        return value ? 'yes' : 'no';
+    if (typeof value === 'number')
+        return value.toLocaleString();
+    return String(value);
+}
+function escapeCell(value) {
+    return formatCell(value)
+        .replace(/\|/g, '\\|')
+        .replace(/\r?\n/g, '<br>');
+}
 function isInCurrentMonth(value) {
     if (!value)
         return false;

package/dist/tools/create-connect-session.d.ts

@@ -9,12 +9,12 @@ export declare const createConnectSessionTool: {
         auto_start: z.ZodOptional<z.ZodBoolean>;
         debug: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
-        platform: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "linkedin" | "youtube" | "pinterest" | "threads" | "google_business" | "telegram" | "bluesky" | "reddit" | "wordpress" | "mastodon" | "medium" | "devto" | "hashnode" | "discord" | "slack" | "skool" | "whop" | "gmb" | "google-business" | "google_business_profile" | "x" | "meta" | "linkedin_page" | "facebook_instagram" | "facebook_pages" | "instagram_direct" | "linkedin-company" | "linkedin-page" | "linkedin_company" | "linkedin_personal" | "meta_business" | "x_twitter";
+        platform: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "telegram" | "bluesky" | "reddit" | "wordpress" | "mastodon" | "medium" | "devto" | "hashnode" | "discord" | "slack" | "skool" | "whop" | "gmb" | "google-business" | "google_business_profile" | "x" | "meta" | "linkedin_page" | "facebook_instagram" | "facebook_pages" | "instagram_direct" | "linkedin-company" | "linkedin-page" | "linkedin_company" | "linkedin_personal" | "meta_business" | "x_twitter";
         workspace_id?: string | undefined;
         auto_start?: boolean | undefined;
         debug?: boolean | undefined;
     }, {
-        platform: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "linkedin" | "youtube" | "pinterest" | "threads" | "google_business" | "telegram" | "bluesky" | "reddit" | "wordpress" | "mastodon" | "medium" | "devto" | "hashnode" | "discord" | "slack" | "skool" | "whop" | "gmb" | "google-business" | "google_business_profile" | "x" | "meta" | "linkedin_page" | "facebook_instagram" | "facebook_pages" | "instagram_direct" | "linkedin-company" | "linkedin-page" | "linkedin_company" | "linkedin_personal" | "meta_business" | "x_twitter";
+        platform: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "telegram" | "bluesky" | "reddit" | "wordpress" | "mastodon" | "medium" | "devto" | "hashnode" | "discord" | "slack" | "skool" | "whop" | "gmb" | "google-business" | "google_business_profile" | "x" | "meta" | "linkedin_page" | "facebook_instagram" | "facebook_pages" | "instagram_direct" | "linkedin-company" | "linkedin-page" | "linkedin_company" | "linkedin_personal" | "meta_business" | "x_twitter";
         workspace_id?: string | undefined;
         auto_start?: boolean | undefined;
         debug?: boolean | undefined;

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

@@ -105,6 +105,7 @@ export declare const platformSettingsSchema: z.ZodObject<{
     allow_duet: z.ZodOptional<z.ZodBoolean>;
     allow_stitch: z.ZodOptional<z.ZodBoolean>;
     title: z.ZodOptional<z.ZodString>;
+    media_type: 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>;
@@ -153,6 +154,7 @@ export declare const platformSettingsSchema: z.ZodObject<{
     allow_duet: z.ZodOptional<z.ZodBoolean>;
     allow_stitch: z.ZodOptional<z.ZodBoolean>;
     title: z.ZodOptional<z.ZodString>;
+    media_type: 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>;
@@ -201,6 +203,7 @@ export declare const platformSettingsSchema: z.ZodObject<{
     allow_duet: z.ZodOptional<z.ZodBoolean>;
     allow_stitch: z.ZodOptional<z.ZodBoolean>;
     title: z.ZodOptional<z.ZodString>;
+    media_type: 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>;
@@ -334,6 +337,7 @@ export declare const createPostInputSchema: z.ZodObject<{
         allow_duet: z.ZodOptional<z.ZodBoolean>;
         allow_stitch: z.ZodOptional<z.ZodBoolean>;
         title: z.ZodOptional<z.ZodString>;
+        media_type: 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>;
@@ -382,6 +386,7 @@ export declare const createPostInputSchema: z.ZodObject<{
         allow_duet: z.ZodOptional<z.ZodBoolean>;
         allow_stitch: z.ZodOptional<z.ZodBoolean>;
         title: z.ZodOptional<z.ZodString>;
+        media_type: 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>;
@@ -430,6 +435,7 @@ export declare const createPostInputSchema: z.ZodObject<{
         allow_duet: z.ZodOptional<z.ZodBoolean>;
         allow_stitch: z.ZodOptional<z.ZodBoolean>;
         title: z.ZodOptional<z.ZodString>;
+        media_type: 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>;
@@ -451,7 +457,7 @@ export declare const createPostInputSchema: z.ZodObject<{
     workspace_id: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     workspace_id?: string | undefined;
-    platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "linkedin" | "youtube" | "pinterest" | "threads" | "google_business" | "telegram" | "bluesky" | "gmb" | "google-business" | "google_business_profile" | "x" | undefined;
+    platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "telegram" | "bluesky" | "gmb" | "google-business" | "google_business_profile" | "x" | undefined;
     account_id?: string | undefined;
     scheduled_at?: string | undefined;
     media_url?: string | undefined;
@@ -511,6 +517,7 @@ export declare const createPostInputSchema: z.ZodObject<{
         allow_duet: z.ZodOptional<z.ZodBoolean>;
         allow_stitch: z.ZodOptional<z.ZodBoolean>;
         title: z.ZodOptional<z.ZodString>;
+        media_type: 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>;
@@ -531,7 +538,7 @@ export declare const createPostInputSchema: z.ZodObject<{
     }, z.ZodTypeAny, "passthrough"> | undefined;
 }, {
     workspace_id?: string | undefined;
-    platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "linkedin" | "youtube" | "pinterest" | "threads" | "google_business" | "telegram" | "bluesky" | "gmb" | "google-business" | "google_business_profile" | "x" | undefined;
+    platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "telegram" | "bluesky" | "gmb" | "google-business" | "google_business_profile" | "x" | undefined;
     account_id?: string | undefined;
     scheduled_at?: string | undefined;
     media_url?: string | undefined;
@@ -591,6 +598,7 @@ export declare const createPostInputSchema: z.ZodObject<{
         allow_duet: z.ZodOptional<z.ZodBoolean>;
         allow_stitch: z.ZodOptional<z.ZodBoolean>;
         title: z.ZodOptional<z.ZodString>;
+        media_type: 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>;
@@ -730,6 +738,7 @@ export declare const createPostTool: {
             allow_duet: z.ZodOptional<z.ZodBoolean>;
             allow_stitch: z.ZodOptional<z.ZodBoolean>;
             title: z.ZodOptional<z.ZodString>;
+            media_type: 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>;
@@ -778,6 +787,7 @@ export declare const createPostTool: {
             allow_duet: z.ZodOptional<z.ZodBoolean>;
             allow_stitch: z.ZodOptional<z.ZodBoolean>;
             title: z.ZodOptional<z.ZodString>;
+            media_type: 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>;
@@ -826,6 +836,7 @@ export declare const createPostTool: {
             allow_duet: z.ZodOptional<z.ZodBoolean>;
             allow_stitch: z.ZodOptional<z.ZodBoolean>;
             title: z.ZodOptional<z.ZodString>;
+            media_type: 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>;
@@ -847,7 +858,7 @@ export declare const createPostTool: {
         workspace_id: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         workspace_id?: string | undefined;
-        platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "linkedin" | "youtube" | "pinterest" | "threads" | "google_business" | "telegram" | "bluesky" | "gmb" | "google-business" | "google_business_profile" | "x" | undefined;
+        platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "telegram" | "bluesky" | "gmb" | "google-business" | "google_business_profile" | "x" | undefined;
         account_id?: string | undefined;
         scheduled_at?: string | undefined;
         media_url?: string | undefined;
@@ -907,6 +918,7 @@ export declare const createPostTool: {
             allow_duet: z.ZodOptional<z.ZodBoolean>;
             allow_stitch: z.ZodOptional<z.ZodBoolean>;
             title: z.ZodOptional<z.ZodString>;
+            media_type: 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>;
@@ -927,7 +939,7 @@ export declare const createPostTool: {
         }, z.ZodTypeAny, "passthrough"> | undefined;
     }, {
         workspace_id?: string | undefined;
-        platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "linkedin" | "youtube" | "pinterest" | "threads" | "google_business" | "telegram" | "bluesky" | "gmb" | "google-business" | "google_business_profile" | "x" | undefined;
+        platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "telegram" | "bluesky" | "gmb" | "google-business" | "google_business_profile" | "x" | undefined;
         account_id?: string | undefined;
         scheduled_at?: string | undefined;
         media_url?: string | undefined;
@@ -987,6 +999,7 @@ export declare const createPostTool: {
             allow_duet: z.ZodOptional<z.ZodBoolean>;
             allow_stitch: z.ZodOptional<z.ZodBoolean>;
             title: z.ZodOptional<z.ZodString>;
+            media_type: 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>;

package/dist/tools/create-post.js

@@ -47,6 +47,7 @@ export const platformSettingsSchema = z.object({
     allow_duet: z.boolean().optional(),
     allow_stitch: z.boolean().optional(),
     title: z.string().optional(),
+    media_type: z.string().optional(), // TikTok: 'PHOTO' forces a photo slideshow; image media is auto-detected when omitted
     is_commercial_content: z.boolean().optional(),
     is_your_brand: z.boolean().optional(),
     is_branded_content: z.boolean().optional(),
@@ -85,11 +86,11 @@ export const createPostInputSchema = z.object({
     media_urls: z
         .array(z.string())
         .optional()
-        .describe('Multiple media URLs for carousel posts'),
+        .describe('Multiple media URLs for carousel or multi-image posts. For TikTok, 2 or more images auto-create a photo slideshow (up to 35 images) and every image is posted.'),
     post_type: z
         .string()
         .optional()
-        .describe('Post type: text, image, video, carousel, reel, story. Auto-set to x_thread/threads_thread when `thread_posts` is provided.'),
+        .describe('Post type: text, image, video, carousel, reel, story. Auto-set to x_thread/threads_thread when `thread_posts` is provided. For TikTok you can omit it: image media auto-detects as a photo slideshow (use "carousel" for 2 or more images, or "image" for one), while a single video posts as a video.'),
     thread_posts: z
         .array(z.string())
         .optional()
@@ -153,7 +154,8 @@ export const createPostTool = {
         'AFTER CALLING: Tell the user the post was created, include the Posterly dashboard link returned by the tool, and offer the next natural action. Do not narrate raw HTTP, curl, or API plumbing.\n\n' +
         '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' +
         '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' +
-        'PLATFORM SETTINGS: Pass `platform_settings` for composer-equivalent controls: Facebook story/reel/backgrounds, YouTube title/privacy/thumbnail/playlist, LinkedIn document titles/mentions/video thumbnails, TikTok direct-post privacy/toggles/commercial disclosure, Pinterest post_type (image/video/carousel), board (from pinterest.boards helper), title, link, and cover_image_url (video Pins), GBP event/offer/CTA, X reply settings/polls, Threads reply controls/text attachments, Bluesky languages/alt text, and Instagram feed/story/reel/carousel/collaborators/first comments/trial Reels. `instagram_settings` remains as a backwards-compatible alias.',
+        'PLATFORM SETTINGS: Pass `platform_settings` for composer-equivalent controls: Facebook story/reel/backgrounds, YouTube title/privacy/thumbnail/playlist, LinkedIn document titles/mentions/video thumbnails, TikTok direct-post privacy/toggles/commercial disclosure, Pinterest post_type (image/video/carousel), board (from pinterest.boards helper), title, link, and cover_image_url (video Pins), GBP event/offer/CTA, X reply settings/polls, Threads reply controls/text attachments, Bluesky languages/alt text, and Instagram feed/story/reel/carousel/collaborators/first comments/trial Reels. `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,
     async execute(client, input) {
         const payload = buildCreatePostPayload(input);

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

@@ -120,6 +120,7 @@ export declare const createPostsBatchTool: {
                 allow_duet: z.ZodOptional<z.ZodBoolean>;
                 allow_stitch: z.ZodOptional<z.ZodBoolean>;
                 title: z.ZodOptional<z.ZodString>;
+                media_type: 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>;
@@ -168,6 +169,7 @@ export declare const createPostsBatchTool: {
                 allow_duet: z.ZodOptional<z.ZodBoolean>;
                 allow_stitch: z.ZodOptional<z.ZodBoolean>;
                 title: z.ZodOptional<z.ZodString>;
+                media_type: 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>;
@@ -216,6 +218,7 @@ export declare const createPostsBatchTool: {
                 allow_duet: z.ZodOptional<z.ZodBoolean>;
                 allow_stitch: z.ZodOptional<z.ZodBoolean>;
                 title: z.ZodOptional<z.ZodString>;
+                media_type: 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>;
@@ -237,7 +240,7 @@ export declare const createPostsBatchTool: {
             workspace_id: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
             workspace_id?: string | undefined;
-            platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "linkedin" | "youtube" | "pinterest" | "threads" | "google_business" | "telegram" | "bluesky" | "gmb" | "google-business" | "google_business_profile" | "x" | undefined;
+            platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "telegram" | "bluesky" | "gmb" | "google-business" | "google_business_profile" | "x" | undefined;
             account_id?: string | undefined;
             scheduled_at?: string | undefined;
             media_url?: string | undefined;
@@ -297,6 +300,7 @@ export declare const createPostsBatchTool: {
                 allow_duet: z.ZodOptional<z.ZodBoolean>;
                 allow_stitch: z.ZodOptional<z.ZodBoolean>;
                 title: z.ZodOptional<z.ZodString>;
+                media_type: 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>;
@@ -317,7 +321,7 @@ export declare const createPostsBatchTool: {
             }, z.ZodTypeAny, "passthrough"> | undefined;
         }, {
             workspace_id?: string | undefined;
-            platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "linkedin" | "youtube" | "pinterest" | "threads" | "google_business" | "telegram" | "bluesky" | "gmb" | "google-business" | "google_business_profile" | "x" | undefined;
+            platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "telegram" | "bluesky" | "gmb" | "google-business" | "google_business_profile" | "x" | undefined;
             account_id?: string | undefined;
             scheduled_at?: string | undefined;
             media_url?: string | undefined;
@@ -377,6 +381,7 @@ export declare const createPostsBatchTool: {
                 allow_duet: z.ZodOptional<z.ZodBoolean>;
                 allow_stitch: z.ZodOptional<z.ZodBoolean>;
                 title: z.ZodOptional<z.ZodString>;
+                media_type: 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>;
@@ -399,7 +404,7 @@ export declare const createPostsBatchTool: {
     }, "strip", z.ZodTypeAny, {
         posts: {
             workspace_id?: string | undefined;
-            platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "linkedin" | "youtube" | "pinterest" | "threads" | "google_business" | "telegram" | "bluesky" | "gmb" | "google-business" | "google_business_profile" | "x" | undefined;
+            platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "telegram" | "bluesky" | "gmb" | "google-business" | "google_business_profile" | "x" | undefined;
             account_id?: string | undefined;
             scheduled_at?: string | undefined;
             media_url?: string | undefined;
@@ -459,6 +464,7 @@ export declare const createPostsBatchTool: {
                 allow_duet: z.ZodOptional<z.ZodBoolean>;
                 allow_stitch: z.ZodOptional<z.ZodBoolean>;
                 title: z.ZodOptional<z.ZodString>;
+                media_type: 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>;
@@ -481,7 +487,7 @@ export declare const createPostsBatchTool: {
     }, {
         posts: {
             workspace_id?: string | undefined;
-            platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "linkedin" | "youtube" | "pinterest" | "threads" | "google_business" | "telegram" | "bluesky" | "gmb" | "google-business" | "google_business_profile" | "x" | undefined;
+            platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "telegram" | "bluesky" | "gmb" | "google-business" | "google_business_profile" | "x" | undefined;
             account_id?: string | undefined;
             scheduled_at?: string | undefined;
             media_url?: string | undefined;
@@ -541,6 +547,7 @@ export declare const createPostsBatchTool: {
                 allow_duet: z.ZodOptional<z.ZodBoolean>;
                 allow_stitch: z.ZodOptional<z.ZodBoolean>;
                 title: z.ZodOptional<z.ZodString>;
+                media_type: 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>;

package/dist/tools/find-slot.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { formatDate, mdEmpty, mdTable, mdTitle } from '../lib/format.js';
 export const findSlotTool = {
     name: 'find_available_slot',
     description: 'Find available time slots for posting. Respects a 1-hour gap between posts and preferred hours (8am–10pm in the given timezone). Returns up to 10 slots. IMPORTANT: pass a timezone explicitly — default is America/New_York and slots will be off if the user is elsewhere. Pass workspace_id to only avoid collisions with posts in that workspace.',
@@ -25,9 +26,15 @@ export const findSlotTool = {
     async execute(client, input) {
         const slots = await client.findAvailableSlots(input);
         if (slots.length === 0) {
-            return 'No available slots found in the next 14 days.';
+            return mdEmpty('available slots', 'No available posting slots were found in the next 14 days.');
         }
-        const lines = slots.map((s, i) => `${i + 1}. ${s.local_time} — ${new Date(s.time).toLocaleDateString('en-US', { weekday: 'short', month: 'short', day: 'numeric' })}`);
-        return `Available posting slots:\n${lines.join('\n')}`;
+        return [
+            mdTitle(`Available posting slots (${slots.length})`),
+            mdTable(['Option', 'Local time', 'Date'], slots.map((slot, index) => [
+                index + 1,
+                slot.local_time,
+                formatDate(slot.time),
+            ])),
+        ].join('\n\n');
     },
 };