posterly-mcp-server 0.43.3 → 0.43.4

package/README.md

@@ -122,7 +122,7 @@ Add the same server definition to your Cursor MCP settings:
 
 ## Available tools
 
-`posterly-mcp-server@0.43.3` exposes 90 tools.
+`posterly-mcp-server@0.43.4` exposes 90 tools.
 
 Public setup tools work before `POSTERLY_API_KEY` exists:
 

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

@@ -128,6 +128,15 @@ export interface DismissSuggestionResponse {
     ok: boolean;
     status: string;
 }
+export type ApiPostApprovalStatus = 'none' | 'pending_client' | 'approved' | 'changes_requested' | 'rejected';
+export interface ApiPostApproval {
+    status: ApiPostApprovalStatus;
+    asset_status: ApiPostApprovalStatus;
+    caption_status: ApiPostApprovalStatus;
+    waiting_on: 'client' | 'team' | null;
+    requested_at: string | null;
+    completed_at: string | null;
+}
 export interface Post {
     id: number;
     content: string;
@@ -144,6 +153,9 @@ export interface Post {
     reel_cover_url?: string | null;
     reel_cover_method?: string | null;
     reel_thumb_offset?: number | null;
+    brand_id?: string | null;
+    content_plan_id?: string | null;
+    approval?: ApiPostApproval;
 }
 export interface InstagramPostSettings {
     __type?: 'instagram' | 'instagram-standalone';
@@ -1090,6 +1102,8 @@ export declare class PosterlyClient {
         limit?: number;
         offset?: number;
         workspace_id?: string;
+        approval_status?: string;
+        brand_id?: string;
     }): Promise<{
         posts: Post[];
         total: number;

package/dist/lib/api-client.js

@@ -257,6 +257,10 @@ export class PosterlyClient {
             searchParams.set('offset', String(params.offset));
         if (params?.workspace_id)
             searchParams.set('workspace_id', params.workspace_id);
+        if (params?.approval_status)
+            searchParams.set('approval_status', params.approval_status);
+        if (params?.brand_id)
+            searchParams.set('brand_id', params.brand_id);
         const qs = searchParams.toString();
         return this.request('GET', `/posts${qs ? `?${qs}` : ''}`);
     }

package/dist/lib/version.d.ts

@@ -1 +1 @@
-export declare const POSTERLY_MCP_VERSION = "0.43.3";
+export declare const POSTERLY_MCP_VERSION = "0.43.4";

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

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

@@ -5,7 +5,7 @@ export declare const createWebhookTool: {
     description: string;
     inputSchema: z.ZodObject<{
         url: z.ZodString;
-        events: z.ZodOptional<z.ZodArray<z.ZodEnum<["webhook.test", "post.created", "post.updated", "post.deleted", "post.publishing", "post.published", "post.failed", "account.disconnected", "analytics.synced"]>, "many">>;
+        events: z.ZodOptional<z.ZodArray<z.ZodEnum<["webhook.test", "post.created", "post.updated", "post.deleted", "post.publishing", "post.published", "post.failed", "account.disconnected", "analytics.synced", "approval.requested", "approval.approved", "approval.changes_requested", "approval.rejected", "approval.commented"]>, "many">>;
         workspace_id: z.ZodOptional<z.ZodString>;
         description: z.ZodOptional<z.ZodString>;
         is_active: z.ZodOptional<z.ZodBoolean>;
@@ -15,14 +15,14 @@ export declare const createWebhookTool: {
         confirm: true;
         description?: string | undefined;
         workspace_id?: string | undefined;
-        events?: ("webhook.test" | "post.created" | "post.updated" | "post.deleted" | "post.publishing" | "post.published" | "post.failed" | "account.disconnected" | "analytics.synced")[] | undefined;
+        events?: ("webhook.test" | "post.created" | "post.updated" | "post.deleted" | "post.publishing" | "post.published" | "post.failed" | "account.disconnected" | "analytics.synced" | "approval.requested" | "approval.approved" | "approval.changes_requested" | "approval.rejected" | "approval.commented")[] | undefined;
         is_active?: boolean | undefined;
     }, {
         url: string;
         confirm: true;
         description?: string | undefined;
         workspace_id?: string | undefined;
-        events?: ("webhook.test" | "post.created" | "post.updated" | "post.deleted" | "post.publishing" | "post.published" | "post.failed" | "account.disconnected" | "analytics.synced")[] | undefined;
+        events?: ("webhook.test" | "post.created" | "post.updated" | "post.deleted" | "post.publishing" | "post.published" | "post.failed" | "account.disconnected" | "analytics.synced" | "approval.requested" | "approval.approved" | "approval.changes_requested" | "approval.rejected" | "approval.commented")[] | undefined;
         is_active?: boolean | undefined;
     }>;
     execute(client: PosterlyClient, input: {

package/dist/tools/list-posts.d.ts

@@ -9,18 +9,24 @@ export declare const listPostsTool: {
         account_id: z.ZodOptional<z.ZodString>;
         limit: z.ZodOptional<z.ZodNumber>;
         workspace_id: z.ZodOptional<z.ZodString>;
+        approval_status: z.ZodOptional<z.ZodEnum<["none", "pending_client", "approved", "changes_requested", "rejected"]>>;
+        brand_id: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "slack" | "mastodon" | "devto" | "hashnode" | "wordpress" | "lemmy" | "gmb" | "google-business" | "google_business_profile" | undefined;
         status?: string | undefined;
         workspace_id?: string | undefined;
         account_id?: string | undefined;
         limit?: number | undefined;
+        approval_status?: "none" | "pending_client" | "approved" | "changes_requested" | "rejected" | undefined;
+        brand_id?: string | undefined;
     }, {
         platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "slack" | "mastodon" | "devto" | "hashnode" | "wordpress" | "lemmy" | "gmb" | "google-business" | "google_business_profile" | undefined;
         status?: string | undefined;
         workspace_id?: string | undefined;
         account_id?: string | undefined;
         limit?: number | undefined;
+        approval_status?: "none" | "pending_client" | "approved" | "changes_requested" | "rejected" | undefined;
+        brand_id?: string | undefined;
     }>;
     execute(client: PosterlyClient, input: {
         status?: string;
@@ -28,5 +34,7 @@ export declare const listPostsTool: {
         account_id?: string;
         limit?: number;
         workspace_id?: string;
+        approval_status?: string;
+        brand_id?: string;
     }): Promise<string>;
 };

package/dist/tools/list-posts.js

@@ -3,7 +3,7 @@ import { dashboardUrlForPostList, formatLocalDateTime, truncateText } from '../l
 import { SUPPORTED_PLATFORM_INPUTS, SUPPORTED_PLATFORM_IDS } from '../generated/platform-manifest.js';
 export const listPostsTool = {
     name: 'list_posts',
-    description: 'List upcoming or recent posts. Filter by status (scheduled, published, failed, draft), platform, account_id, or workspace_id. If workspace_id is omitted, posts across every workspace the caller is a member of are returned.',
+    description: 'List upcoming or recent posts. Filter by status (scheduled, published, failed, draft), platform, account_id, workspace_id, approval_status, or brand_id. If workspace_id is omitted, posts across every workspace the caller is a member of are returned.',
     inputSchema: z.object({
         status: z
             .string()
@@ -27,6 +27,14 @@ export const listPostsTool = {
             .string()
             .optional()
             .describe('Filter to posts in a specific workspace (get IDs via whoami).'),
+        approval_status: z
+            .enum(['none', 'pending_client', 'approved', 'changes_requested', 'rejected'])
+            .optional()
+            .describe('Filter by client review approval status. pending_client means the post is waiting on the client.'),
+        brand_id: z
+            .string()
+            .optional()
+            .describe('Filter to posts assigned to a specific brand/client (the id from list_brands).'),
     }),
     async execute(client, input) {
         const { posts, total } = await client.listPosts({
@@ -39,7 +47,18 @@ export const listPostsTool = {
         const lines = posts.map((p) => {
             const date = formatLocalDateTime(p.scheduled_at);
             const caption = truncateText(p.content, 60);
-            return `• [${p.status}] #${p.id}: ${caption} (${date})`;
+            const approvalBits = [];
+            if (p.approval && p.approval.status !== 'none') {
+                approvalBits.push(`approval: ${p.approval.status}`);
+                if (p.approval.waiting_on)
+                    approvalBits.push(`waiting on: ${p.approval.waiting_on}`);
+            }
+            if (p.brand_id)
+                approvalBits.push(`brand: ${p.brand_id}`);
+            if (p.content_plan_id)
+                approvalBits.push(`plan: ${p.content_plan_id}`);
+            const approvalSuffix = approvalBits.length > 0 ? ` [${approvalBits.join(', ')}]` : '';
+            return `• [${p.status}] #${p.id}: ${caption} (${date})${approvalSuffix}`;
         });
         return [
             `Posts (${posts.length} of ${total}):`,

package/dist/tools/submit-agent-feedback.d.ts

@@ -27,8 +27,8 @@ export declare const submitAgentFeedbackInputSchema: z.ZodObject<{
     source: "mcp" | "cli" | "rest" | "skill";
     tool: string;
     outcome: "success" | "error" | "abandoned";
-    error_code?: string | undefined;
     client?: string | undefined;
+    error_code?: string | undefined;
     comment?: string | undefined;
     context?: {
         request_id?: string | undefined;
@@ -40,8 +40,8 @@ export declare const submitAgentFeedbackInputSchema: z.ZodObject<{
     source: "mcp" | "cli" | "rest" | "skill";
     tool: string;
     outcome: "success" | "error" | "abandoned";
-    error_code?: string | undefined;
     client?: string | undefined;
+    error_code?: string | undefined;
     comment?: string | undefined;
     context?: {
         request_id?: string | undefined;
@@ -81,8 +81,8 @@ export declare const submitAgentFeedbackTool: {
         source: "mcp" | "cli" | "rest" | "skill";
         tool: string;
         outcome: "success" | "error" | "abandoned";
-        error_code?: string | undefined;
         client?: string | undefined;
+        error_code?: string | undefined;
         comment?: string | undefined;
         context?: {
             request_id?: string | undefined;
@@ -94,8 +94,8 @@ export declare const submitAgentFeedbackTool: {
         source: "mcp" | "cli" | "rest" | "skill";
         tool: string;
         outcome: "success" | "error" | "abandoned";
-        error_code?: string | undefined;
         client?: string | undefined;
+        error_code?: string | undefined;
         comment?: string | undefined;
         context?: {
             request_id?: string | undefined;

package/dist/tools/submit-product-feedback.d.ts

@@ -21,9 +21,9 @@ export declare const submitProductFeedbackInputSchema: z.ZodObject<{
     title: string;
     confirm: true;
     category: "bug" | "idea" | "feedback";
+    client?: string | undefined;
     description?: string | undefined;
     source?: "mcp" | "cli" | "rest" | "skill" | undefined;
-    client?: string | undefined;
     context?: {
         request_id?: string | undefined;
         related_tool?: string | undefined;
@@ -32,9 +32,9 @@ export declare const submitProductFeedbackInputSchema: z.ZodObject<{
     title: string;
     confirm: true;
     category: "bug" | "idea" | "feedback";
+    client?: string | undefined;
     description?: string | undefined;
     source?: "mcp" | "cli" | "rest" | "skill" | undefined;
-    client?: string | undefined;
     context?: {
         request_id?: string | undefined;
         related_tool?: string | undefined;
@@ -65,9 +65,9 @@ export declare const submitProductFeedbackTool: {
         title: string;
         confirm: true;
         category: "bug" | "idea" | "feedback";
+        client?: string | undefined;
         description?: string | undefined;
         source?: "mcp" | "cli" | "rest" | "skill" | undefined;
-        client?: string | undefined;
         context?: {
             request_id?: string | undefined;
             related_tool?: string | undefined;
@@ -76,9 +76,9 @@ export declare const submitProductFeedbackTool: {
         title: string;
         confirm: true;
         category: "bug" | "idea" | "feedback";
+        client?: string | undefined;
         description?: string | undefined;
         source?: "mcp" | "cli" | "rest" | "skill" | undefined;
-        client?: string | undefined;
         context?: {
             request_id?: string | undefined;
             related_tool?: string | undefined;

package/dist/tools/update-webhook.d.ts

@@ -6,7 +6,7 @@ export declare const updateWebhookTool: {
     inputSchema: z.ZodObject<{
         webhook_id: z.ZodString;
         url: z.ZodOptional<z.ZodString>;
-        events: z.ZodOptional<z.ZodArray<z.ZodEnum<["webhook.test", "post.created", "post.updated", "post.deleted", "post.publishing", "post.published", "post.failed", "account.disconnected", "analytics.synced"]>, "many">>;
+        events: z.ZodOptional<z.ZodArray<z.ZodEnum<["webhook.test", "post.created", "post.updated", "post.deleted", "post.publishing", "post.published", "post.failed", "account.disconnected", "analytics.synced", "approval.requested", "approval.approved", "approval.changes_requested", "approval.rejected", "approval.commented"]>, "many">>;
         workspace_id: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNull]>>;
         description: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNull]>>;
         is_active: z.ZodOptional<z.ZodBoolean>;
@@ -17,7 +17,7 @@ export declare const updateWebhookTool: {
         description?: string | null | undefined;
         workspace_id?: string | null | undefined;
         url?: string | undefined;
-        events?: ("webhook.test" | "post.created" | "post.updated" | "post.deleted" | "post.publishing" | "post.published" | "post.failed" | "account.disconnected" | "analytics.synced")[] | undefined;
+        events?: ("webhook.test" | "post.created" | "post.updated" | "post.deleted" | "post.publishing" | "post.published" | "post.failed" | "account.disconnected" | "analytics.synced" | "approval.requested" | "approval.approved" | "approval.changes_requested" | "approval.rejected" | "approval.commented")[] | undefined;
         is_active?: boolean | undefined;
     }, {
         confirm: true;
@@ -25,7 +25,7 @@ export declare const updateWebhookTool: {
         description?: string | null | undefined;
         workspace_id?: string | null | undefined;
         url?: string | undefined;
-        events?: ("webhook.test" | "post.created" | "post.updated" | "post.deleted" | "post.publishing" | "post.published" | "post.failed" | "account.disconnected" | "analytics.synced")[] | undefined;
+        events?: ("webhook.test" | "post.created" | "post.updated" | "post.deleted" | "post.publishing" | "post.published" | "post.failed" | "account.disconnected" | "analytics.synced" | "approval.requested" | "approval.approved" | "approval.changes_requested" | "approval.rejected" | "approval.commented")[] | undefined;
         is_active?: boolean | undefined;
     }>;
     execute(client: PosterlyClient, input: {

package/dist/tools/webhook-events.d.ts

@@ -1,3 +1,3 @@
 import { z } from 'zod';
-export declare const WEBHOOK_EVENTS: readonly ["webhook.test", "post.created", "post.updated", "post.deleted", "post.publishing", "post.published", "post.failed", "account.disconnected", "analytics.synced"];
-export declare const webhookEventSchema: z.ZodEnum<["webhook.test", "post.created", "post.updated", "post.deleted", "post.publishing", "post.published", "post.failed", "account.disconnected", "analytics.synced"]>;
+export declare const WEBHOOK_EVENTS: readonly ["webhook.test", "post.created", "post.updated", "post.deleted", "post.publishing", "post.published", "post.failed", "account.disconnected", "analytics.synced", "approval.requested", "approval.approved", "approval.changes_requested", "approval.rejected", "approval.commented"];
+export declare const webhookEventSchema: z.ZodEnum<["webhook.test", "post.created", "post.updated", "post.deleted", "post.publishing", "post.published", "post.failed", "account.disconnected", "analytics.synced", "approval.requested", "approval.approved", "approval.changes_requested", "approval.rejected", "approval.commented"]>;

package/dist/tools/webhook-events.js

@@ -9,5 +9,10 @@ export const WEBHOOK_EVENTS = [
     'post.failed',
     'account.disconnected',
     'analytics.synced',
+    'approval.requested',
+    'approval.approved',
+    'approval.changes_requested',
+    'approval.rejected',
+    'approval.commented',
 ];
 export const webhookEventSchema = z.enum(WEBHOOK_EVENTS);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "posterly-mcp-server",
-  "version": "0.43.3",
+  "version": "0.43.4",
   "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.43.3",
+  "version": "0.43.4",
   "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.43.3",
+      "version": "0.43.4",
       "transport": {
         "type": "stdio"
       },

package/src/lib/api-client.ts

@@ -138,6 +138,17 @@ export interface DismissSuggestionResponse {
   status: string;
 }
 
+export type ApiPostApprovalStatus = 'none' | 'pending_client' | 'approved' | 'changes_requested' | 'rejected';
+
+export interface ApiPostApproval {
+  status: ApiPostApprovalStatus;
+  asset_status: ApiPostApprovalStatus;
+  caption_status: ApiPostApprovalStatus;
+  waiting_on: 'client' | 'team' | null;
+  requested_at: string | null;
+  completed_at: string | null;
+}
+
 export interface Post {
   id: number;
   content: string;
@@ -154,6 +165,9 @@ export interface Post {
   reel_cover_url?: string | null;
   reel_cover_method?: string | null;
   reel_thumb_offset?: number | null;
+  brand_id?: string | null;
+  content_plan_id?: string | null;
+  approval?: ApiPostApproval;
 }
 
 export interface InstagramPostSettings {
@@ -1354,6 +1368,8 @@ export class PosterlyClient {
     limit?: number;
     offset?: number;
     workspace_id?: string;
+    approval_status?: string;
+    brand_id?: string;
   }): Promise<{ posts: Post[]; total: number }> {
     const searchParams = new URLSearchParams();
     if (params?.status) searchParams.set('status', params.status);
@@ -1362,6 +1378,8 @@ export class PosterlyClient {
     if (params?.limit) searchParams.set('limit', String(params.limit));
     if (params?.offset) searchParams.set('offset', String(params.offset));
     if (params?.workspace_id) searchParams.set('workspace_id', params.workspace_id);
+    if (params?.approval_status) searchParams.set('approval_status', params.approval_status);
+    if (params?.brand_id) searchParams.set('brand_id', params.brand_id);
 
     const qs = searchParams.toString();
     return this.request('GET', `/posts${qs ? `?${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.43.3';
+export const POSTERLY_MCP_VERSION = '0.43.4';

package/src/tools/list-posts.ts

@@ -6,7 +6,7 @@ import { SUPPORTED_PLATFORM_INPUTS, SUPPORTED_PLATFORM_IDS } from '../generated/
 export const listPostsTool = {
   name: 'list_posts',
   description:
-    'List upcoming or recent posts. Filter by status (scheduled, published, failed, draft), platform, account_id, or workspace_id. If workspace_id is omitted, posts across every workspace the caller is a member of are returned.',
+    'List upcoming or recent posts. Filter by status (scheduled, published, failed, draft), platform, account_id, workspace_id, approval_status, or brand_id. If workspace_id is omitted, posts across every workspace the caller is a member of are returned.',
   inputSchema: z.object({
     status: z
       .string()
@@ -30,6 +30,14 @@ export const listPostsTool = {
       .string()
       .optional()
       .describe('Filter to posts in a specific workspace (get IDs via whoami).'),
+    approval_status: z
+      .enum(['none', 'pending_client', 'approved', 'changes_requested', 'rejected'])
+      .optional()
+      .describe('Filter by client review approval status. pending_client means the post is waiting on the client.'),
+    brand_id: z
+      .string()
+      .optional()
+      .describe('Filter to posts assigned to a specific brand/client (the id from list_brands).'),
   }),
 
   async execute(
@@ -40,6 +48,8 @@ export const listPostsTool = {
       account_id?: string;
       limit?: number;
       workspace_id?: string;
+      approval_status?: string;
+      brand_id?: string;
     }
   ) {
     const { posts, total } = await client.listPosts({
@@ -54,7 +64,15 @@ export const listPostsTool = {
     const lines = posts.map((p) => {
       const date = formatLocalDateTime(p.scheduled_at);
       const caption = truncateText(p.content, 60);
-      return `• [${p.status}] #${p.id}: ${caption} (${date})`;
+      const approvalBits: string[] = [];
+      if (p.approval && p.approval.status !== 'none') {
+        approvalBits.push(`approval: ${p.approval.status}`);
+        if (p.approval.waiting_on) approvalBits.push(`waiting on: ${p.approval.waiting_on}`);
+      }
+      if (p.brand_id) approvalBits.push(`brand: ${p.brand_id}`);
+      if (p.content_plan_id) approvalBits.push(`plan: ${p.content_plan_id}`);
+      const approvalSuffix = approvalBits.length > 0 ? ` [${approvalBits.join(', ')}]` : '';
+      return `• [${p.status}] #${p.id}: ${caption} (${date})${approvalSuffix}`;
     });
 
     return [

package/src/tools/webhook-events.ts

@@ -10,6 +10,11 @@ export const WEBHOOK_EVENTS = [
   'post.failed',
   'account.disconnected',
   'analytics.synced',
+  'approval.requested',
+  'approval.approved',
+  'approval.changes_requested',
+  'approval.rejected',
+  'approval.commented',
 ] as const;
 
 export const webhookEventSchema = z.enum(WEBHOOK_EVENTS);