posterly-mcp-server 0.8.2 → 0.19.0

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>;
+};

package/dist/tools/get-connect-link.js

@@ -0,0 +1,46 @@
+import { z } from 'zod';
+import { CONNECT_INPUTS, PLANNED_PLATFORM_IDS } from '../generated/platform-manifest.js';
+export const getConnectLinkTool = {
+    name: 'get_connect_link',
+    description: 'List dashboard handoff links/readiness for connecting social accounts, or get one platform connection URL. Use connection_url in a logged-in browser. Direct OAuth URLs are intentionally not exposed because provider callbacks rely on browser state.',
+    inputSchema: z.object({
+        platform: z
+            .enum(CONNECT_INPUTS)
+            .optional()
+            .describe('Connection target such as instagram, meta, linkedin_page, twitter, x, google_business, telegram, reddit, or wordpress. Omit to list live connection targets.'),
+        workspace_id: z
+            .string()
+            .optional()
+            .describe('Filter connected account counts to a workspace.'),
+        include_planned: z
+            .boolean()
+            .optional()
+            .describe(`Include planned provider expansion targets from the Postiz parity audit: ${PLANNED_PLATFORM_IDS.join(', ')}.`),
+    }),
+    async execute(client, input) {
+        const result = await client.getConnectLink(input);
+        if (result.connect) {
+            return formatConnectOption(result.connect, true);
+        }
+        const options = result.connect_options || [];
+        const lines = options.map((option) => formatConnectOption(option, false));
+        return `Posterly connection options (${options.length}):\n${lines.join('\n\n')}`;
+    },
+};
+function formatConnectOption(option, includeRaw) {
+    const missing = option.missing_env?.length
+        ? `missing env: ${option.missing_env.map((group) => group.join(' or ')).join(', ')}`
+        : 'configured';
+    const accounts = option.connected_count ?? option.connected_accounts?.length ?? 0;
+    const fields = option.credential_fields?.length
+        ? `; credential fields: ${option.credential_fields.map((field) => field.key).join(', ')}`
+        : '';
+    const scopes = option.scopes?.length ? `; scopes: ${option.scopes.join(', ')}` : '';
+    const raw = includeRaw ? `\n\nRaw connect option:\n${JSON.stringify(option, null, 2)}` : '';
+    return [
+        `${option.label} (${option.platform})`,
+        `Status: ${option.status}; method: ${option.method}; ${missing}; connected accounts: ${accounts}`,
+        `Connection URL: ${option.connection_url || 'not available'}${fields}${scopes}`,
+        raw,
+    ].join('\n');
+}

package/dist/tools/get-google-business-review-link.d.ts

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+import type { PosterlyClient } from '../lib/api-client.js';
+export declare const getGoogleBusinessReviewLinkTool: {
+    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>;
+    }, "strip", z.ZodTypeAny, {
+        workspace_id?: string | undefined;
+        account_id?: number | undefined;
+        location_id?: string | undefined;
+    }, {
+        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;
+    }): Promise<string>;
+};

package/dist/tools/get-google-business-review-link.js

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+export const getGoogleBusinessReviewLinkTool = {
+    name: 'get_google_business_review_link',
+    description: 'Get the direct public Google review link for a connected Google Business Profile location. Requires account_id or location_id.',
+    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.'),
+    }),
+    async execute(client, input) {
+        const result = await client.getGoogleBusinessReviewLink(input);
+        return [
+            `Review link for ${result.businessName}:`,
+            result.reviewLink,
+            `Place ID: ${result.placeId}`,
+            `Account ID: ${result.account_id}`,
+        ].join('\n');
+    },
+};

package/dist/tools/get-platform-schema.d.ts

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

package/dist/tools/get-platform-schema.js

@@ -0,0 +1,44 @@
+import { z } from 'zod';
+import { ALL_PLATFORM_INPUTS, SUPPORTED_PLATFORM_IDS } from '../generated/platform-manifest.js';
+export const getPlatformSchemaTool = {
+    name: 'get_platform_schema',
+    description: 'Get the platform schema for a specific connected account or platform. Call this before creating posts with platform_settings so you know allowed post types, media limits, helper tools, and field names.',
+    inputSchema: z.object({
+        account_id: z
+            .string()
+            .optional()
+            .describe('Connected account ID from list_accounts. Preferred because it returns account context.'),
+        platform: z
+            .enum(ALL_PLATFORM_INPUTS)
+            .optional()
+            .describe(`Platform ID such as ${SUPPORTED_PLATFORM_IDS.join(', ')}. Set include_planned to inspect planned providers.`),
+        include_planned: z.boolean().optional(),
+    }),
+    async execute(client, input) {
+        const result = await client.getPlatformSchema(input);
+        const schema = result.schema || result.platform || result.platforms?.[0];
+        if (!schema)
+            return JSON.stringify(result, null, 2);
+        const fields = schema.settings_schema?.fields || [];
+        const helpers = schema.helper_tools || [];
+        const accountLine = result.account
+            ? `Account: ${result.account.username || result.account.id} (${result.account.platform})\n`
+            : '';
+        return [
+            `${schema.label} (${schema.id}) schema`,
+            accountLine.trim(),
+            `Status: ${schema.status}`,
+            `Post types: ${schema.post_types.join(', ') || 'n/a'}`,
+            `Content limit: ${schema.content_limit ?? 'n/a'}`,
+            `Media: ${JSON.stringify(schema.media)}`,
+            `Analytics: ${schema.analytics_supported ? 'yes' : 'no'}`,
+            fields.length
+                ? `Settings:\n${fields.map((field) => `• ${field.key}${field.required ? ' (required)' : ''}: ${field.description}`).join('\n')}`
+                : 'Settings: none',
+            helpers.length
+                ? `Helpers:\n${helpers.map((helper) => `• ${helper.name}: ${helper.description}`).join('\n')}`
+                : 'Helpers: none',
+            `Example settings: ${JSON.stringify(schema.settings_schema?.example || {})}`,
+        ].filter(Boolean).join('\n');
+    },
+};

package/dist/tools/get-post-missing.d.ts

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

package/dist/tools/get-post-missing.js

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+export const getPostMissingTool = {
+    name: 'get_post_missing',
+    description: 'Inspect whether a post is missing required content, media, account, platform settings, or metadata before it can publish. Use this to repair failed or imported posts.',
+    inputSchema: z.object({
+        post_id: z.number().int().positive().describe('The post ID to inspect.'),
+    }),
+    async execute(client, input) {
+        const result = await client.getPostMissing(input.post_id);
+        return JSON.stringify(result, null, 2);
+    },
+};

package/dist/tools/get-video-job.d.ts

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+import type { PosterlyClient } from '../lib/api-client.js';
+export declare const getVideoJobTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        job_id: z.ZodOptional<z.ZodString>;
+        status: z.ZodOptional<z.ZodEnum<["pending", "processing", "completed", "failed", "dismissed"]>>;
+        limit: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        status?: "pending" | "processing" | "completed" | "failed" | "dismissed" | undefined;
+        limit?: number | undefined;
+        job_id?: string | undefined;
+    }, {
+        status?: "pending" | "processing" | "completed" | "failed" | "dismissed" | undefined;
+        limit?: number | undefined;
+        job_id?: string | undefined;
+    }>;
+    execute(client: PosterlyClient, input: {
+        job_id?: string;
+        status?: string;
+        limit?: number;
+    }): Promise<string>;
+};