posterly-mcp-server 0.43.3 → 0.43.5

package/dist/tools/list-brands.js

@@ -14,7 +14,7 @@ export const listBrandsTool = {
         if (brands.length === 0) {
             return input.workspace_id
                 ? mdEmpty('brands', 'This workspace does not have any brands or clients yet.')
-                : mdEmpty('brands', 'No brands or clients were found for this API key.', 'Create a brand in the Posterly dashboard, then run this again.');
+                : mdEmpty('brands', 'No brands or clients were found for this API key.', 'Create a brand in the posterly dashboard, then run this again.');
         }
         return [
             mdTitle(`Brands (${brands.length})`),

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

@@ -6,13 +6,13 @@ export declare const listCommentsTool: {
     inputSchema: z.ZodObject<{
         workspace_id: z.ZodOptional<z.ZodString>;
         account_id: z.ZodOptional<z.ZodNumber>;
-        platform: z.ZodOptional<z.ZodEnum<["instagram", "facebook", "threads"]>>;
+        platform: z.ZodOptional<z.ZodEnum<["instagram", "facebook", "threads", "linkedin"]>>;
         filter: z.ZodOptional<z.ZodEnum<["all", "unread", "flagged"]>>;
         search: z.ZodOptional<z.ZodString>;
         limit: z.ZodOptional<z.ZodNumber>;
         offset: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
-        platform?: "instagram" | "facebook" | "threads" | undefined;
+        platform?: "instagram" | "facebook" | "threads" | "linkedin" | undefined;
         workspace_id?: string | undefined;
         account_id?: number | undefined;
         limit?: number | undefined;
@@ -20,7 +20,7 @@ export declare const listCommentsTool: {
         filter?: "all" | "unread" | "flagged" | undefined;
         search?: string | undefined;
     }, {
-        platform?: "instagram" | "facebook" | "threads" | undefined;
+        platform?: "instagram" | "facebook" | "threads" | "linkedin" | undefined;
         workspace_id?: string | undefined;
         account_id?: number | undefined;
         limit?: number | undefined;
@@ -31,7 +31,7 @@ export declare const listCommentsTool: {
     execute(client: PosterlyClient, input: {
         workspace_id?: string;
         account_id?: number;
-        platform?: "instagram" | "facebook" | "threads";
+        platform?: "instagram" | "facebook" | "threads" | "linkedin";
         filter?: "all" | "unread" | "flagged";
         search?: string;
         limit?: number;

package/dist/tools/list-comments.js

@@ -1,13 +1,13 @@
 import { z } from 'zod';
 import { truncateText } from '../lib/format.js';
-const INBOX_PLATFORMS = ['instagram', 'facebook', 'threads'];
+const INBOX_PLATFORMS = ['instagram', 'facebook', 'threads', 'linkedin'];
 export const listCommentsTool = {
     name: 'list_comments',
-    description: 'List social inbox comments and replies for Instagram, Facebook Pages, and Threads. Filter by account, platform, unread/flagged, or search. Requires a Pro plan or higher plus posts:read.',
+    description: 'List social inbox comments and replies for Instagram, Facebook Pages, Threads, and LinkedIn Pages. Filter by account, platform, unread/flagged, or search. Requires a Pro plan or higher plus posts:read.',
     inputSchema: z.object({
         workspace_id: z.string().optional().describe('Filter to a workspace ID from whoami.'),
         account_id: z.number().int().positive().optional().describe('Social account ID from list_accounts.'),
-        platform: z.enum(INBOX_PLATFORMS).optional().describe('instagram, facebook, or threads.'),
+        platform: z.enum(INBOX_PLATFORMS).optional().describe('instagram, facebook, threads, or linkedin.'),
         filter: z.enum(['all', 'unread', 'flagged']).optional().describe('Comment filter. Defaults to all.'),
         search: z.string().optional().describe('Search comment content or author username.'),
         limit: z.number().int().min(1).max(100).optional().describe('Number of comments to return. Default 50, max 100.'),

package/dist/tools/list-platforms.js

@@ -15,6 +15,6 @@ export const listPlatformsTool = {
             const helperCount = platform.helper_tools?.length || 0;
             return `• ${platform.label} (${platform.id}): ${platform.status}; post types: ${platform.post_types.join(', ') || 'n/a'}; helpers: ${helperCount}; analytics: ${platform.analytics_supported ? 'yes' : 'no'}`;
         });
-        return `Posterly platforms (${result.platforms.length}):\n${lines.join('\n')}`;
+        return `posterly platforms (${result.platforms.length}):\n${lines.join('\n')}`;
     },
 };

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({
@@ -34,19 +42,30 @@ export const listPostsTool = {
             limit: input.limit || 20,
         });
         if (posts.length === 0) {
-            return 'No posts found matching your criteria.\n\nNext step for the AI agent: tell the user their Posterly queue is clear for that filter, then ask what they want to schedule next.';
+            return 'No posts found matching your criteria.\n\nNext step for the AI agent: tell the user their posterly queue is clear for that filter, then ask what they want to schedule next.';
         }
         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}):`,
             ...lines,
             '',
-            `View in Posterly: ${dashboardUrlForPostList(posts)}`,
-            'Next step for the AI agent: summarize the queue in plain language and use the dashboard link above if the user wants to inspect it in Posterly.',
+            `View in posterly: ${dashboardUrlForPostList(posts)}`,
+            'Next step for the AI agent: summarize the queue in plain language and use the dashboard link above if the user wants to inspect it in posterly.',
         ].join('\n');
     },
 };

package/dist/tools/reply-to-comment.js

@@ -1,7 +1,7 @@
 import { z } from 'zod';
 export const replyToCommentTool = {
     name: 'reply_to_comment',
-    description: 'Reply to an Instagram, Facebook Page, or Threads inbox comment. WRITE: posts to the social network. Facebook has no private comment replies. Threads has no DMs, so only public replies. Instagram supports public or private. Requires a Pro plan or higher plus posts:write. Pass confirm=true only after explicit user confirmation.',
+    description: 'Reply to an Instagram, Facebook Page, Threads, or LinkedIn Page inbox comment. WRITE: posts to the social network. Facebook has no private comment replies. Threads has no DMs, so only public replies. Instagram supports public or private. LinkedIn Page comments are public replies only. Requires a Pro plan or higher plus posts:write. Pass confirm=true only after explicit user confirmation.',
     inputSchema: z.object({
         comment_id: z.string().min(1).describe('Comment ID from list_comments.'),
         content: z.string().min(1).describe('Reply text to post.'),

package/dist/tools/start-signup.js

@@ -2,7 +2,7 @@ import { z } from 'zod';
 const DEFAULT_RETURN_PATH = '/dashboard/api?api_signup=success';
 export const startSignupTool = {
     name: 'start_signup',
-    description: 'Start the public Posterly paid signup flow for a user before Posterly API access exists. Returns a signup poll URL, a browser Checkout fallback URL, and, when enabled, a prepaid PaymentIntent the agent can pay with a Link Agent Wallet virtual card (credential_type: card). The user still sets a password and approves social OAuth in the browser. Never ask for card numbers, a Posterly password, or social passwords in chat.',
+    description: 'Start the public posterly paid signup flow for a user before posterly API access exists. Returns a signup poll URL, a browser Checkout fallback URL, and, when enabled, a prepaid PaymentIntent the agent can pay with a Link Agent Wallet virtual card (credential_type: card). The user still sets a password and approves social OAuth in the browser. Never ask for card numbers, a posterly password, or social passwords in chat.',
     inputSchema: z.object({
         email: z
             .string()
@@ -11,11 +11,11 @@ export const startSignupTool = {
         name: z
             .string()
             .optional()
-            .describe('Optional user or workspace name to pass into Posterly signup.'),
+            .describe('Optional user or workspace name to pass into posterly signup.'),
         tier: z
             .enum(['starter', 'pro', 'power_user', 'agency'])
             .default('starter')
-            .describe('Posterly plan to start. Use starter unless the user explicitly chooses another plan.'),
+            .describe('posterly plan to start. Use starter unless the user explicitly chooses another plan.'),
         interval: z
             .enum(['month'])
             .default('month')
@@ -27,7 +27,7 @@ export const startSignupTool = {
         return_path: z
             .string()
             .default(DEFAULT_RETURN_PATH)
-            .describe('Where Posterly should continue after checkout and password setup.'),
+            .describe('Where posterly should continue after checkout and password setup.'),
         source: z
             .string()
             .default('posterly_mcp_pre_auth_signup')
@@ -72,7 +72,7 @@ function formatSignupStart(response, includeRaw) {
     const agentPay = response.agent_pay || session?.agent_pay;
     const payment = response.payment || session?.payment;
     const lines = [
-        'Posterly signup started.',
+        'posterly signup started.',
         sessionId ? `Signup session: ${sessionId}` : '',
         `Status: ${status}`,
         message ? `Message: ${message}` : '',
@@ -109,17 +109,17 @@ function formatSignupStart(response, includeRaw) {
                     '1. Prefer agent_pay: confirm the PaymentIntent with a one-time Link Agent Wallet virtual card (credential_type: card). Never paste card numbers into chat or send them to posterly.',
                     '2. If the user would rather pay on the website, send them the Checkout handoff URL instead.',
                     '3. Call get_signup_session with the signup session ID until the status changes.',
-                    '4. Tell the user when Posterly sends the password setup email. Password, social OAuth, and publish approval stay in the browser.',
-                    '5. If status becomes agent_access_required, ask the user to install or paste the Posterly MCP/API setup instructions into this trusted AI chat, then onboard them in this conversation (about you, connect, brand voice, first post). Do not send them to /onboarding-v2.',
-                    '6. Do not ask for card details, the Posterly password, social passwords, or OAuth codes.',
+                    '4. Tell the user when posterly sends the password setup email. Password, social OAuth, and publish approval stay in the browser.',
+                    '5. If status becomes agent_access_required, ask the user to install or paste the posterly MCP/API setup instructions into this trusted AI chat, then onboard them in this conversation (about you, connect, brand voice, first post). Do not send them to /onboarding-v2.',
+                    '6. Do not ask for card details, the posterly password, social passwords, or OAuth codes.',
                 ]
                 : [
                     '1. If you hold an approved payment credential such as a Link agent wallet, you can pay the Checkout handoff URL yourself: create a spend request for the amount and merchant above, get the user\'s approval in the wallet, then complete the Checkout page with that credential. Never paste card numbers into chat or send them to posterly.',
                     '2. Otherwise, send the Checkout handoff URL to the user so they can pay securely in their browser. Use the raw Stripe checkout URL only if you preserve the full URL including any fragment. posterly does not email this link, so do not tell the user to check their inbox at this stage.',
                     '3. Call get_signup_session with the signup session ID until the status changes.',
-                    '4. Tell the user when Posterly sends the password setup email.',
-                    '5. If status becomes agent_access_required, ask the user to install or paste the Posterly MCP/API setup instructions into this trusted AI chat, then onboard them in this conversation (about you, connect, brand voice, first post). Do not send them to /onboarding-v2.',
-                    '6. Do not ask for card details, the Posterly password, social passwords, or OAuth codes.',
+                    '4. Tell the user when posterly sends the password setup email.',
+                    '5. If status becomes agent_access_required, ask the user to install or paste the posterly MCP/API setup instructions into this trusted AI chat, then onboard them in this conversation (about you, connect, brand voice, first post). Do not send them to /onboarding-v2.',
+                    '6. Do not ask for card details, the posterly password, social passwords, or OAuth codes.',
                 ]),
         includeRaw ? `\nRaw signup response:\n${JSON.stringify(response, null, 2)}` : '',
     ];

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/sync-inbox.js

@@ -1,10 +1,10 @@
 import { z } from 'zod';
 export const syncInboxTool = {
     name: 'sync_inbox',
-    description: 'Pull the latest Instagram, Facebook Page, or Threads inbox data for one connected account. Honors a 30-second cooldown. Threads syncs replies only (no DMs). Requires a Pro plan or higher plus posts:write.',
+    description: 'Pull the latest Instagram, Facebook Page, Threads, or LinkedIn inbox data for one connected account. Honors a 30-second cooldown (60 seconds for LinkedIn). Threads and LinkedIn sync comments only (no DMs). Requires a Pro plan or higher plus posts:write.',
     inputSchema: z.object({
         account_id: z.number().int().positive().describe('Social account ID from list_accounts.'),
-        sync_type: z.enum(['all', 'dm', 'comments']).optional().describe('What to sync. Defaults to all. Threads is comments-only.'),
+        sync_type: z.enum(['all', 'dm', 'comments']).optional().describe('What to sync. Defaults to all. Threads and LinkedIn are comments-only.'),
         workspace_id: z.string().optional().describe('Workspace ID from whoami.'),
     }),
     async execute(client, input) {

package/dist/tools/update-post.js

@@ -116,8 +116,8 @@ export const updatePostTool = {
             .string()
             .optional()
             .describe('New scheduled time (ISO 8601, e.g. 2026-03-10T09:00:00Z)'),
-        media_url: z.string().optional().describe('New media URL. Posterly storage URLs are used as-is; third-party HTTP(S) URLs are copied into Posterly storage before the post is saved. Short-lived signed URLs must still be live when this tool runs.'),
-        media_urls: z.array(z.string()).optional().describe('New media URLs for carousel. Posterly storage URLs are used as-is; third-party HTTP(S) URLs are copied into Posterly storage before the post is saved.'),
+        media_url: z.string().optional().describe('New media URL. Posterly storage URLs are used as-is; third-party HTTP(S) URLs are copied into posterly storage before the post is saved. Short-lived signed URLs must still be live when this tool runs.'),
+        media_urls: z.array(z.string()).optional().describe('New media URLs for carousel. Posterly storage URLs are used as-is; third-party HTTP(S) URLs are copied into posterly storage before the post is saved.'),
         post_type: z
             .string()
             .optional()

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/upload-media-from-url.js

@@ -1,7 +1,7 @@
 import { z } from 'zod';
 export const uploadMediaFromUrlTool = {
     name: 'upload_media_from_url',
-    description: 'Fetch an image or video from a public HTTPS URL into Posterly storage. Returns a URL that can be used with create_post. You can also pass public HTTP(S) media URLs directly to create_post/update_post; use this tool when you want to upload once and reuse the returned Posterly URL.',
+    description: 'Fetch an image or video from a public HTTPS URL into posterly storage. Returns a URL that can be used with create_post. You can also pass public HTTP(S) media URLs directly to create_post/update_post; use this tool when you want to upload once and reuse the returned posterly URL.',
     inputSchema: z.object({
         url: z.string().url().describe('Public HTTPS URL for the image or video. Local/private network URLs are blocked.'),
         filename: z.string().optional().describe('Optional filename override.'),

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/dist/tools/whoami.js

@@ -7,7 +7,7 @@ export const whoamiTool = {
     async execute(client) {
         const info = await client.whoami();
         return [
-            mdTitle('Posterly identity'),
+            mdTitle('posterly identity'),
             mdKeyValue([
                 ['User', info.user.email || code(info.user.id)],
                 ['API scopes', info.api_key.scopes.join(', ') || 'none'],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "posterly-mcp-server",
-  "version": "0.43.3",
+  "version": "0.43.5",
   "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.5",
   "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.5",
       "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 {
@@ -1095,7 +1109,7 @@ export class PosterlyClient {
   private requireApiKey(): void {
     if (!this.apiKey) {
       throw new Error(
-        'Posterly access is not installed yet. Use start_signup to begin paid setup, or set POSTERLY_API_KEY after signup.'
+        'posterly access is not installed yet. Use start_signup to begin paid setup, or set POSTERLY_API_KEY after signup.'
       );
     }
   }
@@ -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}` : ''}`);
@@ -2137,7 +2155,7 @@ export function validatePosterlyBaseUrlForKeyUse(baseUrl: string): void {
     !flagEnabled('POSTERLY_ALLOW_CUSTOM_BASE_URL')
   ) {
     throw new Error(
-      `Refusing to send an API key to custom host ${baseUrl}. Set POSTERLY_ALLOW_CUSTOM_BASE_URL=true only for a trusted Posterly deployment.`
+      `Refusing to send an API key to custom host ${baseUrl}. Set POSTERLY_ALLOW_CUSTOM_BASE_URL=true only for a trusted posterly deployment.`
     );
   }
 }

package/src/lib/format.ts

@@ -103,7 +103,7 @@ export function mdSuccess(title: string, rows: Array<[string, CellValue]>, nextS
 
 export function mdError(message: string): string {
   return [
-    mdTitle('⚠️ Posterly tool error'),
+    mdTitle('⚠️ posterly tool error'),
     `**Message:** ${message}`,
   ].join('\n');
 }

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.5';

package/src/tools/ask-support.ts

@@ -20,7 +20,7 @@ function formatSupportAnswer(result: AskSupportResponse): string {
   ].filter(Boolean);
 
   return [
-    mdTitle('Posterly Support'),
+    mdTitle('posterly Support'),
     mdQuote(result.message?.content || 'No support answer returned.'),
     sources.length ? mdSection('Sources', mdBullets(sources)) : '',
     mdSection('Status', mdBullets(status)),
@@ -31,7 +31,7 @@ const supportInputSchema = z.object({
   question: z.string().trim().min(1).max(4000),
   workspace_id: z.string().optional().describe('Workspace to inspect. Omit to use the API-key scoped workspace or personal workspace.'),
   conversation_id: z.string().optional().describe('Continue a previous support conversation.'),
-  page_url: z.string().max(2000).optional().describe('Optional Posterly page URL for context.'),
+  page_url: z.string().max(2000).optional().describe('Optional posterly page URL for context.'),
   post_id: z.number().int().positive().optional().describe('Optional post ID to inspect directly.'),
   referenced_post_ids: z.array(z.number().int().positive()).max(5).optional().describe('Optional post IDs to include in read-only diagnostics.'),
   request_human: z.boolean().default(false).optional().describe('Ask for human review. Does not create a ticket unless confirm_escalation is also true.'),
@@ -49,7 +49,7 @@ async function executeSupport(client: PosterlyClient, input: AskSupportPayload)
 export const askSupportTool = {
   name: 'ask_support',
   description:
-    'Ask Posterly Support AI an authenticated question using Posterly docs plus read-only account/post diagnostics for the caller workspace. Requires POSTERLY_API_KEY with accounts:read and posts:read scopes. Human ticket creation requires request_human=true and confirm_escalation=true after explicit user confirmation.',
+    'Ask posterly Support AI an authenticated question using posterly docs plus read-only account/post diagnostics for the caller workspace. Requires POSTERLY_API_KEY with accounts:read and posts:read scopes. Human ticket creation requires request_human=true and confirm_escalation=true after explicit user confirmation.',
   inputSchema: supportInputSchema,
   execute: executeSupport,
 };

package/src/tools/create-api-key.ts

@@ -25,7 +25,7 @@ function formatCreatedApiKey(result: CreateApiKeyResponse): string {
 export const createApiKeyTool = {
   name: 'create_api_key',
   description:
-    'Create a new Posterly API key for the authenticated user. SECRET-CREATING WRITE: only use after explicit user confirmation. The new key can only request scopes already present on the calling dashboard-created API key; OAuth and managed assistant tokens cannot mint keys.',
+    'Create a new posterly API key for the authenticated user. SECRET-CREATING WRITE: only use after explicit user confirmation. The new key can only request scopes already present on the calling dashboard-created API key; OAuth and managed assistant tokens cannot mint keys.',
   inputSchema: z.object({
     name: z.string().trim().min(1).max(120).optional().describe('Human-readable key name.'),
     scopes: z.array(scopeSchema).min(1).max(8).optional().describe('Scopes for the new key. Omit to copy the calling key scopes. Cannot exceed the calling key scopes. billing:read and billing:write allow managing the posterly subscription (cancel/pause/resume/downgrade).'),

package/src/tools/create-connect-session.ts

@@ -6,7 +6,7 @@ import { CONNECT_INPUTS } from '../generated/platform-manifest.js';
 export const createConnectSessionTool = {
   name: 'create_connect_session',
   description:
-    'Create a short-lived Posterly dashboard handoff session for connecting a social account. Send the secure connection URL to the user, then poll get_connect_session to narrate progress. Do not ask for social media passwords or OAuth codes; Posterly handles those browser steps.',
+    'Create a short-lived posterly dashboard handoff session for connecting a social account. Send the secure connection URL to the user, then poll get_connect_session to narrate progress. Do not ask for social media passwords or OAuth codes; posterly handles those browser steps.',
   inputSchema: z.object({
     platform: z
       .enum(CONNECT_INPUTS)
@@ -38,7 +38,7 @@ export const createConnectSessionTool = {
 function formatConnectSession(session: ConnectSession, includeRaw: boolean): string {
   const connected = session.connected_count ?? session.connected_accounts?.length ?? 0;
   return [
-    `Posterly connect session created: ${session.id}`,
+    `posterly connect session created: ${session.id}`,
     `Platform: ${session.platform}`,
     `Status: ${session.status}`,
     `Message: ${session.status_message}`,
@@ -49,7 +49,7 @@ function formatConnectSession(session: ConnectSession, includeRaw: boolean): str
     `Expires: ${formatLocalDateTime(session.expires_at)}`,
     `Dashboard connect page: ${DASHBOARD_CONNECT_URL}`,
     '',
-    'Next step for the AI agent: send the secure connection URL to the user, explain that Posterly will handle the browser OAuth step, then poll get_connect_session until the account is connected or the session ends.',
+    'Next step for the AI agent: send the secure connection URL to the user, explain that posterly will handle the browser OAuth step, then poll get_connect_session until the account is connected or the session ends.',
     includeRaw ? `\nRaw connect session:\n${JSON.stringify(session, null, 2)}` : '',
   ].filter(Boolean).join('\n');
 }