posterly-mcp-server 0.47.1 → 0.48.0

package/README.md

@@ -123,7 +123,7 @@ Add the same server definition to your Cursor MCP settings:
 
 ## Available tools
 
-`posterly-mcp-server@0.47.1` exposes 62 tools covering 95 actions. The hosted HTTP endpoint exposes the same catalog minus the three signup tools: 59 tools covering 92 actions.
+`posterly-mcp-server@0.48.0` exposes 62 tools covering 95 actions. The hosted HTTP endpoint exposes the same catalog minus the three signup tools: 59 tools covering 92 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.
 
@@ -217,7 +217,7 @@ Accounts, posting, media, schedule, analytics, and support. What most assistants
 
 | Mode (picked by params) | What it does |
 | --- | --- |
-| `post` (default) | Delete one post. Published Instagram or Facebook posts also need `confirm_published` |
+| `post` (default) | Delete one post. Choose `delete_mode`: `posterly` keeps live content; `platform` also requires `confirm_published` |
 | `group` (pass `group_id`) | Delete a post group (preview then confirm). Never deletes published posts |
 
 **`upload_media`**: Upload media

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

@@ -1265,6 +1265,7 @@ export declare class PosterlyClient {
     }>;
     deletePost(id: number, options?: {
         confirmPublished?: boolean;
+        deleteMode?: 'posterly' | 'platform';
     }): Promise<{
         deleted: boolean;
         id: number;

package/dist/lib/api-client.js

@@ -378,7 +378,12 @@ export class PosterlyClient {
         return this.request('PATCH', `/posts/${id}`, data);
     }
     async deletePost(id, options) {
-        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}`);
     }
     async setPostApproval(id, data) {

package/dist/lib/version.d.ts

@@ -1 +1 @@
-export declare const POSTERLY_MCP_VERSION = "0.47.1";
+export declare const POSTERLY_MCP_VERSION = "0.48.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.47.1';
+export const POSTERLY_MCP_VERSION = '0.48.0';

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

@@ -4,6 +4,7 @@ import { type ToolContext } from '../lib/tool-runtime.js';
 type DeletePostInput = {
     post_id?: number;
     group_id?: string;
+    delete_mode?: 'posterly' | 'platform';
     confirm_published?: boolean;
     confirm?: boolean;
     preview_id?: string;
@@ -14,6 +15,7 @@ export declare const deletePostTool: {
     inputSchema: z.ZodObject<{
         post_id: z.ZodOptional<z.ZodNumber>;
         group_id: z.ZodOptional<z.ZodString>;
+        delete_mode: z.ZodOptional<z.ZodEnum<["posterly", "platform"]>>;
         confirm_published: z.ZodOptional<z.ZodBoolean>;
         confirm: z.ZodOptional<z.ZodBoolean>;
         preview_id: z.ZodOptional<z.ZodString>;
@@ -21,14 +23,16 @@ export declare const deletePostTool: {
         confirm?: boolean | undefined;
         preview_id?: string | undefined;
         post_id?: number | undefined;
-        group_id?: string | undefined;
         confirm_published?: boolean | undefined;
+        delete_mode?: "platform" | "posterly" | undefined;
+        group_id?: string | undefined;
     }, {
         confirm?: boolean | undefined;
         preview_id?: string | undefined;
         post_id?: number | undefined;
-        group_id?: string | undefined;
         confirm_published?: boolean | undefined;
+        delete_mode?: "platform" | "posterly" | undefined;
+        group_id?: string | undefined;
     }>;
     /** The old tools' exact input schemas, for alias calls (see alias-transport.ts). */
     legacySchemas: {

package/dist/tools/delete-post.js

@@ -3,14 +3,15 @@ import { code, dashboardUrlForPosts } from '../lib/format.js';
 import { previewThenConfirm, validateArgs } from '../lib/tool-runtime.js';
 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.',
+    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. 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()
@@ -53,13 +54,16 @@ async function deleteOne(client, input) {
     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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "posterly-mcp-server",
-  "version": "0.47.1",
+  "version": "0.48.0",
   "mcpName": "io.github.awpthorp/posterly",
   "description": "MCP server for posterly: schedule and publish social media posts across 18 platforms from any MCP client (Claude, ChatGPT, Cursor, Windsurf, Cline, and more)",
   "license": "MIT",

package/server.json

@@ -3,7 +3,7 @@
   "name": "io.github.awpthorp/posterly",
   "title": "posterly",
   "description": "Validate, schedule, publish, and analyze social content across 18 platforms with posterly.",
-  "version": "0.47.1",
+  "version": "0.48.0",
   "websiteUrl": "https://www.poster.ly/mcp",
   "repository": {
     "url": "https://github.com/awpthorp/posterly",
@@ -14,7 +14,7 @@
     {
       "registryType": "npm",
       "identifier": "posterly-mcp-server",
-      "version": "0.47.1",
+      "version": "0.48.0",
       "transport": {
         "type": "stdio"
       },

package/src/lib/api-client.ts

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

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/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"
+              ]
             }
           }
         },