posterly-mcp-server 0.37.0 → 0.38.0

package/README.md

@@ -122,7 +122,7 @@ Add the same server definition to your Cursor MCP settings:
 
 ## Available tools
 
-`posterly-mcp-server@0.37.0` exposes 86 tools.
+`posterly-mcp-server@0.38.0` exposes 87 tools.
 
 Public setup tools work before `POSTERLY_API_KEY` exists:
 
@@ -197,6 +197,7 @@ Authenticated tools require `POSTERLY_API_KEY`:
 - `get_comment`
 - `reply_to_comment` (comment reply after explicit confirmation)
 - `update_comment` (hide/unhide or mark read; hide is reversible)
+- `delete_comment` (delete an Instagram or Facebook comment after confirmation; Threads replies cannot be deleted)
 - `sync_inbox` (pull latest inbox data for one account; 30-second cooldown)
 - `list_google_business_reviews`
 - `get_google_business_review_link`

package/dist/index.js

@@ -60,6 +60,7 @@ import { listCommentsTool } from './tools/list-comments.js';
 import { getCommentTool } from './tools/get-comment.js';
 import { replyToCommentTool } from './tools/reply-to-comment.js';
 import { updateCommentTool } from './tools/update-comment.js';
+import { deleteCommentTool } from './tools/delete-comment.js';
 import { syncInboxTool } from './tools/sync-inbox.js';
 import { listActivityTool } from './tools/list-activity.js';
 import { getUpdatesTool } from './tools/get-updates.js';
@@ -789,6 +790,15 @@ server.tool(updateCommentTool.name, updateCommentTool.description, updateComment
         return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
     }
 });
+server.tool(deleteCommentTool.name, deleteCommentTool.description, deleteCommentTool.inputSchema.shape, getToolAnnotations(deleteCommentTool.name), async (input) => {
+    try {
+        const text = await deleteCommentTool.execute(client, input);
+        return { content: [{ type: 'text', text }] };
+    }
+    catch (err) {
+        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+    }
+});
 server.tool(syncInboxTool.name, syncInboxTool.description, syncInboxTool.inputSchema.shape, getToolAnnotations(syncInboxTool.name), async (input) => {
     try {
         const text = await syncInboxTool.execute(client, input);

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

@@ -1311,6 +1311,9 @@ export declare class PosterlyClient {
         is_read?: boolean;
         workspace_id?: string;
     }): Promise<InboxCommentResponse>;
+    deleteComment(id: string, workspaceId?: string): Promise<{
+        success: true;
+    }>;
     syncInbox(data: {
         account_id: number;
         sync_type?: 'all' | 'dm' | 'comments';

package/dist/lib/api-client.js

@@ -623,6 +623,13 @@ export class PosterlyClient {
             body.workspace_id = data.workspace_id;
         return this.request('PATCH', `/inbox/comments/${encodeURIComponent(data.comment_id)}`, body);
     }
+    async deleteComment(id, workspaceId) {
+        const searchParams = new URLSearchParams();
+        if (workspaceId)
+            searchParams.set('workspace_id', workspaceId);
+        const qs = searchParams.toString();
+        return this.request('DELETE', `/inbox/comments/${encodeURIComponent(id)}${qs ? `?${qs}` : ''}`);
+    }
     async syncInbox(data) {
         return this.request('POST', '/inbox/sync', data);
     }

package/dist/lib/version.d.ts

@@ -1 +1 @@
-export declare const POSTERLY_MCP_VERSION = "0.37.0";
+export declare const POSTERLY_MCP_VERSION = "0.38.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.37.0';
+export const POSTERLY_MCP_VERSION = '0.38.0';

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

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+import type { PosterlyClient } from '../lib/api-client.js';
+export declare const deleteCommentTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        comment_id: z.ZodString;
+        workspace_id: z.ZodOptional<z.ZodString>;
+        confirm: z.ZodLiteral<true>;
+    }, "strip", z.ZodTypeAny, {
+        confirm: true;
+        comment_id: string;
+        workspace_id?: string | undefined;
+    }, {
+        confirm: true;
+        comment_id: string;
+        workspace_id?: string | undefined;
+    }>;
+    execute(client: PosterlyClient, input: {
+        comment_id: string;
+        workspace_id?: string;
+        confirm: true;
+    }): Promise<string>;
+};

package/dist/tools/delete-comment.js

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+export const deleteCommentTool = {
+    name: 'delete_comment',
+    description: 'Delete an Instagram or Facebook Page inbox comment. DESTRUCTIVE and IRREVERSIBLE. Threads replies cannot be deleted; hide them with update_comment instead. Requires a Pro plan or higher, posts:write, and admin workspace access. Fetch with get_comment first and pass confirm=true only after explicit user confirmation.',
+    inputSchema: z.object({
+        comment_id: z.string().min(1).describe('Comment ID from list_comments or get_comment.'),
+        workspace_id: z.string().optional().describe('Workspace ID from whoami.'),
+        confirm: z.literal(true).describe('Must be true after explicit user confirmation of the comment deletion.'),
+    }),
+    async execute(client, input) {
+        if (input.confirm !== true) {
+            throw new Error('Refusing to delete comment without confirm=true after explicit user confirmation.');
+        }
+        await client.deleteComment(input.comment_id, input.workspace_id);
+        return [
+            `Comment ${input.comment_id} deleted successfully.`,
+            'It has been deleted from the posterly inbox. On Instagram or Facebook it is also removed on the network when the platform call succeeds.',
+            '',
+            'Next step for the AI agent: tell the user the comment is gone. Threads replies cannot be deleted; hide them with update_comment instead.',
+        ].join('\n');
+    },
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "posterly-mcp-server",
-  "version": "0.37.0",
+  "version": "0.38.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.37.0",
+  "version": "0.38.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.37.0",
+      "version": "0.38.0",
       "transport": {
         "type": "stdio"
       },

package/src/index.ts

@@ -61,6 +61,7 @@ import { listCommentsTool } from './tools/list-comments.js';
 import { getCommentTool } from './tools/get-comment.js';
 import { replyToCommentTool } from './tools/reply-to-comment.js';
 import { updateCommentTool } from './tools/update-comment.js';
+import { deleteCommentTool } from './tools/delete-comment.js';
 import { syncInboxTool } from './tools/sync-inbox.js';
 import { listActivityTool } from './tools/list-activity.js';
 import { getUpdatesTool } from './tools/get-updates.js';
@@ -1255,6 +1256,21 @@ server.tool(
   }
 );
 
+server.tool(
+  deleteCommentTool.name,
+  deleteCommentTool.description,
+  deleteCommentTool.inputSchema.shape,
+  getToolAnnotations(deleteCommentTool.name),
+  async (input) => {
+    try {
+      const text = await deleteCommentTool.execute(client, input as any);
+      return { content: [{ type: 'text' as const, text }] };
+    } catch (err: any) {
+      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+    }
+  }
+);
+
 server.tool(
   syncInboxTool.name,
   syncInboxTool.description,

package/src/lib/api-client.ts

@@ -1862,6 +1862,13 @@ export class PosterlyClient {
     return this.request('PATCH', `/inbox/comments/${encodeURIComponent(data.comment_id)}`, body);
   }
 
+  async deleteComment(id: string, workspaceId?: string): Promise<{ success: true }> {
+    const searchParams = new URLSearchParams();
+    if (workspaceId) searchParams.set('workspace_id', workspaceId);
+    const qs = searchParams.toString();
+    return this.request('DELETE', `/inbox/comments/${encodeURIComponent(id)}${qs ? `?${qs}` : ''}`);
+  }
+
   async syncInbox(data: {
     account_id: number;
     sync_type?: 'all' | 'dm' | 'comments';

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.37.0';
+export const POSTERLY_MCP_VERSION = '0.38.0';

package/src/tools/delete-comment.ts

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+import type { PosterlyClient } from '../lib/api-client.js';
+
+export const deleteCommentTool = {
+  name: 'delete_comment',
+  description:
+    'Delete an Instagram or Facebook Page inbox comment. DESTRUCTIVE and IRREVERSIBLE. Threads replies cannot be deleted; hide them with update_comment instead. Requires a Pro plan or higher, posts:write, and admin workspace access. Fetch with get_comment first and pass confirm=true only after explicit user confirmation.',
+  inputSchema: z.object({
+    comment_id: z.string().min(1).describe('Comment ID from list_comments or get_comment.'),
+    workspace_id: z.string().optional().describe('Workspace ID from whoami.'),
+    confirm: z.literal(true).describe('Must be true after explicit user confirmation of the comment deletion.'),
+  }),
+
+  async execute(
+    client: PosterlyClient,
+    input: { comment_id: string; workspace_id?: string; confirm: true },
+  ) {
+    if (input.confirm !== true) {
+      throw new Error('Refusing to delete comment without confirm=true after explicit user confirmation.');
+    }
+    await client.deleteComment(input.comment_id, input.workspace_id);
+    return [
+      `Comment ${input.comment_id} deleted successfully.`,
+      'It has been deleted from the posterly inbox. On Instagram or Facebook it is also removed on the network when the platform call succeeds.',
+      '',
+      'Next step for the AI agent: tell the user the comment is gone. Threads replies cannot be deleted; hide them with update_comment instead.',
+    ].join('\n');
+  },
+};

package/tool-annotations.json

@@ -58,6 +58,7 @@
     "update_post_status",
     "update_post_release_id",
     "delete_post",
+    "delete_comment",
     "delete_post_group",
     "get_account_analytics",
     "get_post_analytics",
@@ -143,6 +144,7 @@
     "update_post",
     "update_post_status",
     "delete_post",
+    "delete_comment",
     "delete_post_group",
     "reply_google_business_review",
     "delete_google_business_review_reply",
@@ -165,6 +167,7 @@
     "update_post_status",
     "update_post_release_id",
     "delete_post",
+    "delete_comment",
     "delete_post_group",
     "reply_google_business_review",
     "delete_google_business_review_reply",
@@ -218,6 +221,7 @@
     "send_message",
     "reply_to_comment",
     "update_comment",
+    "delete_comment",
     "sync_inbox"
   ]
 }