posterly-mcp-server 0.47.0 → 0.48.0

package/src/lib/api-client.ts

@@ -228,6 +228,23 @@ export interface InstagramPostSettings {
   media_accessibility?: Array<{ index: number; asset_id?: string; source_url?: string; alt_text: string }>;
   reel_cover_url?: string;
   reel_thumb_offset?: number;
+  is_ai_generated?: boolean;
+  audio_id?: string;
+  caption_addon?: {
+    type?: 'none' | 'poll' | 'comment_prompt';
+    kind?: 'none' | 'poll' | 'comment_prompt';
+    options?: string[];
+    extended_duration?: boolean;
+  } | null;
+  poll_attachment?: {
+    option_a?: string;
+    option_b?: string;
+    option_c?: string;
+    option_d?: string;
+    options?: string[];
+  };
+  is_comment_prompt_used?: boolean;
+  is_poll_duration_extended?: boolean;
 }
 
 export type PlatformPostSettings = Record<string, unknown>;
@@ -1619,9 +1636,12 @@ export class PosterlyClient {
 
   async deletePost(
     id: number,
-    options?: { confirmPublished?: boolean },
+    options?: { confirmPublished?: boolean; deleteMode?: 'posterly' | 'platform' },
   ): Promise<{ deleted: boolean; id: number; platform_delete?: string }> {
-    const qs = options?.confirmPublished ? '?confirm_published=true' : '';
+    const params = new URLSearchParams();
+    if (options?.confirmPublished) params.set('confirm_published', 'true');
+    if (options?.deleteMode) params.set('delete_mode', options.deleteMode);
+    const qs = params.size ? `?${params}` : '';
     return this.request('DELETE', `/posts/${id}${qs}`);
   }
 

package/src/lib/version.ts

@@ -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.47.0';
+export const POSTERLY_MCP_VERSION = '0.48.0';

package/src/tools/create-post.ts

@@ -31,6 +31,31 @@ export const instagramSettingsSchema = z.object({
   reel_thumb_offset: z.number().nonnegative().optional(),
   is_ai_generated: z.boolean().optional().describe('Label the parent Instagram media container as AI-generated. For carousels, set on the parent only.'),
   audio_id: z.string().optional().describe('Licensed Instagram audio ID for Reels. Meta-linked Facebook Login accounts only.'),
+  caption_addon: z.union([
+    z.object({
+      type: z.enum(['none', 'poll', 'comment_prompt']).optional(),
+      kind: z.enum(['none', 'poll', 'comment_prompt']).optional(),
+      options: z.array(z.string()).max(4).optional(),
+      extended_duration: z.boolean().optional(),
+      poll_attachment: z.object({
+        option_a: z.string().optional(),
+        option_b: z.string().optional(),
+        option_c: z.string().optional(),
+        option_d: z.string().optional(),
+        options: z.array(z.string()).max(4).optional(),
+      }).optional(),
+    }),
+    z.null(),
+  ]).optional().describe('Optional Instagram caption add-on. type is none, poll, or comment_prompt. A poll needs 2 to 4 options of 1 to 25 characters (an emoji counts as one) and the caption is the question. A comment prompt uses the caption as the prompt. Facebook Login only. Not available on Stories. At most one add-on per post. Pass null or type none to clear it.'),
+  poll_attachment: z.object({
+    option_a: z.string().optional(),
+    option_b: z.string().optional(),
+    option_c: z.string().optional(),
+    option_d: z.string().optional(),
+    options: z.array(z.string()).max(4).optional(),
+  }).optional().describe('Instagram poll choices. option_a and option_b are required, option_c and option_d are optional, and option_d requires option_c. Mutually exclusive with a comment prompt. The caption is the question. Serialised JSON must be 200 characters or fewer.'),
+  is_comment_prompt_used: z.boolean().optional().describe('Set true to attach an Instagram comment prompt. The caption is the prompt. Mutually exclusive with a poll. Facebook Login only. Not available on Stories.'),
+  is_poll_duration_extended: z.boolean().optional().describe('Set true only together with a poll, to request the longer Instagram poll duration.'),
 });
 
 export const platformSettingsSchema = z.object({
@@ -124,6 +149,17 @@ export const platformSettingsSchema = z.object({
   paid_partnership: z.boolean().optional(), // X paid partnership
   is_ai_generated: z.boolean().optional(),
   audio_id: z.string().optional(),
+  caption_addon: z.union([
+    z.object({
+      type: z.enum(['none', 'poll', 'comment_prompt']).optional(),
+      options: z.array(z.string()).max(4).optional(),
+      extended_duration: z.boolean().optional(),
+    }),
+    z.null(),
+  ]).optional(),
+  poll_attachment: z.record(z.string(), z.unknown()).optional(),
+  is_comment_prompt_used: z.boolean().optional(),
+  is_poll_duration_extended: z.boolean().optional(),
   // tags (z.array of strings) also serve as Bluesky hidden discovery tags
   // AI-content disclosure (TikTok is_aigc, X made_with_ai, YouTube containsSyntheticMedia, Pinterest ai_disclosures)
   ai_generated: z.boolean().optional(),
@@ -314,7 +350,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' +
-    '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. 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' +
+    '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,
 
@@ -363,6 +399,16 @@ export const createPostTool = {
     if (instagram_settings?.first_comment) {
       lines.push('• Instagram first comment: yes');
     }
+    const captionAddonType = instagram_settings?.caption_addon && typeof instagram_settings.caption_addon === 'object'
+      ? instagram_settings.caption_addon.type || instagram_settings.caption_addon.kind
+      : null;
+    if (captionAddonType && captionAddonType !== 'none') {
+      lines.push(`• Instagram caption add-on: ${captionAddonType}`);
+    } else if (instagram_settings?.is_comment_prompt_used) {
+      lines.push('• Instagram caption add-on: comment_prompt');
+    } else if (instagram_settings?.poll_attachment) {
+      lines.push('• Instagram caption add-on: poll');
+    }
     if (platform_settings) {
       lines.push('• Platform settings: yes');
     }

package/src/tools/delete-post.ts

@@ -6,6 +6,7 @@ import { previewThenConfirm, validateArgs, type ToolContext } from '../lib/tool-
 type DeletePostInput = {
   post_id?: number;
   group_id?: string;
+  delete_mode?: 'posterly' | 'platform';
   confirm_published?: boolean;
   confirm?: boolean;
   preview_id?: string;
@@ -14,14 +15,15 @@ type DeletePostInput = {
 export const deletePostTool = {
   name: 'delete_post',
   description:
-    'Delete posts. DESTRUCTIVE and IRREVERSIBLE: deleted posts and captions cannot be recovered. post_id: delete one post; fetch it with `get_post` first, show the user what will be deleted (caption, account, scheduled time), and pass confirm=true only after explicit confirmation ("yes delete it", "remove it"). A post that is currently publishing is never deleted. A published post is taken down only when the user also explicitly confirms the live removal and you pass confirm_published=true. Instagram and Facebook are attempted when the stored id and token allow it. Every other platform, or a live URL with no id, returns platform_delete_unsupported and the posterly row is kept. A published post with no live URL and no platform id is removed from posterly only. group_id: delete every draft, scheduled, failed, or paused post matching a caller-defined group_id, post_group_id, api_group_id, or release_id. A group delete never removes published posts. Preview then confirm: call without confirm to get a preview and preview_id, show it, then call again with confirm=true and that preview_id. Never delete several posts one by one without listing each and confirming the full list.',
+    'Delete posts. DESTRUCTIVE and IRREVERSIBLE: deleted posts and captions cannot be recovered. post_id: delete one post; fetch it with `get_post` first, show the user what will be deleted (caption, account, scheduled time), and pass confirm=true only after explicit confirmation ("yes delete it", "remove it"). A post that is currently publishing is never deleted. A published post is taken down only when the user also explicitly confirms the live removal and you pass confirm_published=true. Choose delete_mode=posterly to remove only the posterly record and leave the live post up, or delete_mode=platform with confirm_published=true to take down the live post too. Live deletion supports eligible connected platforms with saved post IDs and deletion permissions; refusals keep the record. Threads requires threads_delete. YouTube requires youtube.force-ssl or equivalent, upload alone is insufficient. A published post with no live URL and no platform id is removed from posterly only. group_id: delete every draft, scheduled, failed, or paused post matching a caller-defined group_id, post_group_id, api_group_id, or release_id. A group delete never removes published posts. Preview then confirm: call without confirm to get a preview and preview_id, show it, then call again with confirm=true and that preview_id. Never delete several posts one by one without listing each and confirming the full list.',
   inputSchema: z.object({
     post_id: z.number().optional().describe('Delete this one post.'),
     group_id: z.string().min(1).max(160).optional().describe('Delete every unpublished post in this group or release instead. Never deletes published posts.'),
+    delete_mode: z.enum(['posterly', 'platform']).optional().describe('posterly removes only the record; platform also takes down live content and requires confirm_published=true.'),
     confirm_published: z
       .boolean()
       .optional()
-      .describe('With post_id only. True only after the user explicitly confirms taking a live Instagram or Facebook post down. Without it, a published post is refused and kept.'),
+      .describe('With post_id only. True only after the user explicitly confirms taking a live post down. Required with delete_mode=platform. Use delete_mode=posterly to leave the live post up.'),
     confirm: z
       .boolean()
       .optional()
@@ -58,24 +60,27 @@ export const deletePostTool = {
         },
       });
     }
-    return deleteOne(client, args as { post_id: number; confirm?: boolean; confirm_published?: boolean });
+    return deleteOne(client, args as { post_id: number; confirm?: boolean; confirm_published?: boolean; delete_mode?: 'posterly' | 'platform' });
   },
 };
 
 async function deleteOne(
   client: PosterlyClient,
-  input: { post_id: number; confirm?: boolean; confirm_published?: boolean },
+  input: { post_id: number; confirm?: boolean; confirm_published?: boolean; delete_mode?: 'posterly' | 'platform' },
 ): Promise<string> {
   if (input.confirm !== true) {
     throw new Error('Refusing to delete post without confirm=true after explicit user confirmation.');
   }
-  const result = await client.deletePost(input.post_id, { confirmPublished: input.confirm_published === true });
-  const platformDelete = result.platform_delete ? ` Platform delete: ${result.platform_delete}.` : '';
+  const result = await client.deletePost(input.post_id, { confirmPublished: input.confirm_published === true, deleteMode: input.delete_mode });
+  const platformDelete = result.platform_delete === 'deleted' ? ' The platform confirmed removal of the live content.'
+    : result.platform_delete === 'not_requested' ? ' Only the posterly record was removed; no platform deletion was requested.'
+    : result.platform_delete === 'no_live_target' ? ' Only the posterly record was removed because no live target was saved.'
+    : '';
   return [
     `Post #${result.id} deleted successfully.${platformDelete}`,
     'It has been removed from the posterly queue.',
     `View queue in posterly: ${dashboardUrlForPosts()}`,
     '',
-    'Next step for the AI agent: tell the user the post is gone and offer to create, reschedule, or review the next post.',
+    'Tell the user whether the live post was deleted or kept on the platform.',
   ].join('\n');
 }

package/src/tools/update-post.ts

@@ -32,6 +32,31 @@ const instagramSettingsSchema = z.object({
   reel_thumb_offset: z.number().nonnegative().optional(),
   is_ai_generated: z.boolean().optional().describe('Label the parent Instagram media container as AI-generated. For carousels, set on the parent only.'),
   audio_id: z.string().optional().describe('Licensed Instagram audio ID for Reels. Meta-linked Facebook Login accounts only.'),
+  caption_addon: z.union([
+    z.object({
+      type: z.enum(['none', 'poll', 'comment_prompt']).optional(),
+      kind: z.enum(['none', 'poll', 'comment_prompt']).optional(),
+      options: z.array(z.string()).max(4).optional(),
+      extended_duration: z.boolean().optional(),
+      poll_attachment: z.object({
+        option_a: z.string().optional(),
+        option_b: z.string().optional(),
+        option_c: z.string().optional(),
+        option_d: z.string().optional(),
+        options: z.array(z.string()).max(4).optional(),
+      }).optional(),
+    }),
+    z.null(),
+  ]).optional().describe('Optional Instagram caption add-on. type is none, poll, or comment_prompt. A poll needs 2 to 4 options of 1 to 25 characters (an emoji counts as one) and the caption is the question. A comment prompt uses the caption as the prompt. Facebook Login only. Not available on Stories. At most one add-on per post. Pass null or type none to clear it.'),
+  poll_attachment: z.object({
+    option_a: z.string().optional(),
+    option_b: z.string().optional(),
+    option_c: z.string().optional(),
+    option_d: z.string().optional(),
+    options: z.array(z.string()).max(4).optional(),
+  }).optional().describe('Instagram poll choices. option_a and option_b are required, option_c and option_d are optional, and option_d requires option_c. Mutually exclusive with a comment prompt. The caption is the question. Serialised JSON must be 200 characters or fewer.'),
+  is_comment_prompt_used: z.boolean().optional().describe('Set true to attach an Instagram comment prompt. The caption is the prompt. Mutually exclusive with a poll. Facebook Login only. Not available on Stories.'),
+  is_poll_duration_extended: z.boolean().optional().describe('Set true only together with a poll, to request the longer Instagram poll duration.'),
 });
 
 const platformSettingsSchema = z.object({
@@ -108,6 +133,17 @@ const platformSettingsSchema = z.object({
   paid_partnership: z.boolean().optional(),
   is_ai_generated: z.boolean().optional(),
   audio_id: z.string().optional(),
+  caption_addon: z.union([
+    z.object({
+      type: z.enum(['none', 'poll', 'comment_prompt']).optional(),
+      options: z.array(z.string()).max(4).optional(),
+      extended_duration: z.boolean().optional(),
+    }),
+    z.null(),
+  ]).optional(),
+  poll_attachment: z.record(z.string(), z.unknown()).optional(),
+  is_comment_prompt_used: z.boolean().optional(),
+  is_poll_duration_extended: z.boolean().optional(),
   ai_generated: z.boolean().optional(),
 }).passthrough();
 

package/tool-annotations.json

@@ -161,6 +161,7 @@
     "cancel_subscription",
     "pause_subscription",
     "resume_subscription",
-    "downgrade_subscription"
+    "downgrade_subscription",
+    "delete_post"
   ]
 }

package/tool-registry.json

@@ -781,7 +781,7 @@
       "label": "Delete posts",
       "exception": {
         "category": "publishing",
-        "reason": "Removes scheduled content before it goes out to a social network."
+        "reason": "Removes a post record or live platform content after explicit confirmation."
       },
       "selector": "params",
       "defaultMode": "post",
@@ -790,7 +790,7 @@
           "label": "Delete one post",
           "destructive": true,
           "idempotent": true,
-          "openWorld": false,
+          "openWorld": true,
           "confirm": "confirm",
           "params": {
             "post_id": {
@@ -800,6 +800,13 @@
             },
             "confirm_published": {
               "type": "boolean"
+            },
+            "delete_mode": {
+              "type": "string",
+              "enum": [
+                "posterly",
+                "platform"
+              ]
             }
           }
         },