posterly-mcp-server 0.34.0 → 0.35.0

package/README.md

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

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

@@ -812,6 +812,7 @@ export interface PublicSignupSessionResponse {
 export interface VideoJob {
     id: string;
     status: string;
+    provider: 'google' | 'xai';
     prompt: string;
     model: string;
     duration_seconds: number;
@@ -1015,8 +1016,10 @@ export declare class PosterlyClient {
         aspect_ratio?: string;
         style?: string;
         variations?: number;
+        provider?: 'google' | 'xai';
         model?: 'lite' | 'flash' | 'pro';
         resolution?: '512' | '1K' | '2K' | '4K';
+        quality?: 'low' | 'medium';
     }): Promise<{
         urls: string[];
         images: Array<{
@@ -1025,6 +1028,7 @@ export declare class PosterlyClient {
             path: string;
         }>;
         model: string;
+        provider: 'google' | 'xai';
         credits_used: number;
         warnings?: string[];
         usage: {
@@ -1042,11 +1046,12 @@ export declare class PosterlyClient {
         params?: Record<string, unknown>;
     }): Promise<Record<string, any>>;
     generateVideo(data: {
+        provider?: 'google' | 'xai';
         prompt: string;
         negative_prompt?: string;
-        aspect_ratio?: '16:9' | '9:16';
-        duration_seconds?: 4 | 6 | 8;
-        resolution?: '720p' | '1080p';
+        aspect_ratio?: '1:1' | '16:9' | '9:16' | '4:3' | '3:4' | '3:2' | '2:3';
+        duration_seconds?: number;
+        resolution?: '480p' | '720p' | '1080p';
         model?: 'lite' | 'fast' | 'standard';
         image_url?: string;
         end_image_url?: string;

package/dist/lib/version.d.ts

@@ -1 +1 @@
-export declare const POSTERLY_MCP_VERSION = "0.34.0";
+export declare const POSTERLY_MCP_VERSION = "0.35.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.34.0';
+export const POSTERLY_MCP_VERSION = '0.35.0';

package/dist/tools/create-connect-session.d.ts

@@ -9,12 +9,12 @@ export declare const createConnectSessionTool: {
         auto_start: z.ZodOptional<z.ZodBoolean>;
         debug: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
-        platform: "meta" | "instagram_direct" | "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "slack" | "mastodon" | "devto" | "hashnode" | "wordpress" | "lemmy" | "reddit" | "medium" | "skool" | "whop" | "gmb" | "google-business" | "google_business_profile" | "linkedin_page" | "facebook_instagram" | "facebook_pages" | "linkedin-company" | "linkedin-page" | "linkedin_company" | "linkedin_personal" | "meta_business" | "x_twitter";
+        platform: "meta" | "instagram_direct" | "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "medium" | "x" | "telegram" | "bluesky" | "discord" | "slack" | "mastodon" | "devto" | "hashnode" | "wordpress" | "lemmy" | "reddit" | "skool" | "whop" | "gmb" | "google-business" | "google_business_profile" | "linkedin_page" | "facebook_instagram" | "facebook_pages" | "linkedin-company" | "linkedin-page" | "linkedin_company" | "linkedin_personal" | "meta_business" | "x_twitter";
         workspace_id?: string | undefined;
         auto_start?: boolean | undefined;
         debug?: boolean | undefined;
     }, {
-        platform: "meta" | "instagram_direct" | "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "slack" | "mastodon" | "devto" | "hashnode" | "wordpress" | "lemmy" | "reddit" | "medium" | "skool" | "whop" | "gmb" | "google-business" | "google_business_profile" | "linkedin_page" | "facebook_instagram" | "facebook_pages" | "linkedin-company" | "linkedin-page" | "linkedin_company" | "linkedin_personal" | "meta_business" | "x_twitter";
+        platform: "meta" | "instagram_direct" | "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "medium" | "x" | "telegram" | "bluesky" | "discord" | "slack" | "mastodon" | "devto" | "hashnode" | "wordpress" | "lemmy" | "reddit" | "skool" | "whop" | "gmb" | "google-business" | "google_business_profile" | "linkedin_page" | "facebook_instagram" | "facebook_pages" | "linkedin-company" | "linkedin-page" | "linkedin_company" | "linkedin_personal" | "meta_business" | "x_twitter";
         workspace_id?: string | undefined;
         auto_start?: boolean | undefined;
         debug?: boolean | undefined;

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

@@ -8,33 +8,41 @@ export declare const generateImageTool: {
         aspect_ratio: z.ZodOptional<z.ZodEnum<["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"]>>;
         style: z.ZodOptional<z.ZodEnum<["photographic", "illustration", "minimal", "vibrant", "professional", "youtube_thumbnail", "reel_cover", "review_background"]>>;
         variations: z.ZodOptional<z.ZodNumber>;
+        provider: z.ZodOptional<z.ZodEnum<["google", "xai"]>>;
         model: z.ZodOptional<z.ZodEnum<["lite", "flash", "pro"]>>;
         resolution: z.ZodOptional<z.ZodEnum<["512", "1K", "2K", "4K"]>>;
+        quality: z.ZodOptional<z.ZodEnum<["low", "medium"]>>;
         confirm: z.ZodLiteral<true>;
     }, "strip", z.ZodTypeAny, {
         confirm: true;
         prompt: string;
-        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;
+        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;
         style?: "minimal" | "professional" | "photographic" | "illustration" | "vibrant" | "youtube_thumbnail" | "reel_cover" | "review_background" | undefined;
         variations?: number | undefined;
+        provider?: "google" | "xai" | undefined;
         model?: "pro" | "lite" | "flash" | undefined;
         resolution?: "512" | "1K" | "2K" | "4K" | undefined;
+        quality?: "low" | "medium" | undefined;
     }, {
         confirm: true;
         prompt: string;
-        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;
+        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;
         style?: "minimal" | "professional" | "photographic" | "illustration" | "vibrant" | "youtube_thumbnail" | "reel_cover" | "review_background" | undefined;
         variations?: number | undefined;
+        provider?: "google" | "xai" | undefined;
         model?: "pro" | "lite" | "flash" | undefined;
         resolution?: "512" | "1K" | "2K" | "4K" | undefined;
+        quality?: "low" | "medium" | undefined;
     }>;
     execute(client: PosterlyClient, input: {
         prompt: string;
         aspect_ratio?: string;
         style?: string;
         variations?: number;
+        provider?: "google" | "xai";
         model?: "lite" | "flash" | "pro";
         resolution?: "512" | "1K" | "2K" | "4K";
+        quality?: "low" | "medium";
         confirm: true;
     }): Promise<string>;
 };

package/dist/tools/generate-image.js

@@ -2,7 +2,7 @@ import { z } from 'zod';
 import { mdBullets, mdKeyValue, mdSection, mdTable, mdTitle } from '../lib/format.js';
 export const generateImageTool = {
     name: 'generate_image',
-    description: 'Generate an AI image via Posterly\'s Nano Banana (Gemini) integration. The image is saved to the user\'s media storage and the returned URL can be passed to `create_post` as `media_url`.\n\n' +
+    description: 'Generate an AI image via Posterly using Nano Banana (Gemini) or Grok Imagine Image 2.0 (xAI). The image is saved to the user\'s media storage and the returned URL can be passed to `create_post` as `media_url`.\n\n' +
         'COSTS CREDITS. Every call consumes part of the user\'s monthly AI image quota (or purchased credits once the quota is exhausted). Do NOT call speculatively - always describe the image you\'re about to generate (subject, style, aspect ratio) to the user and get confirmation before calling.\n\n' +
         'If the user is over their plan limit and has no credits, this tool returns a 402 with upgrade info. Surface that message verbatim - do not retry.\n\n' +
         'Common aspect ratios by platform:\n' +
@@ -37,14 +37,22 @@ export const generateImageTool = {
             .max(4)
             .optional()
             .describe('How many variations to generate. Default 1. Each variation costs credits separately - prefer 1 unless the user explicitly wants options.'),
+        provider: z
+            .enum(['google', 'xai'])
+            .optional()
+            .describe('Image provider. Default google. Use xai for Grok Imagine Image 2.0.'),
         model: z
             .enum(['lite', 'flash', 'pro'])
             .optional()
-            .describe('lite (8 credits, 1K only) is the cheapest and suits drafts and exploration. flash (default, 15 credits at 1K) balances quality and cost. pro (30 credits at 1K) is highest quality for hero imagery. Start with lite or flash unless quality is critical.'),
+            .describe('Google-only. lite (8 credits, 1K only) suits drafts; flash (default, 15 at 1K) balances quality and cost; pro (30 at 1K) is highest quality. Ignored for xAI.'),
         resolution: z
             .enum(['512', '1K', '2K', '4K'])
             .optional()
-            .describe('Output resolution. Default 1K. Higher resolutions cost more credits (flash: 10/15/23/35 for 512/1K/2K/4K; pro: 30 at 1K-2K, 55 at 4K). 512 is flash-only and lite supports 1K only.'),
+            .describe('Output resolution. Default 1K. xAI supports 1K/2K only. Google flash: 10/15/23/35 credits at 512/1K/2K/4K; pro: 30 at 1K-2K, 55 at 4K.'),
+        quality: z
+            .enum(['low', 'medium'])
+            .optional()
+            .describe('xAI only. Low costs 9/14 credits at 1K/2K; medium (default) costs 14/18 credits and gives better quality.'),
         confirm: z.literal(true).describe('Must be true after explicit user confirmation of subject, style, aspect ratio, and credit use.'),
     }),
     async execute(client, input) {

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

@@ -4,11 +4,12 @@ export declare const generateVideoTool: {
     name: string;
     description: string;
     inputSchema: z.ZodObject<{
+        provider: z.ZodOptional<z.ZodDefault<z.ZodEnum<["google", "xai"]>>>;
         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"]>>>;
+        aspect_ratio: z.ZodOptional<z.ZodDefault<z.ZodEnum<["1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3"]>>>;
+        duration_seconds: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+        resolution: z.ZodOptional<z.ZodDefault<z.ZodEnum<["480p", "720p", "1080p"]>>>;
         model: z.ZodOptional<z.ZodDefault<z.ZodEnum<["lite", "fast", "standard"]>>>;
         image_url: z.ZodOptional<z.ZodString>;
         end_image_url: z.ZodOptional<z.ZodString>;
@@ -28,11 +29,12 @@ export declare const generateVideoTool: {
     }, "strip", z.ZodTypeAny, {
         confirm: true;
         prompt: string;
-        aspect_ratio?: "16:9" | "9:16" | undefined;
+        aspect_ratio?: "1:1" | "16:9" | "9:16" | "4:3" | "3:4" | "3:2" | "2:3" | undefined;
+        provider?: "google" | "xai" | undefined;
         model?: "lite" | "fast" | "standard" | undefined;
-        resolution?: "720p" | "1080p" | undefined;
+        resolution?: "480p" | "720p" | "1080p" | undefined;
         negative_prompt?: string | undefined;
-        duration_seconds?: 4 | 6 | 8 | undefined;
+        duration_seconds?: number | undefined;
         image_url?: string | undefined;
         end_image_url?: string | undefined;
         reference_images?: {
@@ -44,11 +46,12 @@ export declare const generateVideoTool: {
     }, {
         confirm: true;
         prompt: string;
-        aspect_ratio?: "16:9" | "9:16" | undefined;
+        aspect_ratio?: "1:1" | "16:9" | "9:16" | "4:3" | "3:4" | "3:2" | "2:3" | undefined;
+        provider?: "google" | "xai" | undefined;
         model?: "lite" | "fast" | "standard" | undefined;
-        resolution?: "720p" | "1080p" | undefined;
+        resolution?: "480p" | "720p" | "1080p" | undefined;
         negative_prompt?: string | undefined;
-        duration_seconds?: 4 | 6 | 8 | undefined;
+        duration_seconds?: number | undefined;
         image_url?: string | undefined;
         end_image_url?: string | undefined;
         reference_images?: {

package/dist/tools/generate-video.js

@@ -1,13 +1,14 @@
 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. Models cost 12 (lite), 35 (fast) or 90 (standard) credits per second; lite supports text-to-video and image-to-video only, not reference_images or source_video_url. Poll get_video_job for status and final video_url.',
+    description: 'Queue an AI video generation job with Google Veo 3.1 or xAI Grok Imagine Video 1.5. COSTS CREDITS: confirm provider, prompt, duration, resolution, aspect ratio, audio choice, and credit cost with the user before calling. Grok supports 1–15 seconds and 480p–1080p; reference-to-video is capped at 720p. Poll get_video_job for status and final video_url.',
     inputSchema: z.object({
+        provider: z.enum(['google', 'xai']).default('google').optional(),
         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(),
+        aspect_ratio: z.enum(['1:1', '16:9', '9:16', '4:3', '3:4', '3:2', '2:3']).default('16:9').optional(),
+        duration_seconds: z.number().int().min(1).max(15).default(8).optional(),
+        resolution: z.enum(['480p', '720p', '1080p']).default('720p').optional(),
         model: z.enum(['lite', 'fast', 'standard']).default('fast').optional(),
         image_url: z.string().url().optional(),
         end_image_url: z.string().url().optional(),
@@ -15,7 +16,7 @@ export const generateVideoTool = {
             url: z.string().url(),
             type: z.enum(['character', 'object', 'scene']),
         })).max(3).optional(),
-        generate_audio: z.boolean().default(true).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(),
         confirm: z.literal(true).describe('Must be true after explicit user confirmation of prompt, model, duration, resolution, and credit cost.'),
     }),

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

@@ -9,12 +9,12 @@ export declare const getConnectLinkTool: {
         include_planned: z.ZodOptional<z.ZodBoolean>;
         debug: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
-        platform?: "meta" | "instagram_direct" | "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "slack" | "mastodon" | "devto" | "hashnode" | "wordpress" | "lemmy" | "reddit" | "medium" | "skool" | "whop" | "gmb" | "google-business" | "google_business_profile" | "linkedin_page" | "facebook_instagram" | "facebook_pages" | "linkedin-company" | "linkedin-page" | "linkedin_company" | "linkedin_personal" | "meta_business" | "x_twitter" | undefined;
+        platform?: "meta" | "instagram_direct" | "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "medium" | "x" | "telegram" | "bluesky" | "discord" | "slack" | "mastodon" | "devto" | "hashnode" | "wordpress" | "lemmy" | "reddit" | "skool" | "whop" | "gmb" | "google-business" | "google_business_profile" | "linkedin_page" | "facebook_instagram" | "facebook_pages" | "linkedin-company" | "linkedin-page" | "linkedin_company" | "linkedin_personal" | "meta_business" | "x_twitter" | undefined;
         workspace_id?: string | undefined;
         include_planned?: boolean | undefined;
         debug?: boolean | undefined;
     }, {
-        platform?: "meta" | "instagram_direct" | "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "slack" | "mastodon" | "devto" | "hashnode" | "wordpress" | "lemmy" | "reddit" | "medium" | "skool" | "whop" | "gmb" | "google-business" | "google_business_profile" | "linkedin_page" | "facebook_instagram" | "facebook_pages" | "linkedin-company" | "linkedin-page" | "linkedin_company" | "linkedin_personal" | "meta_business" | "x_twitter" | undefined;
+        platform?: "meta" | "instagram_direct" | "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "medium" | "x" | "telegram" | "bluesky" | "discord" | "slack" | "mastodon" | "devto" | "hashnode" | "wordpress" | "lemmy" | "reddit" | "skool" | "whop" | "gmb" | "google-business" | "google_business_profile" | "linkedin_page" | "facebook_instagram" | "facebook_pages" | "linkedin-company" | "linkedin-page" | "linkedin_company" | "linkedin_personal" | "meta_business" | "x_twitter" | undefined;
         workspace_id?: string | undefined;
         include_planned?: boolean | undefined;
         debug?: boolean | undefined;

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

@@ -8,11 +8,11 @@ export declare const getPlatformSchemaTool: {
         platform: z.ZodOptional<z.ZodEnum<["bluesky", "devto", "discord", "facebook", "gmb", "google-business", "google_business", "google_business_profile", "hashnode", "instagram", "instagram-standalone", "lemmy", "linkedin", "mastodon", "medium", "pinterest", "reddit", "skool", "slack", "telegram", "threads", "tiktok", "twitter", "whop", "wordpress", "x", "youtube"]>>;
         include_planned: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
-        platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "slack" | "mastodon" | "devto" | "hashnode" | "wordpress" | "lemmy" | "reddit" | "medium" | "skool" | "whop" | "gmb" | "google-business" | "google_business_profile" | undefined;
+        platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "medium" | "x" | "telegram" | "bluesky" | "discord" | "slack" | "mastodon" | "devto" | "hashnode" | "wordpress" | "lemmy" | "reddit" | "skool" | "whop" | "gmb" | "google-business" | "google_business_profile" | undefined;
         include_planned?: boolean | undefined;
         account_id?: string | undefined;
     }, {
-        platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "slack" | "mastodon" | "devto" | "hashnode" | "wordpress" | "lemmy" | "reddit" | "medium" | "skool" | "whop" | "gmb" | "google-business" | "google_business_profile" | undefined;
+        platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "medium" | "x" | "telegram" | "bluesky" | "discord" | "slack" | "mastodon" | "devto" | "hashnode" | "wordpress" | "lemmy" | "reddit" | "skool" | "whop" | "gmb" | "google-business" | "google_business_profile" | undefined;
         include_planned?: boolean | undefined;
         account_id?: string | undefined;
     }>;

package/dist/tools/run-video-function.d.ts

@@ -4,15 +4,15 @@ export declare const runVideoFunctionTool: {
     name: string;
     description: string;
     inputSchema: z.ZodObject<{
-        identifier: z.ZodEnum<["google_veo", "veo3"]>;
+        identifier: z.ZodEnum<["google_veo", "veo3", "xai_grok", "grok_imagine"]>;
         functionName: z.ZodEnum<["list_input_modes", "estimate_cost", "validate_request"]>;
         params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, "strip", z.ZodTypeAny, {
-        identifier: "google_veo" | "veo3";
+        identifier: "google_veo" | "veo3" | "xai_grok" | "grok_imagine";
         functionName: "list_input_modes" | "estimate_cost" | "validate_request";
         params?: Record<string, unknown> | undefined;
     }, {
-        identifier: "google_veo" | "veo3";
+        identifier: "google_veo" | "veo3" | "xai_grok" | "grok_imagine";
         functionName: "list_input_modes" | "estimate_cost" | "validate_request";
         params?: Record<string, unknown> | undefined;
     }>;

package/dist/tools/run-video-function.js

@@ -1,10 +1,10 @@
 import { z } from 'zod';
 export const runVideoFunctionTool = {
     name: 'run_video_function',
-    description: 'Run a read-only Veo helper function before generation: list_input_modes, estimate_cost, or validate_request. This does not generate video or spend credits.',
+    description: 'Run a read-only Google Veo or xAI Grok video helper function before generation: list_input_modes, estimate_cost, or validate_request. This does not generate video or spend credits.',
     inputSchema: z.object({
         identifier: z
-            .enum(['google_veo', 'veo3'])
+            .enum(['google_veo', 'veo3', 'xai_grok', 'grok_imagine'])
             .describe('Video generator identifier from get_video_options.'),
         functionName: z
             .enum(['list_input_modes', 'estimate_cost', 'validate_request'])
@@ -12,7 +12,7 @@ export const runVideoFunctionTool = {
         params: z
             .record(z.unknown())
             .optional()
-            .describe('Function parameters. estimate_cost accepts model, duration_seconds, resolution, and output. validate_request accepts a generate_video-style payload.'),
+            .describe('Function parameters. estimate_cost accepts model, duration_seconds, resolution, output, and xAI input_image_count. validate_request accepts a generate_video-style payload.'),
     }),
     async execute(client, input) {
         const result = await client.runVideoFunction(input);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "posterly-mcp-server",
-  "version": "0.34.0",
+  "version": "0.35.0",
   "mcpName": "io.github.awpthorp/posterly",
   "description": "MCP server for posterly: schedule and publish social media posts across 18 platforms from any MCP client (Claude, ChatGPT, Cursor, Windsurf, Cline, and more)",
   "license": "MIT",

package/server.json

@@ -3,7 +3,7 @@
   "name": "io.github.awpthorp/posterly",
   "title": "posterly",
   "description": "Validate, schedule, publish, and analyze social content across 18 platforms with posterly.",
-  "version": "0.34.0",
+  "version": "0.35.0",
   "websiteUrl": "https://www.poster.ly/mcp",
   "repository": {
     "url": "https://github.com/awpthorp/posterly",
@@ -14,7 +14,7 @@
     {
       "registryType": "npm",
       "identifier": "posterly-mcp-server",
-      "version": "0.34.0",
+      "version": "0.35.0",
       "transport": {
         "type": "stdio"
       },

package/src/lib/api-client.ts

@@ -841,6 +841,7 @@ export interface PublicSignupSessionResponse {
 export interface VideoJob {
   id: string;
   status: string;
+  provider: 'google' | 'xai';
   prompt: string;
   model: string;
   duration_seconds: number;
@@ -1309,12 +1310,15 @@ export class PosterlyClient {
     aspect_ratio?: string;
     style?: string;
     variations?: number;
+    provider?: 'google' | 'xai';
     model?: 'lite' | 'flash' | 'pro';
     resolution?: '512' | '1K' | '2K' | '4K';
+    quality?: 'low' | 'medium';
   }): Promise<{
     urls: string[];
     images: Array<{ url: string; filename: string; path: string }>;
     model: string;
+    provider: 'google' | 'xai';
     credits_used: number;
     warnings?: string[];
     usage: {
@@ -1341,11 +1345,12 @@ export class PosterlyClient {
   }
 
   async generateVideo(data: {
+    provider?: 'google' | 'xai';
     prompt: string;
     negative_prompt?: string;
-    aspect_ratio?: '16:9' | '9:16';
-    duration_seconds?: 4 | 6 | 8;
-    resolution?: '720p' | '1080p';
+    aspect_ratio?: '1:1' | '16:9' | '9:16' | '4:3' | '3:4' | '3:2' | '2:3';
+    duration_seconds?: number;
+    resolution?: '480p' | '720p' | '1080p';
     model?: 'lite' | 'fast' | 'standard';
     image_url?: string;
     end_image_url?: string;

package/src/lib/version.ts

@@ -5,4 +5,4 @@
 // tool set (minus the intentional pre-auth signup tools that only this stdio
 // package exposes). `npm run check:mcp-parity` enforces both the version match
 // and the tool-list match, and runs in the pre-commit hook.
-export const POSTERLY_MCP_VERSION = '0.34.0';
+export const POSTERLY_MCP_VERSION = '0.35.0';

package/src/tools/generate-image.ts

@@ -5,7 +5,7 @@ import { mdBullets, mdKeyValue, mdSection, mdTable, mdTitle } from '../lib/forma
 export const generateImageTool = {
   name: 'generate_image',
   description:
-    'Generate an AI image via Posterly\'s Nano Banana (Gemini) integration. The image is saved to the user\'s media storage and the returned URL can be passed to `create_post` as `media_url`.\n\n' +
+    'Generate an AI image via Posterly using Nano Banana (Gemini) or Grok Imagine Image 2.0 (xAI). The image is saved to the user\'s media storage and the returned URL can be passed to `create_post` as `media_url`.\n\n' +
     'COSTS CREDITS. Every call consumes part of the user\'s monthly AI image quota (or purchased credits once the quota is exhausted). Do NOT call speculatively - always describe the image you\'re about to generate (subject, style, aspect ratio) to the user and get confirmation before calling.\n\n' +
     'If the user is over their plan limit and has no credits, this tool returns a 402 with upgrade info. Surface that message verbatim - do not retry.\n\n' +
     'Common aspect ratios by platform:\n' +
@@ -40,14 +40,22 @@ export const generateImageTool = {
       .max(4)
       .optional()
       .describe('How many variations to generate. Default 1. Each variation costs credits separately - prefer 1 unless the user explicitly wants options.'),
+    provider: z
+      .enum(['google', 'xai'])
+      .optional()
+      .describe('Image provider. Default google. Use xai for Grok Imagine Image 2.0.'),
     model: z
       .enum(['lite', 'flash', 'pro'])
       .optional()
-      .describe('lite (8 credits, 1K only) is the cheapest and suits drafts and exploration. flash (default, 15 credits at 1K) balances quality and cost. pro (30 credits at 1K) is highest quality for hero imagery. Start with lite or flash unless quality is critical.'),
+      .describe('Google-only. lite (8 credits, 1K only) suits drafts; flash (default, 15 at 1K) balances quality and cost; pro (30 at 1K) is highest quality. Ignored for xAI.'),
     resolution: z
       .enum(['512', '1K', '2K', '4K'])
       .optional()
-      .describe('Output resolution. Default 1K. Higher resolutions cost more credits (flash: 10/15/23/35 for 512/1K/2K/4K; pro: 30 at 1K-2K, 55 at 4K). 512 is flash-only and lite supports 1K only.'),
+      .describe('Output resolution. Default 1K. xAI supports 1K/2K only. Google flash: 10/15/23/35 credits at 512/1K/2K/4K; pro: 30 at 1K-2K, 55 at 4K.'),
+    quality: z
+      .enum(['low', 'medium'])
+      .optional()
+      .describe('xAI only. Low costs 9/14 credits at 1K/2K; medium (default) costs 14/18 credits and gives better quality.'),
     confirm: z.literal(true).describe('Must be true after explicit user confirmation of subject, style, aspect ratio, and credit use.'),
   }),
 
@@ -58,8 +66,10 @@ export const generateImageTool = {
       aspect_ratio?: string;
       style?: string;
       variations?: number;
+      provider?: 'google' | 'xai';
       model?: 'lite' | 'flash' | 'pro';
       resolution?: '512' | '1K' | '2K' | '4K';
+      quality?: 'low' | 'medium';
       confirm: true;
     }
   ) {

package/src/tools/generate-video.ts

@@ -4,13 +4,14 @@ import type { PosterlyClient } from '../lib/api-client.js';
 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. Models cost 12 (lite), 35 (fast) or 90 (standard) credits per second; lite supports text-to-video and image-to-video only, not reference_images or source_video_url. Poll get_video_job for status and final video_url.',
+    'Queue an AI video generation job with Google Veo 3.1 or xAI Grok Imagine Video 1.5. COSTS CREDITS: confirm provider, prompt, duration, resolution, aspect ratio, audio choice, and credit cost with the user before calling. Grok supports 1–15 seconds and 480p–1080p; reference-to-video is capped at 720p. Poll get_video_job for status and final video_url.',
   inputSchema: z.object({
+    provider: z.enum(['google', 'xai']).default('google').optional(),
     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(),
+    aspect_ratio: z.enum(['1:1', '16:9', '9:16', '4:3', '3:4', '3:2', '2:3']).default('16:9').optional(),
+    duration_seconds: z.number().int().min(1).max(15).default(8).optional(),
+    resolution: z.enum(['480p', '720p', '1080p']).default('720p').optional(),
     model: z.enum(['lite', 'fast', 'standard']).default('fast').optional(),
     image_url: z.string().url().optional(),
     end_image_url: z.string().url().optional(),
@@ -18,7 +19,7 @@ export const generateVideoTool = {
       url: z.string().url(),
       type: z.enum(['character', 'object', 'scene']),
     })).max(3).optional(),
-    generate_audio: z.boolean().default(true).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(),
     confirm: z.literal(true).describe('Must be true after explicit user confirmation of prompt, model, duration, resolution, and credit cost.'),
   }),

package/src/tools/run-video-function.ts

@@ -4,10 +4,10 @@ import type { PosterlyClient } from '../lib/api-client.js';
 export const runVideoFunctionTool = {
   name: 'run_video_function',
   description:
-    'Run a read-only Veo helper function before generation: list_input_modes, estimate_cost, or validate_request. This does not generate video or spend credits.',
+    'Run a read-only Google Veo or xAI Grok video helper function before generation: list_input_modes, estimate_cost, or validate_request. This does not generate video or spend credits.',
   inputSchema: z.object({
     identifier: z
-      .enum(['google_veo', 'veo3'])
+      .enum(['google_veo', 'veo3', 'xai_grok', 'grok_imagine'])
       .describe('Video generator identifier from get_video_options.'),
     functionName: z
       .enum(['list_input_modes', 'estimate_cost', 'validate_request'])
@@ -15,7 +15,7 @@ export const runVideoFunctionTool = {
     params: z
       .record(z.unknown())
       .optional()
-      .describe('Function parameters. estimate_cost accepts model, duration_seconds, resolution, and output. validate_request accepts a generate_video-style payload.'),
+      .describe('Function parameters. estimate_cost accepts model, duration_seconds, resolution, output, and xAI input_image_count. validate_request accepts a generate_video-style payload.'),
   }),
 
   async execute(