posterly-mcp-server 0.45.3 → 0.47.0

package/README.md

@@ -35,6 +35,7 @@ name is `io.github.awpthorp/posterly`, matching this package's `mcpName`.
 - Node.js `20+`
 - No API key is required for the public setup tools: `whoami` with `view: "status"`, `get_agent_signup_info`, `start_signup`, and `get_signup_session`
 - A posterly account, API add-on, and API key are required for authenticated tools like `whoami`, `list_accounts`, `create_connect_session`, and `create_post`
+- A teammate does not need their own add-on when the workspace owner turned on **API and AI access** for them in Team settings: their key then works in that workspace, billed to the owner's plan ([Teammates and API access](https://www.poster.ly/docs/integrations/api#teammates-and-api-access))
 
 ## Install
 
@@ -122,7 +123,7 @@ Add the same server definition to your Cursor MCP settings:
 
 ## Available tools
 
-`posterly-mcp-server@0.45.3` exposes 62 tools covering 94 actions. The hosted HTTP endpoint exposes the same catalog minus the three signup tools: 59 tools covering 91 actions.
+`posterly-mcp-server@0.47.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.
 
@@ -210,13 +211,14 @@ Accounts, posting, media, schedule, analytics, and support. What most assistants
 | `edit` (default) | Edit caption, media, schedule, or settings |
 | `status` (pass `status`) | Pause, resume, schedule, or move to draft |
 | `release_id` (pass `release_id`) | Set a release or group ID |
+| `approval` (pass `approval_action`) | Request, approve, request changes, or reject client review (owner or admin only) |
 
 **`delete_post`**: Delete posts
 
 | Mode (picked by params) | What it does |
 | --- | --- |
-| `post` (default) | Delete one post |
-| `group` (pass `group_id`) | Delete a post group (preview then confirm) |
+| `post` (default) | Delete one post. Published Instagram or Facebook posts also need `confirm_published` |
+| `group` (pass `group_id`) | Delete a post group (preview then confirm). Never deletes published posts |
 
 **`upload_media`**: Upload media
 
@@ -335,7 +337,7 @@ API keys, OAuth clients, webhooks, and workspace members.
 | Action | What it does |
 | --- | --- |
 | `invite` | Invite a colleague (preview then confirm) |
-| `update` | Change role or brands (preview then confirm) |
+| `update` | Change role or brands, or turn a teammate's API and AI access on or off (preview then confirm) |
 | `remove` | Remove a member or invite (preview then confirm) |
 
 **`manage_oauth_client`**: Manage an OAuth client

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

@@ -145,6 +145,7 @@ export interface ApiPostApproval {
     asset_status: ApiPostApprovalStatus;
     caption_status: ApiPostApprovalStatus;
     waiting_on: 'client' | 'team' | null;
+    pending_client_approval: boolean;
     requested_at: string | null;
     completed_at: string | null;
 }
@@ -341,6 +342,14 @@ export type WorkspaceMemberSummary = {
     status: string | null;
     /** [] = every brand; missing = not visible to a brand-limited caller. */
     brand_ids?: string[];
+    /** Can this teammate use the workspace's API and AI app access. Always true for the owner. */
+    api_access?: boolean;
+    /** Owners and admins only: live keys and AI app connections for this workspace. */
+    api_usage?: {
+        key_count: number;
+        last_used_at: string | null;
+        connected_apps: string[];
+    };
     joined_at: string | null;
     created_at: string | null;
 };
@@ -375,6 +384,9 @@ export type WorkspaceMemberPreview = {
     counts_toward_seats: boolean;
     seats_used: number | null;
     seat_limit: number | null;
+    /** action=set_api_access only. */
+    api_access?: boolean;
+    previous_api_access?: boolean | null;
 };
 export type WorkspaceMemberChangeResponse = {
     requires_confirmation?: boolean;
@@ -1097,6 +1109,7 @@ export declare class PosterlyClient {
     }, data: {
         role?: WorkspaceMemberRole;
         brand_ids?: string[];
+        api_access?: boolean;
     } & WorkspaceMemberConfirmFields): Promise<WorkspaceMemberChangeResponse>;
     removeWorkspaceMember(workspaceId: string, target: {
         member_id?: string;
@@ -1200,6 +1213,7 @@ export declare class PosterlyClient {
         offset?: number;
         workspace_id?: string;
         approval_status?: string;
+        approval_waiting_on?: string;
         brand_id?: string;
     }): Promise<{
         posts: Post[];
@@ -1232,10 +1246,18 @@ export declare class PosterlyClient {
     }): Promise<{
         post: Post;
     }>;
-    deletePost(id: number): Promise<{
+    deletePost(id: number, options?: {
+        confirmPublished?: boolean;
+    }): Promise<{
         deleted: boolean;
         id: number;
+        platform_delete?: string;
     }>;
+    setPostApproval(id: number, data: {
+        action: 'request' | 'approve' | 'request_changes' | 'reject';
+        axis?: 'asset' | 'caption';
+        note?: string;
+    }): Promise<Record<string, unknown>>;
     updatePostStatus(id: number, data: {
         status: 'scheduled' | 'paused' | 'draft';
         scheduled_at?: string;
@@ -1256,6 +1278,7 @@ export declare class PosterlyClient {
         quality?: 'low' | 'medium' | 'high';
         thinking_level?: 'minimal' | 'high';
         reference_image_urls?: string[];
+        workspace_id?: string;
     }): Promise<{
         job_id: string;
         status: string;
@@ -1295,6 +1318,7 @@ export declare class PosterlyClient {
         }>;
         generate_audio?: boolean;
         source_video_url?: string;
+        workspace_id?: string;
     }): Promise<Record<string, any>>;
     getVideoJob(params?: {
         job_id?: string;
@@ -1458,7 +1482,7 @@ export declare class PosterlyClient {
     getXPostingQuota(params?: {
         workspace_id?: string;
     }): Promise<XPostingQuotaResponse>;
-    getSignedUploadUrl(filename: string, contentType: string, size: number): Promise<{
+    getSignedUploadUrl(filename: string, contentType: string, size: number, workspaceId?: string): Promise<{
         upload_url: string;
         token: string;
         path: string;
@@ -1468,6 +1492,7 @@ export declare class PosterlyClient {
     createMediaDrop(input?: {
         filename?: string;
         maxFiles?: number;
+        workspaceId?: string;
     }): Promise<{
         session_id: string;
         drop_url: string;
@@ -1497,6 +1522,7 @@ export declare class PosterlyClient {
         base64Data?: string;
         filename: string;
         contentType?: string;
+        workspaceId?: string;
     }): Promise<{
         url: string;
         path: string;
@@ -1505,6 +1531,7 @@ export declare class PosterlyClient {
         url: string;
         filename?: string;
         contentType?: string;
+        workspaceId?: string;
     }): Promise<{
         url: string;
         path: string;

package/dist/lib/api-client.js

@@ -340,6 +340,8 @@ export class PosterlyClient {
             searchParams.set('workspace_id', params.workspace_id);
         if (params?.approval_status)
             searchParams.set('approval_status', params.approval_status);
+        if (params?.approval_waiting_on)
+            searchParams.set('approval_waiting_on', params.approval_waiting_on);
         if (params?.brand_id)
             searchParams.set('brand_id', params.brand_id);
         const qs = searchParams.toString();
@@ -375,8 +377,16 @@ export class PosterlyClient {
     async updatePost(id, data) {
         return this.request('PATCH', `/posts/${id}`, data);
     }
-    async deletePost(id) {
-        return this.request('DELETE', `/posts/${id}`);
+    async deletePost(id, options) {
+        const qs = options?.confirmPublished ? '?confirm_published=true' : '';
+        return this.request('DELETE', `/posts/${id}${qs}`);
+    }
+    async setPostApproval(id, data) {
+        return this.request('POST', `/posts/${id}/approval`, {
+            action: data.action,
+            ...(data.axis ? { axis: data.axis } : {}),
+            ...(data.note ? { note: data.note } : {}),
+        });
     }
     async updatePostStatus(id, data) {
         return this.request('PUT', `/posts/${id}/status`, data);
@@ -597,17 +607,19 @@ export class PosterlyClient {
         const qs = searchParams.toString();
         return this.request('GET', `/x-posting/quota${qs ? `?${qs}` : ''}`);
     }
-    async getSignedUploadUrl(filename, contentType, size) {
+    async getSignedUploadUrl(filename, contentType, size, workspaceId) {
         return this.request('POST', '/media/signed-upload', {
             filename,
             content_type: contentType,
             size,
+            ...(workspaceId ? { workspace_id: workspaceId } : {}),
         });
     }
     async createMediaDrop(input) {
         return this.request('POST', '/media/drop-sessions', {
             filename: input?.filename,
             max_files: input?.maxFiles,
+            ...(input?.workspaceId ? { workspace_id: input.workspaceId } : {}),
         });
     }
     async listMedia(params) {
@@ -636,7 +648,7 @@ export class PosterlyClient {
         const SIZE_THRESHOLD = 3 * 1024 * 1024; // 3MB
         if (fileBuffer.length > SIZE_THRESHOLD) {
             // Large file: PUT to the object-storage signed URL (not a Vercel relay).
-            const signed = await this.getSignedUploadUrl(input.filename, contentType, fileBuffer.length);
+            const signed = await this.getSignedUploadUrl(input.filename, contentType, fileBuffer.length, input.workspaceId);
             const uploadRes = await fetch(signed.upload_url, {
                 method: 'PUT',
                 headers: {
@@ -657,6 +669,7 @@ export class PosterlyClient {
             filename: input.filename,
             data,
             content_type: contentType,
+            ...(input.workspaceId ? { workspace_id: input.workspaceId } : {}),
         });
     }
     async uploadMediaFromUrl(input) {
@@ -664,6 +677,7 @@ export class PosterlyClient {
             url: input.url,
             filename: input.filename,
             content_type: input.contentType,
+            ...(input.workspaceId ? { workspace_id: input.workspaceId } : {}),
         });
     }
     appendInboxListParams(searchParams, params) {

package/dist/lib/version.d.ts

@@ -1 +1 @@
-export declare const POSTERLY_MCP_VERSION = "0.45.3";
+export declare const POSTERLY_MCP_VERSION = "0.47.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.45.3';
+export const POSTERLY_MCP_VERSION = '0.47.0';

package/dist/tools/create-media-drop.d.ts

@@ -6,15 +6,19 @@ export declare const createMediaDropTool: {
     inputSchema: z.ZodObject<{
         filename: z.ZodOptional<z.ZodString>;
         max_files: z.ZodOptional<z.ZodNumber>;
+        workspace_id: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
+        workspace_id?: string | undefined;
         filename?: string | undefined;
         max_files?: number | undefined;
     }, {
+        workspace_id?: string | undefined;
         filename?: string | undefined;
         max_files?: number | undefined;
     }>;
     execute(client: PosterlyClient, input: {
         filename?: string;
         max_files?: number;
+        workspace_id?: string;
     }): Promise<string>;
 };

package/dist/tools/create-media-drop.js

@@ -11,11 +11,13 @@ export const createMediaDropTool = {
             .max(10)
             .optional()
             .describe('How many files the drop can accept. Default 10, max 10.'),
+        workspace_id: z.string().optional().describe('Optional. The workspace this acts in and whose plan pays (from whoami). Needed only when your connection can act in several workspaces.'),
     }),
     async execute(client, input) {
         const drop = await client.createMediaDrop({
             filename: input.filename,
             maxFiles: input.max_files,
+            workspaceId: input.workspace_id,
         });
         return [
             'Media drop created. Send this URL to the user. They open it with no posterly login and drop the file.',

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

@@ -972,11 +972,11 @@ export declare const createPostPayloadInputSchema: z.ZodObject<{
     username?: string | undefined;
     workspace_id?: string | undefined;
     account_id?: string | undefined;
+    caption?: string | undefined;
     scheduled_at?: string | undefined;
     media_url?: string | undefined;
     media_urls?: string[] | undefined;
     post_type?: string | undefined;
-    caption?: string | undefined;
     thread_posts?: string[] | undefined;
     instagram_settings?: {
         post_type?: "post" | "feed" | "story" | "reel" | "carousel" | undefined;
@@ -1135,11 +1135,11 @@ export declare const createPostPayloadInputSchema: z.ZodObject<{
     username?: string | undefined;
     workspace_id?: string | undefined;
     account_id?: string | undefined;
+    caption?: string | undefined;
     scheduled_at?: string | undefined;
     media_url?: string | undefined;
     media_urls?: string[] | undefined;
     post_type?: string | undefined;
-    caption?: string | undefined;
     thread_posts?: string[] | undefined;
     instagram_settings?: {
         post_type?: "post" | "feed" | "story" | "reel" | "carousel" | undefined;
@@ -1791,11 +1791,11 @@ export declare const createPostInputSchema: z.ZodObject<{
     username?: string | undefined;
     workspace_id?: string | undefined;
     account_id?: string | undefined;
+    caption?: string | undefined;
     scheduled_at?: string | undefined;
     media_url?: string | undefined;
     media_urls?: string[] | undefined;
     post_type?: string | undefined;
-    caption?: string | undefined;
     thread_posts?: string[] | undefined;
     instagram_settings?: {
         post_type?: "post" | "feed" | "story" | "reel" | "carousel" | undefined;
@@ -1955,11 +1955,11 @@ export declare const createPostInputSchema: z.ZodObject<{
     username?: string | undefined;
     workspace_id?: string | undefined;
     account_id?: string | undefined;
+    caption?: string | undefined;
     scheduled_at?: string | undefined;
     media_url?: string | undefined;
     media_urls?: string[] | undefined;
     post_type?: string | undefined;
-    caption?: string | undefined;
     thread_posts?: string[] | undefined;
     instagram_settings?: {
         post_type?: "post" | "feed" | "story" | "reel" | "carousel" | undefined;
@@ -2640,11 +2640,11 @@ export declare const createPostTool: {
         username?: string | undefined;
         workspace_id?: string | undefined;
         account_id?: string | undefined;
+        caption?: string | undefined;
         scheduled_at?: string | undefined;
         media_url?: string | undefined;
         media_urls?: string[] | undefined;
         post_type?: string | undefined;
-        caption?: string | undefined;
         thread_posts?: string[] | undefined;
         instagram_settings?: {
             post_type?: "post" | "feed" | "story" | "reel" | "carousel" | undefined;
@@ -2804,11 +2804,11 @@ export declare const createPostTool: {
         username?: string | undefined;
         workspace_id?: string | undefined;
         account_id?: string | undefined;
+        caption?: string | undefined;
         scheduled_at?: string | undefined;
         media_url?: string | undefined;
         media_urls?: string[] | undefined;
         post_type?: string | undefined;
-        caption?: string | undefined;
         thread_posts?: string[] | undefined;
         instagram_settings?: {
             post_type?: "post" | "feed" | "story" | "reel" | "carousel" | undefined;

package/dist/tools/create-posts-batch.d.ts

@@ -499,11 +499,11 @@ export declare const createPostsBatchTool: {
             username?: string | undefined;
             workspace_id?: string | undefined;
             account_id?: string | undefined;
+            caption?: string | undefined;
             scheduled_at?: string | undefined;
             media_url?: string | undefined;
             media_urls?: string[] | undefined;
             post_type?: string | undefined;
-            caption?: string | undefined;
             thread_posts?: string[] | undefined;
             instagram_settings?: {
                 post_type?: "post" | "feed" | "story" | "reel" | "carousel" | undefined;
@@ -662,11 +662,11 @@ export declare const createPostsBatchTool: {
             username?: string | undefined;
             workspace_id?: string | undefined;
             account_id?: string | undefined;
+            caption?: string | undefined;
             scheduled_at?: string | undefined;
             media_url?: string | undefined;
             media_urls?: string[] | undefined;
             post_type?: string | undefined;
-            caption?: string | undefined;
             thread_posts?: string[] | undefined;
             instagram_settings?: {
                 post_type?: "post" | "feed" | "story" | "reel" | "carousel" | undefined;
@@ -829,11 +829,11 @@ export declare const createPostsBatchTool: {
             username?: string | undefined;
             workspace_id?: string | undefined;
             account_id?: string | undefined;
+            caption?: string | undefined;
             scheduled_at?: string | undefined;
             media_url?: string | undefined;
             media_urls?: string[] | undefined;
             post_type?: string | undefined;
-            caption?: string | undefined;
             thread_posts?: string[] | undefined;
             instagram_settings?: {
                 post_type?: "post" | "feed" | "story" | "reel" | "carousel" | undefined;
@@ -995,11 +995,11 @@ export declare const createPostsBatchTool: {
             username?: string | undefined;
             workspace_id?: string | undefined;
             account_id?: string | undefined;
+            caption?: string | undefined;
             scheduled_at?: string | undefined;
             media_url?: string | undefined;
             media_urls?: string[] | undefined;
             post_type?: string | undefined;
-            caption?: string | undefined;
             thread_posts?: string[] | undefined;
             instagram_settings?: {
                 post_type?: "post" | "feed" | "story" | "reel" | "carousel" | undefined;

package/dist/tools/create-signed-upload.d.ts

@@ -7,18 +7,22 @@ export declare const createSignedUploadTool: {
         filename: z.ZodString;
         content_type: z.ZodString;
         size: z.ZodNumber;
+        workspace_id: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         filename: string;
         content_type: string;
         size: number;
+        workspace_id?: string | undefined;
     }, {
         filename: string;
         content_type: string;
         size: number;
+        workspace_id?: string | undefined;
     }>;
     execute(client: PosterlyClient, input: {
         filename: string;
         content_type: string;
         size: number;
+        workspace_id?: string;
     }): Promise<string>;
 };

package/dist/tools/create-signed-upload.js

@@ -6,9 +6,10 @@ export const createSignedUploadTool = {
         filename: z.string().describe('Filename with extension, e.g. launch-video.mp4'),
         content_type: z.string().describe('MIME type, e.g. video/mp4'),
         size: z.number().int().positive().describe('File size in bytes'),
+        workspace_id: z.string().optional().describe('Optional. The workspace this acts in and whose plan pays (from whoami). Needed only when your connection can act in several workspaces.'),
     }),
     async execute(client, input) {
-        const signed = await client.getSignedUploadUrl(input.filename, input.content_type, input.size);
+        const signed = await client.getSignedUploadUrl(input.filename, input.content_type, input.size, input.workspace_id);
         return [
             'Signed upload created.',
             `• Upload URL: ${signed.upload_url}`,

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;
+    confirm_published?: boolean;
     confirm?: boolean;
     preview_id?: string;
 };
@@ -13,6 +14,7 @@ export declare const deletePostTool: {
     inputSchema: z.ZodObject<{
         post_id: z.ZodOptional<z.ZodNumber>;
         group_id: z.ZodOptional<z.ZodString>;
+        confirm_published: z.ZodOptional<z.ZodBoolean>;
         confirm: z.ZodOptional<z.ZodBoolean>;
         preview_id: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
@@ -20,11 +22,13 @@ export declare const deletePostTool: {
         preview_id?: string | undefined;
         post_id?: number | undefined;
         group_id?: string | undefined;
+        confirm_published?: boolean | undefined;
     }, {
         confirm?: boolean | undefined;
         preview_id?: string | undefined;
         post_id?: number | undefined;
         group_id?: string | undefined;
+        confirm_published?: boolean | undefined;
     }>;
     /** The old tools' exact input schemas, for alias calls (see alias-transport.ts). */
     legacySchemas: {

package/dist/tools/delete-post.js

@@ -3,10 +3,14 @@ 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, and published or currently publishing posts are never deleted. post_id: delete one scheduled or draft 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"). 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; 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. 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.',
     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.'),
+        group_id: z.string().min(1).max(160).optional().describe('Delete every unpublished post in this group or release instead. Never deletes published posts.'),
+        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.'),
         confirm: z
             .boolean()
             .optional()
@@ -33,7 +37,7 @@ export const deletePostTool = {
                 // GET /api/v1/posts has no group filter, so the preview says in plain
                 // words which posts match instead of listing them.
                 describe: async () => [
-                    `Deletes every draft, scheduled, failed, or paused post whose group_id, post_group_id, api_group_id, or release_id is ${code(args.group_id)}. Published posts are never deleted. This cannot be undone.`,
+                    `Deletes every draft, scheduled, failed, or paused post whose group_id, post_group_id, api_group_id, or release_id is ${code(args.group_id)}. A group delete never removes published posts. This cannot be undone.`,
                     'To see the posts first, call list_posts and check each post\'s group or release ID.',
                 ].join('\n\n'),
                 run: async () => {
@@ -49,9 +53,10 @@ 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);
+    const result = await client.deletePost(input.post_id, { confirmPublished: input.confirm_published === true });
+    const platformDelete = result.platform_delete ? ` Platform delete: ${result.platform_delete}.` : '';
     return [
-        `Post #${result.id} deleted successfully.`,
+        `Post #${result.id} deleted successfully.${platformDelete}`,
         'It has been removed from the posterly queue.',
         `View queue in posterly: ${dashboardUrlForPosts()}`,
         '',

package/dist/tools/generate-image.d.ts

@@ -14,10 +14,12 @@ export declare const generateImageTool: {
         quality: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
         thinking_level: z.ZodOptional<z.ZodEnum<["minimal", "high"]>>;
         reference_image_urls: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        workspace_id: z.ZodOptional<z.ZodString>;
         confirm: z.ZodLiteral<true>;
     }, "strip", z.ZodTypeAny, {
         confirm: true;
         prompt: string;
+        workspace_id?: string | undefined;
         provider?: "google" | "xai" | undefined;
         aspect_ratio?: "1:1" | "16:9" | "9:16" | "4:3" | "3:4" | "3:2" | "2:3" | "4:5" | "1:4" | "1:8" | "21:9" | "4:1" | "8:1" | "5:4" | undefined;
         resolution?: "512" | "1K" | "2K" | "4K" | undefined;
@@ -30,6 +32,7 @@ export declare const generateImageTool: {
     }, {
         confirm: true;
         prompt: string;
+        workspace_id?: string | undefined;
         provider?: "google" | "xai" | undefined;
         aspect_ratio?: "1:1" | "16:9" | "9:16" | "4:3" | "3:4" | "3:2" | "2:3" | "4:5" | "1:4" | "1:8" | "21:9" | "4:1" | "8:1" | "5:4" | undefined;
         resolution?: "512" | "1K" | "2K" | "4K" | undefined;
@@ -51,6 +54,7 @@ export declare const generateImageTool: {
         quality?: "low" | "medium" | "high";
         thinking_level?: "minimal" | "high";
         reference_image_urls?: string[];
+        workspace_id?: string;
         confirm: true;
     }): Promise<string>;
 };

package/dist/tools/generate-image.js

@@ -62,6 +62,7 @@ export const generateImageTool = {
             .max(14)
             .optional()
             .describe('Google only. Up to 14 HTTPS image URLs used as references (logo, product, style lock). Same as dashboard reference images.'),
+        workspace_id: z.string().optional().describe('Optional. The workspace this acts in and whose plan pays (from whoami). Needed only when your connection can act in several workspaces.'),
         confirm: z.literal(true).describe('Must be true after explicit user confirmation of subject, style, aspect ratio, quality, and credit use.'),
     }),
     async execute(client, input) {

package/dist/tools/generate-video.d.ts

@@ -25,10 +25,12 @@ export declare const generateVideoTool: {
         }>, "many">>;
         generate_audio: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
         source_video_url: z.ZodOptional<z.ZodString>;
+        workspace_id: z.ZodOptional<z.ZodString>;
         confirm: z.ZodLiteral<true>;
     }, "strip", z.ZodTypeAny, {
         confirm: true;
         prompt: string;
+        workspace_id?: string | undefined;
         provider?: "google" | "xai" | undefined;
         negative_prompt?: string | undefined;
         aspect_ratio?: "1:1" | "16:9" | "9:16" | "4:3" | "3:4" | "3:2" | "2:3" | undefined;
@@ -46,6 +48,7 @@ export declare const generateVideoTool: {
     }, {
         confirm: true;
         prompt: string;
+        workspace_id?: string | undefined;
         provider?: "google" | "xai" | undefined;
         negative_prompt?: string | undefined;
         aspect_ratio?: "1:1" | "16:9" | "9:16" | "4:3" | "3:4" | "3:2" | "2:3" | undefined;

package/dist/tools/generate-video.js

@@ -18,6 +18,7 @@ export const generateVideoTool = {
         })).max(3).optional(),
         generate_audio: z.boolean().default(true).optional().describe('Google can disable generated audio. xAI Grok includes audio and requires this to remain true.'),
         source_video_url: z.string().url().optional(),
+        workspace_id: z.string().optional().describe('Optional. The workspace this acts in and whose plan pays (from whoami). Needed only when your connection can act in several workspaces.'),
         confirm: z.literal(true).describe('Must be true after explicit user confirmation of prompt, model, duration, resolution, and credit cost.'),
     }),
     async execute(client, input) {

package/dist/tools/list-analytics.js

@@ -4,7 +4,7 @@ import { validateArgs } from '../lib/tool-runtime.js';
 const presentationSchema = z.enum(['compact', 'table', 'json']).optional();
 export const listAnalyticsTool = {
     name: 'list_analytics',
-    description: 'Analytics for connected social accounts (Instagram, Facebook, LinkedIn, Google Business Profile, Pinterest, YouTube, and Threads). view=accounts (account_id): daily snapshots and a period summary with platform-native display_metrics labels. view=posts (account_id): per-post likes, comments/replies, reach, impressions/views, saves, shares, reposts, quotes, plays, clicks, and watch time, most recent first, with limit/offset. view=insights: per-post feedback insights with a performance tier (great/good/mixed/poor), diagnosis, next action, and baseline, filtered by account_id, post_id, or checkpoint (1h, 6h, 24h, 72h, 7d); read-only, Pro plan or higher. presentation (accounts and posts): compact for Telegram/mobile, table for Markdown clients, json for custom chart/card renderers.',
+    description: 'Analytics for connected social accounts (Instagram, Facebook, LinkedIn, Google Business Profile, Pinterest, YouTube, and Threads). view=accounts (account_id): daily snapshots and a period summary with platform-native display_metrics labels. Google Business Profile account analytics includes Calls, Website clicks, and Directions along with Profile Views, Search Views, Maps Views, Customer Actions, and Posts. view=posts (account_id): per-post likes, comments/replies, reach, impressions/views, saves, shares, reposts, quotes, plays, clicks, and watch time, most recent first, with limit/offset. view=insights: per-post feedback insights with a performance tier (great/good/mixed/poor), diagnosis, next action, and baseline, filtered by account_id, post_id, or checkpoint (1h, 6h, 24h, 72h, 7d); read-only, Pro plan or higher. presentation (accounts and posts): compact for Telegram/mobile, table for Markdown clients, json for custom chart/card renderers.',
     inputSchema: z.object({
         view: z.enum(['accounts', 'posts', 'insights']).describe('accounts, posts, or insights.'),
         account_id: z
@@ -150,6 +150,9 @@ function accountMetricRows(summary, platform) {
             ['Search Views', formatNumber(metrics.search_views ?? summary.total_reach)],
             ['Maps Views', formatNumber(metrics.maps_views ?? summary.total_profile_views)],
             ['Customer Actions', formatNumber(metrics.customer_actions ?? summary.total_accounts_engaged)],
+            ['Calls', formatNumber(metrics.call_clicks ?? summary.total_call_clicks)],
+            ['Directions', formatNumber(metrics.direction_requests ?? summary.total_direction_requests)],
+            ['Website clicks', formatNumber(metrics.website_clicks ?? summary.total_website_clicks)],
             ['Posts', formatNumber(metrics.posts ?? summary.current_media_count)],
         ];
     }

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

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