posterly-mcp-server 0.8.3 → 0.19.0

package/dist/tools/create-oauth-client.js

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+const scopeSchema = z.enum(['accounts:read', 'accounts:write', 'posts:read', 'posts:write', 'media:write', 'analytics:read']);
+export const createOAuthClientTool = {
+    name: 'create_oauth_client',
+    description: 'Create a public OAuth 2.1 + PKCE developer client. WRITE: confirm app name, redirect URIs, and scopes with the user before calling.',
+    inputSchema: z.object({
+        client_name: z.string().min(1).max(120),
+        description: z.string().max(500).optional(),
+        homepage: z.string().url().optional(),
+        allowed_redirect_uris: z.array(z.string().url()).min(1).max(10),
+        default_scopes: z.array(scopeSchema).min(1),
+        is_active: z.boolean().optional(),
+        confirm: z.literal(true).describe('Must be true after explicit user confirmation.'),
+    }),
+    async execute(client, input) {
+        const { confirm: _confirm, ...payload } = input;
+        const result = await client.createOAuthClient(payload);
+        return `OAuth client created: ${result.client.client_name}\nclient_id: ${result.client.client_id}\nRedirect URIs: ${result.client.allowed_redirect_uris.join(', ')}`;
+    },
+};

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

@@ -222,7 +222,7 @@ export declare const platformSettingsSchema: z.ZodObject<{
 export declare const createPostInputSchema: z.ZodObject<{
     account_id: z.ZodOptional<z.ZodString>;
     username: z.ZodOptional<z.ZodString>;
-    platform: z.ZodOptional<z.ZodString>;
+    platform: z.ZodOptional<z.ZodEnum<["bluesky", "facebook", "gmb", "google-business", "google_business", "google_business_profile", "instagram", "instagram-standalone", "linkedin", "pinterest", "telegram", "threads", "tiktok", "twitter", "x", "youtube"]>>;
     caption: z.ZodOptional<z.ZodString>;
     scheduled_at: z.ZodOptional<z.ZodString>;
     media_url: z.ZodOptional<z.ZodString>;
@@ -451,7 +451,7 @@ export declare const createPostInputSchema: z.ZodObject<{
     workspace_id: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     workspace_id?: string | undefined;
-    platform?: string | undefined;
+    platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "linkedin" | "youtube" | "pinterest" | "threads" | "google_business" | "telegram" | "bluesky" | "gmb" | "google-business" | "google_business_profile" | "x" | undefined;
     account_id?: string | undefined;
     post_type?: string | undefined;
     username?: string | undefined;
@@ -531,7 +531,7 @@ export declare const createPostInputSchema: z.ZodObject<{
     }, z.ZodTypeAny, "passthrough"> | undefined;
 }, {
     workspace_id?: string | undefined;
-    platform?: string | undefined;
+    platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "linkedin" | "youtube" | "pinterest" | "threads" | "google_business" | "telegram" | "bluesky" | "gmb" | "google-business" | "google_business_profile" | "x" | undefined;
     account_id?: string | undefined;
     post_type?: string | undefined;
     username?: string | undefined;
@@ -618,7 +618,7 @@ export declare const createPostTool: {
     inputSchema: z.ZodObject<{
         account_id: z.ZodOptional<z.ZodString>;
         username: z.ZodOptional<z.ZodString>;
-        platform: z.ZodOptional<z.ZodString>;
+        platform: z.ZodOptional<z.ZodEnum<["bluesky", "facebook", "gmb", "google-business", "google_business", "google_business_profile", "instagram", "instagram-standalone", "linkedin", "pinterest", "telegram", "threads", "tiktok", "twitter", "x", "youtube"]>>;
         caption: z.ZodOptional<z.ZodString>;
         scheduled_at: z.ZodOptional<z.ZodString>;
         media_url: z.ZodOptional<z.ZodString>;
@@ -847,7 +847,7 @@ export declare const createPostTool: {
         workspace_id: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         workspace_id?: string | undefined;
-        platform?: string | undefined;
+        platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "linkedin" | "youtube" | "pinterest" | "threads" | "google_business" | "telegram" | "bluesky" | "gmb" | "google-business" | "google_business_profile" | "x" | undefined;
         account_id?: string | undefined;
         post_type?: string | undefined;
         username?: string | undefined;
@@ -927,7 +927,7 @@ export declare const createPostTool: {
         }, z.ZodTypeAny, "passthrough"> | undefined;
     }, {
         workspace_id?: string | undefined;
-        platform?: string | undefined;
+        platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "linkedin" | "youtube" | "pinterest" | "threads" | "google_business" | "telegram" | "bluesky" | "gmb" | "google-business" | "google_business_profile" | "x" | undefined;
         account_id?: string | undefined;
         post_type?: string | undefined;
         username?: string | undefined;
@@ -1006,18 +1006,5 @@ export declare const createPostTool: {
             langs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         }, z.ZodTypeAny, "passthrough"> | undefined;
     }>;
-    execute(client: PosterlyClient, input: {
-        account_id?: string;
-        username?: string;
-        platform?: string;
-        caption?: string;
-        scheduled_at?: string;
-        media_url?: string;
-        media_urls?: string[];
-        post_type?: string;
-        thread_posts?: string[];
-        instagram_settings?: z.infer<typeof instagramSettingsSchema>;
-        platform_settings?: z.infer<typeof platformSettingsSchema>;
-        workspace_id?: string;
-    }): Promise<string>;
+    execute(client: PosterlyClient, input: CreatePostInput): Promise<string>;
 };

package/dist/tools/create-post.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { SUPPORTED_PLATFORM_INPUTS, SUPPORTED_PLATFORM_IDS } from '../generated/platform-manifest.js';
 export const instagramSettingsSchema = z.object({
     __type: z.enum(['instagram', 'instagram-standalone']).optional(),
     post_type: z.enum(['post', 'feed', 'story', 'reel', 'carousel']).optional(),
@@ -71,9 +72,9 @@ export const createPostInputSchema = z.object({
     account_id: z.string().optional().describe('Social account ID (from list_accounts)'),
     username: z.string().optional().describe('Account username (alternative to account_id)'),
     platform: z
-        .string()
+        .enum(SUPPORTED_PLATFORM_INPUTS)
         .optional()
-        .describe('Platform name (required with username): instagram, twitter, linkedin, facebook, tiktok, threads, youtube, pinterest, google_business'),
+        .describe(`Platform name (required with username). Supported: ${SUPPORTED_PLATFORM_IDS.join(', ')}. Aliases such as x, gmb, and instagram-standalone are accepted.`),
     caption: z.string().optional().describe('The post caption/text content. Ignored when `thread_posts` is provided.'),
     scheduled_at: z
         .string()
@@ -150,7 +151,7 @@ export const createPostTool = {
         '4. If scheduling multiple posts in one turn, list every post first and confirm the batch as a whole, then prefer `create_posts_batch` so they are created in one API request.\n\n' +
         'Provide either account_id OR username+platform to identify the account. If scheduled_at is omitted, the post publishes immediately. If workspace_id is omitted, the server resolves one from the social account, falling back to the caller\'s default (personal) workspace — pass workspace_id explicitly if the user has more than one workspace.\n\n' +
         'THREADS: Pass `thread_posts` (an array of 2+ strings) to schedule a multi-post thread on X (Twitter) or Threads (Meta). The first entry is the lead post; the rest are published as replies in the same chain. X entries are capped at 280 characters each (4000 for verified, 25000 for organization accounts); Threads entries are capped at 500 characters each. When `thread_posts` is set, `caption` is ignored.\n\n' +
-        'PLATFORM SETTINGS: Pass `platform_settings` for composer-equivalent controls: Facebook story/reel/backgrounds, YouTube title/privacy/thumbnail/playlist, LinkedIn document titles/mentions/video thumbnails, TikTok direct-post privacy/toggles/commercial disclosure, Pinterest board/link/title/video cover, GBP event/offer/CTA, X reply settings/polls, Threads reply controls/text attachments, Bluesky languages/alt text, and Instagram feed/story/reel/carousel/collaborators/first comments/trial Reels. `instagram_settings` remains as a backwards-compatible alias.',
+        'PLATFORM SETTINGS: Pass `platform_settings` for composer-equivalent controls: Facebook story/reel/backgrounds, YouTube title/privacy/thumbnail/playlist, LinkedIn document titles/mentions/video thumbnails, TikTok direct-post privacy/toggles/commercial disclosure, Pinterest post_type (image/video/carousel), board (from pinterest.boards helper), title, link, and cover_image_url (video Pins), GBP event/offer/CTA, X reply settings/polls, Threads reply controls/text attachments, Bluesky languages/alt text, and Instagram feed/story/reel/carousel/collaborators/first comments/trial Reels. `instagram_settings` remains as a backwards-compatible alias.',
     inputSchema: createPostInputSchema,
     async execute(client, input) {
         const payload = buildCreatePostPayload(input);

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

@@ -8,7 +8,7 @@ export declare const createPostsBatchTool: {
         posts: z.ZodArray<z.ZodObject<{
             account_id: z.ZodOptional<z.ZodString>;
             username: z.ZodOptional<z.ZodString>;
-            platform: z.ZodOptional<z.ZodString>;
+            platform: z.ZodOptional<z.ZodEnum<["bluesky", "facebook", "gmb", "google-business", "google_business", "google_business_profile", "instagram", "instagram-standalone", "linkedin", "pinterest", "telegram", "threads", "tiktok", "twitter", "x", "youtube"]>>;
             caption: z.ZodOptional<z.ZodString>;
             scheduled_at: z.ZodOptional<z.ZodString>;
             media_url: z.ZodOptional<z.ZodString>;
@@ -237,7 +237,7 @@ export declare const createPostsBatchTool: {
             workspace_id: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
             workspace_id?: string | undefined;
-            platform?: string | undefined;
+            platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "linkedin" | "youtube" | "pinterest" | "threads" | "google_business" | "telegram" | "bluesky" | "gmb" | "google-business" | "google_business_profile" | "x" | undefined;
             account_id?: string | undefined;
             post_type?: string | undefined;
             username?: string | undefined;
@@ -317,7 +317,7 @@ export declare const createPostsBatchTool: {
             }, z.ZodTypeAny, "passthrough"> | undefined;
         }, {
             workspace_id?: string | undefined;
-            platform?: string | undefined;
+            platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "linkedin" | "youtube" | "pinterest" | "threads" | "google_business" | "telegram" | "bluesky" | "gmb" | "google-business" | "google_business_profile" | "x" | undefined;
             account_id?: string | undefined;
             post_type?: string | undefined;
             username?: string | undefined;
@@ -399,7 +399,7 @@ export declare const createPostsBatchTool: {
     }, "strip", z.ZodTypeAny, {
         posts: {
             workspace_id?: string | undefined;
-            platform?: string | undefined;
+            platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "linkedin" | "youtube" | "pinterest" | "threads" | "google_business" | "telegram" | "bluesky" | "gmb" | "google-business" | "google_business_profile" | "x" | undefined;
             account_id?: string | undefined;
             post_type?: string | undefined;
             username?: string | undefined;
@@ -481,7 +481,7 @@ export declare const createPostsBatchTool: {
     }, {
         posts: {
             workspace_id?: string | undefined;
-            platform?: string | undefined;
+            platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "linkedin" | "youtube" | "pinterest" | "threads" | "google_business" | "telegram" | "bluesky" | "gmb" | "google-business" | "google_business_profile" | "x" | undefined;
             account_id?: string | undefined;
             post_type?: string | undefined;
             username?: string | undefined;

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

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+import type { PosterlyClient } from '../lib/api-client.js';
+export declare const createSignedUploadTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        filename: z.ZodString;
+        content_type: z.ZodString;
+        size: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        content_type: string;
+        filename: string;
+        size: number;
+    }, {
+        content_type: string;
+        filename: string;
+        size: number;
+    }>;
+    execute(client: PosterlyClient, input: {
+        filename: string;
+        content_type: string;
+        size: number;
+    }): Promise<string>;
+};

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

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+export const createSignedUploadTool = {
+    name: 'create_signed_upload',
+    description: 'Create a signed direct-upload URL for a larger image or video. Upload the binary to upload_url, then use public_url with create_post.',
+    inputSchema: z.object({
+        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'),
+    }),
+    async execute(client, input) {
+        const signed = await client.getSignedUploadUrl(input.filename, input.content_type, input.size);
+        return [
+            'Signed upload created.',
+            `• Upload URL: ${signed.upload_url}`,
+            `• Token: ${signed.token}`,
+            `• Storage path: ${signed.path}`,
+            `• Public URL after upload: ${signed.public_url}`,
+        ].join('\n');
+    },
+};

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

@@ -0,0 +1,36 @@
+import { z } from 'zod';
+import type { PosterlyClient } from '../lib/api-client.js';
+export declare const createWebhookTool: {
+    name: string;
+    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">>;
+        workspace_id: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        is_active: z.ZodOptional<z.ZodBoolean>;
+        confirm: z.ZodLiteral<true>;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        confirm: true;
+        workspace_id?: string | undefined;
+        events?: ("webhook.test" | "post.created" | "post.updated" | "post.deleted" | "post.publishing" | "post.published" | "post.failed" | "account.disconnected" | "analytics.synced")[] | undefined;
+        description?: string | undefined;
+        is_active?: boolean | undefined;
+    }, {
+        url: string;
+        confirm: true;
+        workspace_id?: string | undefined;
+        events?: ("webhook.test" | "post.created" | "post.updated" | "post.deleted" | "post.publishing" | "post.published" | "post.failed" | "account.disconnected" | "analytics.synced")[] | undefined;
+        description?: string | undefined;
+        is_active?: boolean | undefined;
+    }>;
+    execute(client: PosterlyClient, input: {
+        url: string;
+        events?: string[];
+        workspace_id?: string;
+        description?: string;
+        is_active?: boolean;
+        confirm: true;
+    }): Promise<string>;
+};

package/dist/tools/create-webhook.js

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+import { webhookEventSchema } from './webhook-events.js';
+export const createWebhookTool = {
+    name: 'create_webhook',
+    description: 'Create a webhook subscription for post/account/analytics events. WRITE WITH OUTBOUND SIDE EFFECTS: show the user the target URL, workspace, events, and active state, then get explicit confirmation before calling. The response includes the signing secret once.',
+    inputSchema: z.object({
+        url: z.string().url().describe('HTTPS webhook endpoint URL. Localhost HTTP is allowed by the API for development.'),
+        events: z.array(webhookEventSchema).optional().describe('Events to deliver. Defaults to core post lifecycle events.'),
+        workspace_id: z.string().optional().describe('Optional workspace filter. Omit for all workspaces owned by the API key user.'),
+        description: z.string().max(240).optional(),
+        is_active: z.boolean().optional().describe('Defaults to true.'),
+        confirm: z.literal(true).describe('Must be true after the user explicitly confirms webhook creation.'),
+    }),
+    async execute(client, input) {
+        const { confirm: _confirm, ...payload } = input;
+        const result = await client.createWebhook(payload);
+        const secret = result.secret ? `\nSigning secret: ${result.secret}` : '';
+        return `Webhook created: ${result.webhook.id}\nURL: ${result.webhook.url}\nEvents: ${result.webhook.events.join(', ')}${secret}`;
+    },
+};

package/dist/tools/delete-google-business-review-reply.d.ts

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

package/dist/tools/delete-google-business-review-reply.js

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+export const deleteGoogleBusinessReviewReplyTool = {
+    name: 'delete_google_business_review_reply',
+    description: 'Delete the owner reply from a Google Business Profile review. DESTRUCTIVE: confirm the review and location with the user, then pass confirm=true only after explicit confirmation.',
+    inputSchema: z.object({
+        workspace_id: z.string().optional().describe('Filter to a workspace ID from whoami.'),
+        account_id: z.number().int().positive().optional().describe('Google Business account ID from list_accounts.'),
+        location_id: z.string().optional().describe('Google Business location/platform_user_id.'),
+        review_name: z.string().min(1).describe('Full Google review resource name.'),
+        confirm: z.literal(true).describe('Must be true after explicit user confirmation.'),
+    }),
+    async execute(client, input) {
+        const { confirm: _confirm, ...payload } = input;
+        const result = await client.deleteGoogleBusinessReviewReply(payload);
+        return result.message || 'Google Business review reply deleted successfully.';
+    },
+};

package/dist/tools/delete-oauth-client.d.ts

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

package/dist/tools/delete-oauth-client.js

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+export const deleteOAuthClientTool = {
+    name: 'delete_oauth_client',
+    description: 'Delete a self-serve OAuth developer client. DESTRUCTIVE: prevents new authorizations for that client_id; existing access tokens remain revocable as API keys.',
+    inputSchema: z.object({
+        client_id: z.string().min(1),
+        confirm: z.literal(true).describe('Must be true after explicit user confirmation.'),
+    }),
+    async execute(client, input) {
+        const result = await client.deleteOAuthClient(input.client_id);
+        return `OAuth client deleted: ${result.client_id}`;
+    },
+};

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

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

package/dist/tools/delete-post-group.js

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+export const deletePostGroupTool = {
+    name: 'delete_post_group',
+    description: 'Delete every draft/scheduled/failed/paused post matching a caller-defined group_id, post_group_id, api_group_id, or release_id. DESTRUCTIVE: inspect the group first, list the affected posts, and pass confirm=true only after explicit confirmation.',
+    inputSchema: z.object({
+        group_id: z.string().min(1).max(160).describe('Group/release ID to delete.'),
+        confirm: z.literal(true).describe('Must be true after explicit user confirmation.'),
+    }),
+    async execute(client, input) {
+        const result = await client.deletePostGroup(input.group_id);
+        return JSON.stringify(result, null, 2);
+    },
+};

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

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

package/dist/tools/delete-webhook.js

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+export const deleteWebhookTool = {
+    name: 'delete_webhook',
+    description: 'Delete a webhook subscription. DESTRUCTIVE: list the webhook first, show the user its URL/events/workspace, and get explicit confirmation before calling.',
+    inputSchema: z.object({
+        webhook_id: z.string().describe('Webhook ID from list_webhooks.'),
+        confirm: z.literal(true).describe('Must be true after the user explicitly confirms webhook deletion.'),
+    }),
+    async execute(client, input) {
+        const result = await client.deleteWebhook(input.webhook_id);
+        return `Webhook deleted: ${result.id}`;
+    },
+};

package/dist/tools/disconnect-account.d.ts

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+import type { PosterlyClient } from '../lib/api-client.js';
+export declare const disconnectAccountTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        account_id: z.ZodString;
+        confirm: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        account_id: string;
+        confirm: boolean;
+    }, {
+        account_id: string;
+        confirm: boolean;
+    }>;
+    execute(client: PosterlyClient, input: {
+        account_id: string;
+        confirm: boolean;
+    }): Promise<string>;
+};

package/dist/tools/disconnect-account.js

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+export const disconnectAccountTool = {
+    name: 'disconnect_account',
+    description: 'Disconnect a connected social account from posterly. DESTRUCTIVE and IRREVERSIBLE: removes the account connection, emits account.disconnected webhooks, and may transfer Instagram scheduled posts to a replacement account.\n\n' +
+        'REQUIRED BEFORE CALLING: Call `list_accounts` first, show the user the exact platform, username, account ID, and workspace that will be disconnected, then get explicit confirmation. Pass confirm=true only after that confirmation.',
+    inputSchema: z.object({
+        account_id: z.string().describe('Connected social account ID from list_accounts.'),
+        confirm: z.boolean().describe('Must be true after explicit user confirmation.'),
+    }),
+    async execute(client, input) {
+        if (input.confirm !== true) {
+            throw new Error('Refusing to disconnect account without confirm=true after explicit user confirmation.');
+        }
+        const result = await client.disconnectAccount(input.account_id);
+        const account = result.account || {};
+        return [
+            `Disconnected ${account.platform || 'account'}${account.username ? ` @${account.username}` : ''} (ID: ${account.id || input.account_id}).`,
+            `Transferred posts: ${result.transferred_post_count ?? 0}.`,
+            `Stamped posts: ${result.stamped_post_count ?? 0}.`,
+        ].join('\n');
+    },
+};

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

@@ -12,15 +12,15 @@ export declare const generateImageTool: {
         resolution: z.ZodOptional<z.ZodEnum<["512", "1K", "2K", "4K"]>>;
     }, "strip", z.ZodTypeAny, {
         prompt: string;
-        aspect_ratio?: "1:1" | "9:16" | "4:5" | "3:4" | "2:3" | "1:4" | "1:8" | "21:9" | "16:9" | "4:3" | "3:2" | "4:1" | "8:1" | "5:4" | undefined;
-        style?: "photographic" | "illustration" | "minimal" | "vibrant" | "professional" | "youtube_thumbnail" | "reel_cover" | "review_background" | undefined;
+        aspect_ratio?: "16:9" | "9:16" | "1:1" | "4:5" | "3:4" | "2:3" | "1:4" | "1:8" | "21:9" | "4:3" | "3:2" | "4:1" | "8:1" | "5:4" | undefined;
+        style?: "professional" | "photographic" | "illustration" | "minimal" | "vibrant" | "youtube_thumbnail" | "reel_cover" | "review_background" | undefined;
         variations?: number | undefined;
         model?: "flash" | "pro" | undefined;
         resolution?: "512" | "1K" | "2K" | "4K" | undefined;
     }, {
         prompt: string;
-        aspect_ratio?: "1:1" | "9:16" | "4:5" | "3:4" | "2:3" | "1:4" | "1:8" | "21:9" | "16:9" | "4:3" | "3:2" | "4:1" | "8:1" | "5:4" | undefined;
-        style?: "photographic" | "illustration" | "minimal" | "vibrant" | "professional" | "youtube_thumbnail" | "reel_cover" | "review_background" | undefined;
+        aspect_ratio?: "16:9" | "9:16" | "1:1" | "4:5" | "3:4" | "2:3" | "1:4" | "1:8" | "21:9" | "4:3" | "3:2" | "4:1" | "8:1" | "5:4" | undefined;
+        style?: "professional" | "photographic" | "illustration" | "minimal" | "vibrant" | "youtube_thumbnail" | "reel_cover" | "review_background" | undefined;
         variations?: number | undefined;
         model?: "flash" | "pro" | undefined;
         resolution?: "512" | "1K" | "2K" | "4K" | undefined;

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

@@ -0,0 +1,59 @@
+import { z } from 'zod';
+import type { PosterlyClient } from '../lib/api-client.js';
+export declare const generateVideoTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        prompt: z.ZodString;
+        negative_prompt: z.ZodOptional<z.ZodString>;
+        aspect_ratio: z.ZodOptional<z.ZodDefault<z.ZodEnum<["16:9", "9:16"]>>>;
+        duration_seconds: z.ZodOptional<z.ZodDefault<z.ZodUnion<[z.ZodLiteral<4>, z.ZodLiteral<6>, z.ZodLiteral<8>]>>>;
+        resolution: z.ZodOptional<z.ZodDefault<z.ZodEnum<["720p", "1080p"]>>>;
+        model: z.ZodOptional<z.ZodDefault<z.ZodEnum<["fast", "standard"]>>>;
+        image_url: z.ZodOptional<z.ZodString>;
+        end_image_url: z.ZodOptional<z.ZodString>;
+        reference_images: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            url: z.ZodString;
+            type: z.ZodEnum<["character", "object", "scene"]>;
+        }, "strip", z.ZodTypeAny, {
+            type: "object" | "character" | "scene";
+            url: string;
+        }, {
+            type: "object" | "character" | "scene";
+            url: string;
+        }>, "many">>;
+        generate_audio: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+        source_video_url: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        prompt: string;
+        aspect_ratio?: "16:9" | "9:16" | undefined;
+        model?: "fast" | "standard" | undefined;
+        resolution?: "720p" | "1080p" | undefined;
+        negative_prompt?: string | undefined;
+        duration_seconds?: 4 | 6 | 8 | undefined;
+        image_url?: string | undefined;
+        end_image_url?: string | undefined;
+        reference_images?: {
+            type: "object" | "character" | "scene";
+            url: string;
+        }[] | undefined;
+        generate_audio?: boolean | undefined;
+        source_video_url?: string | undefined;
+    }, {
+        prompt: string;
+        aspect_ratio?: "16:9" | "9:16" | undefined;
+        model?: "fast" | "standard" | undefined;
+        resolution?: "720p" | "1080p" | undefined;
+        negative_prompt?: string | undefined;
+        duration_seconds?: 4 | 6 | 8 | undefined;
+        image_url?: string | undefined;
+        end_image_url?: string | undefined;
+        reference_images?: {
+            type: "object" | "character" | "scene";
+            url: string;
+        }[] | undefined;
+        generate_audio?: boolean | undefined;
+        source_video_url?: string | undefined;
+    }>;
+    execute(client: PosterlyClient, input: any): Promise<string>;
+};

package/dist/tools/generate-video.js

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+export const generateVideoTool = {
+    name: 'generate_video',
+    description: 'Queue a Veo AI video generation job. COSTS VEO CREDITS: confirm prompt, model, duration, resolution, aspect ratio, audio choice, and credit cost with the user before calling. Poll get_video_job for status and final video_url.',
+    inputSchema: z.object({
+        prompt: z.string().min(5).max(1024),
+        negative_prompt: z.string().max(500).optional(),
+        aspect_ratio: z.enum(['16:9', '9:16']).default('16:9').optional(),
+        duration_seconds: z.union([z.literal(4), z.literal(6), z.literal(8)]).default(8).optional(),
+        resolution: z.enum(['720p', '1080p']).default('720p').optional(),
+        model: z.enum(['fast', 'standard']).default('fast').optional(),
+        image_url: z.string().url().optional(),
+        end_image_url: z.string().url().optional(),
+        reference_images: z.array(z.object({
+            url: z.string().url(),
+            type: z.enum(['character', 'object', 'scene']),
+        })).max(3).optional(),
+        generate_audio: z.boolean().default(true).optional(),
+        source_video_url: z.string().url().optional(),
+    }),
+    async execute(client, input) {
+        const result = await client.generateVideo(input);
+        return [
+            'Video generation job queued',
+            `Job ID: ${result.job_id}`,
+            `Status: ${result.status}`,
+            `Credit cost: ${result.credit_cost} (${result.included_credit_cost || 0} included, ${result.purchased_credit_cost || 0} purchased)`,
+            result.message,
+            '',
+            'Raw response:',
+            JSON.stringify(result, null, 2),
+        ].filter(Boolean).join('\n');
+    },
+};

package/dist/tools/get-connect-link.d.ts

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+import type { PosterlyClient } from '../lib/api-client.js';
+export declare const getConnectLinkTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        platform: z.ZodOptional<z.ZodEnum<["bluesky", "devto", "discord", "facebook", "facebook_instagram", "facebook_pages", "gmb", "google-business", "google_business", "google_business_profile", "hashnode", "instagram", "instagram-standalone", "instagram_direct", "linkedin", "linkedin-company", "linkedin-page", "linkedin_company", "linkedin_page", "linkedin_personal", "mastodon", "medium", "meta", "meta_business", "pinterest", "reddit", "skool", "slack", "telegram", "threads", "tiktok", "twitter", "whop", "wordpress", "x", "x_twitter", "youtube"]>>;
+        workspace_id: z.ZodOptional<z.ZodString>;
+        include_planned: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        workspace_id?: string | undefined;
+        include_planned?: boolean | undefined;
+        platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "linkedin" | "youtube" | "pinterest" | "threads" | "google_business" | "telegram" | "bluesky" | "reddit" | "wordpress" | "mastodon" | "medium" | "devto" | "hashnode" | "discord" | "slack" | "skool" | "whop" | "gmb" | "google-business" | "google_business_profile" | "x" | "meta" | "linkedin_page" | "facebook_instagram" | "facebook_pages" | "instagram_direct" | "linkedin-company" | "linkedin-page" | "linkedin_company" | "linkedin_personal" | "meta_business" | "x_twitter" | undefined;
+    }, {
+        workspace_id?: string | undefined;
+        include_planned?: boolean | undefined;
+        platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "linkedin" | "youtube" | "pinterest" | "threads" | "google_business" | "telegram" | "bluesky" | "reddit" | "wordpress" | "mastodon" | "medium" | "devto" | "hashnode" | "discord" | "slack" | "skool" | "whop" | "gmb" | "google-business" | "google_business_profile" | "x" | "meta" | "linkedin_page" | "facebook_instagram" | "facebook_pages" | "instagram_direct" | "linkedin-company" | "linkedin-page" | "linkedin_company" | "linkedin_personal" | "meta_business" | "x_twitter" | undefined;
+    }>;
+    execute(client: PosterlyClient, input: {
+        platform?: string;
+        workspace_id?: string;
+        include_planned?: boolean;
+    }): Promise<string>;
+};