posterly-mcp-server 0.40.0 → 0.43.0

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

@@ -43,6 +43,22 @@ export declare const validatePostInputSchema: import("zod").ZodObject<{
         }>]>, "many">>;
         first_comment: import("zod").ZodOptional<import("zod").ZodString>;
         media_alt_texts: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+        media_accessibility: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+            index: import("zod").ZodNumber;
+            asset_id: import("zod").ZodOptional<import("zod").ZodString>;
+            source_url: import("zod").ZodOptional<import("zod").ZodString>;
+            alt_text: import("zod").ZodString;
+        }, "strip", import("zod").ZodTypeAny, {
+            index: number;
+            alt_text: string;
+            asset_id?: string | undefined;
+            source_url?: string | undefined;
+        }, {
+            index: number;
+            alt_text: string;
+            asset_id?: string | undefined;
+            source_url?: string | undefined;
+        }>, "many">>;
         reel_cover_url: import("zod").ZodOptional<import("zod").ZodString>;
         reel_thumb_offset: import("zod").ZodOptional<import("zod").ZodNumber>;
         is_ai_generated: import("zod").ZodOptional<import("zod").ZodBoolean>;
@@ -66,6 +82,12 @@ export declare const validatePostInputSchema: import("zod").ZodObject<{
         })[] | undefined;
         first_comment?: string | undefined;
         media_alt_texts?: Record<string, string> | undefined;
+        media_accessibility?: {
+            index: number;
+            alt_text: string;
+            asset_id?: string | undefined;
+            source_url?: string | undefined;
+        }[] | undefined;
         is_ai_generated?: boolean | undefined;
         audio_id?: string | undefined;
     }, {
@@ -87,6 +109,12 @@ export declare const validatePostInputSchema: import("zod").ZodObject<{
         })[] | undefined;
         first_comment?: string | undefined;
         media_alt_texts?: Record<string, string> | undefined;
+        media_accessibility?: {
+            index: number;
+            alt_text: string;
+            asset_id?: string | undefined;
+            source_url?: string | undefined;
+        }[] | undefined;
         is_ai_generated?: boolean | undefined;
         audio_id?: string | undefined;
     }>>;
@@ -95,6 +123,22 @@ export declare const validatePostInputSchema: import("zod").ZodObject<{
         post_type: import("zod").ZodOptional<import("zod").ZodString>;
         content_type: import("zod").ZodOptional<import("zod").ZodString>;
         media_alt_texts: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+        media_accessibility: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+            index: import("zod").ZodNumber;
+            asset_id: import("zod").ZodOptional<import("zod").ZodString>;
+            source_url: import("zod").ZodOptional<import("zod").ZodString>;
+            alt_text: import("zod").ZodString;
+        }, "strip", import("zod").ZodTypeAny, {
+            index: number;
+            alt_text: string;
+            asset_id?: string | undefined;
+            source_url?: string | undefined;
+        }, {
+            index: number;
+            alt_text: string;
+            asset_id?: string | undefined;
+            source_url?: string | undefined;
+        }>, "many">>;
         reel_cover_url: import("zod").ZodOptional<import("zod").ZodString>;
         reel_thumb_offset: import("zod").ZodOptional<import("zod").ZodNumber>;
         reply_settings: import("zod").ZodOptional<import("zod").ZodEnum<["everyone", "following", "mentionedUsers", "subscribers", "verified"]>>;
@@ -202,6 +246,22 @@ export declare const validatePostInputSchema: import("zod").ZodObject<{
         post_type: import("zod").ZodOptional<import("zod").ZodString>;
         content_type: import("zod").ZodOptional<import("zod").ZodString>;
         media_alt_texts: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+        media_accessibility: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+            index: import("zod").ZodNumber;
+            asset_id: import("zod").ZodOptional<import("zod").ZodString>;
+            source_url: import("zod").ZodOptional<import("zod").ZodString>;
+            alt_text: import("zod").ZodString;
+        }, "strip", import("zod").ZodTypeAny, {
+            index: number;
+            alt_text: string;
+            asset_id?: string | undefined;
+            source_url?: string | undefined;
+        }, {
+            index: number;
+            alt_text: string;
+            asset_id?: string | undefined;
+            source_url?: string | undefined;
+        }>, "many">>;
         reel_cover_url: import("zod").ZodOptional<import("zod").ZodString>;
         reel_thumb_offset: import("zod").ZodOptional<import("zod").ZodNumber>;
         reply_settings: import("zod").ZodOptional<import("zod").ZodEnum<["everyone", "following", "mentionedUsers", "subscribers", "verified"]>>;
@@ -309,6 +369,22 @@ export declare const validatePostInputSchema: import("zod").ZodObject<{
         post_type: import("zod").ZodOptional<import("zod").ZodString>;
         content_type: import("zod").ZodOptional<import("zod").ZodString>;
         media_alt_texts: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+        media_accessibility: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+            index: import("zod").ZodNumber;
+            asset_id: import("zod").ZodOptional<import("zod").ZodString>;
+            source_url: import("zod").ZodOptional<import("zod").ZodString>;
+            alt_text: import("zod").ZodString;
+        }, "strip", import("zod").ZodTypeAny, {
+            index: number;
+            alt_text: string;
+            asset_id?: string | undefined;
+            source_url?: string | undefined;
+        }, {
+            index: number;
+            alt_text: string;
+            asset_id?: string | undefined;
+            source_url?: string | undefined;
+        }>, "many">>;
         reel_cover_url: import("zod").ZodOptional<import("zod").ZodString>;
         reel_thumb_offset: import("zod").ZodOptional<import("zod").ZodNumber>;
         reply_settings: import("zod").ZodOptional<import("zod").ZodEnum<["everyone", "following", "mentionedUsers", "subscribers", "verified"]>>;
@@ -443,6 +519,12 @@ export declare const validatePostInputSchema: import("zod").ZodObject<{
         })[] | undefined;
         first_comment?: string | undefined;
         media_alt_texts?: Record<string, string> | undefined;
+        media_accessibility?: {
+            index: number;
+            alt_text: string;
+            asset_id?: string | undefined;
+            source_url?: string | undefined;
+        }[] | undefined;
         is_ai_generated?: boolean | undefined;
         audio_id?: string | undefined;
     } | undefined;
@@ -451,6 +533,22 @@ export declare const validatePostInputSchema: import("zod").ZodObject<{
         post_type: import("zod").ZodOptional<import("zod").ZodString>;
         content_type: import("zod").ZodOptional<import("zod").ZodString>;
         media_alt_texts: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+        media_accessibility: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+            index: import("zod").ZodNumber;
+            asset_id: import("zod").ZodOptional<import("zod").ZodString>;
+            source_url: import("zod").ZodOptional<import("zod").ZodString>;
+            alt_text: import("zod").ZodString;
+        }, "strip", import("zod").ZodTypeAny, {
+            index: number;
+            alt_text: string;
+            asset_id?: string | undefined;
+            source_url?: string | undefined;
+        }, {
+            index: number;
+            alt_text: string;
+            asset_id?: string | undefined;
+            source_url?: string | undefined;
+        }>, "many">>;
         reel_cover_url: import("zod").ZodOptional<import("zod").ZodString>;
         reel_thumb_offset: import("zod").ZodOptional<import("zod").ZodNumber>;
         reply_settings: import("zod").ZodOptional<import("zod").ZodEnum<["everyone", "following", "mentionedUsers", "subscribers", "verified"]>>;
@@ -584,6 +682,12 @@ export declare const validatePostInputSchema: import("zod").ZodObject<{
         })[] | undefined;
         first_comment?: string | undefined;
         media_alt_texts?: Record<string, string> | undefined;
+        media_accessibility?: {
+            index: number;
+            alt_text: string;
+            asset_id?: string | undefined;
+            source_url?: string | undefined;
+        }[] | undefined;
         is_ai_generated?: boolean | undefined;
         audio_id?: string | undefined;
     } | undefined;
@@ -592,6 +696,22 @@ export declare const validatePostInputSchema: import("zod").ZodObject<{
         post_type: import("zod").ZodOptional<import("zod").ZodString>;
         content_type: import("zod").ZodOptional<import("zod").ZodString>;
         media_alt_texts: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+        media_accessibility: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+            index: import("zod").ZodNumber;
+            asset_id: import("zod").ZodOptional<import("zod").ZodString>;
+            source_url: import("zod").ZodOptional<import("zod").ZodString>;
+            alt_text: import("zod").ZodString;
+        }, "strip", import("zod").ZodTypeAny, {
+            index: number;
+            alt_text: string;
+            asset_id?: string | undefined;
+            source_url?: string | undefined;
+        }, {
+            index: number;
+            alt_text: string;
+            asset_id?: string | undefined;
+            source_url?: string | undefined;
+        }>, "many">>;
         reel_cover_url: import("zod").ZodOptional<import("zod").ZodString>;
         reel_thumb_offset: import("zod").ZodOptional<import("zod").ZodNumber>;
         reply_settings: import("zod").ZodOptional<import("zod").ZodEnum<["everyone", "following", "mentionedUsers", "subscribers", "verified"]>>;
@@ -743,6 +863,22 @@ export declare const validatePostTool: {
             }>]>, "many">>;
             first_comment: import("zod").ZodOptional<import("zod").ZodString>;
             media_alt_texts: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+            media_accessibility: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+                index: import("zod").ZodNumber;
+                asset_id: import("zod").ZodOptional<import("zod").ZodString>;
+                source_url: import("zod").ZodOptional<import("zod").ZodString>;
+                alt_text: import("zod").ZodString;
+            }, "strip", import("zod").ZodTypeAny, {
+                index: number;
+                alt_text: string;
+                asset_id?: string | undefined;
+                source_url?: string | undefined;
+            }, {
+                index: number;
+                alt_text: string;
+                asset_id?: string | undefined;
+                source_url?: string | undefined;
+            }>, "many">>;
             reel_cover_url: import("zod").ZodOptional<import("zod").ZodString>;
             reel_thumb_offset: import("zod").ZodOptional<import("zod").ZodNumber>;
             is_ai_generated: import("zod").ZodOptional<import("zod").ZodBoolean>;
@@ -766,6 +902,12 @@ export declare const validatePostTool: {
             })[] | undefined;
             first_comment?: string | undefined;
             media_alt_texts?: Record<string, string> | undefined;
+            media_accessibility?: {
+                index: number;
+                alt_text: string;
+                asset_id?: string | undefined;
+                source_url?: string | undefined;
+            }[] | undefined;
             is_ai_generated?: boolean | undefined;
             audio_id?: string | undefined;
         }, {
@@ -787,6 +929,12 @@ export declare const validatePostTool: {
             })[] | undefined;
             first_comment?: string | undefined;
             media_alt_texts?: Record<string, string> | undefined;
+            media_accessibility?: {
+                index: number;
+                alt_text: string;
+                asset_id?: string | undefined;
+                source_url?: string | undefined;
+            }[] | undefined;
             is_ai_generated?: boolean | undefined;
             audio_id?: string | undefined;
         }>>;
@@ -795,6 +943,22 @@ export declare const validatePostTool: {
             post_type: import("zod").ZodOptional<import("zod").ZodString>;
             content_type: import("zod").ZodOptional<import("zod").ZodString>;
             media_alt_texts: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+            media_accessibility: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+                index: import("zod").ZodNumber;
+                asset_id: import("zod").ZodOptional<import("zod").ZodString>;
+                source_url: import("zod").ZodOptional<import("zod").ZodString>;
+                alt_text: import("zod").ZodString;
+            }, "strip", import("zod").ZodTypeAny, {
+                index: number;
+                alt_text: string;
+                asset_id?: string | undefined;
+                source_url?: string | undefined;
+            }, {
+                index: number;
+                alt_text: string;
+                asset_id?: string | undefined;
+                source_url?: string | undefined;
+            }>, "many">>;
             reel_cover_url: import("zod").ZodOptional<import("zod").ZodString>;
             reel_thumb_offset: import("zod").ZodOptional<import("zod").ZodNumber>;
             reply_settings: import("zod").ZodOptional<import("zod").ZodEnum<["everyone", "following", "mentionedUsers", "subscribers", "verified"]>>;
@@ -902,6 +1066,22 @@ export declare const validatePostTool: {
             post_type: import("zod").ZodOptional<import("zod").ZodString>;
             content_type: import("zod").ZodOptional<import("zod").ZodString>;
             media_alt_texts: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+            media_accessibility: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+                index: import("zod").ZodNumber;
+                asset_id: import("zod").ZodOptional<import("zod").ZodString>;
+                source_url: import("zod").ZodOptional<import("zod").ZodString>;
+                alt_text: import("zod").ZodString;
+            }, "strip", import("zod").ZodTypeAny, {
+                index: number;
+                alt_text: string;
+                asset_id?: string | undefined;
+                source_url?: string | undefined;
+            }, {
+                index: number;
+                alt_text: string;
+                asset_id?: string | undefined;
+                source_url?: string | undefined;
+            }>, "many">>;
             reel_cover_url: import("zod").ZodOptional<import("zod").ZodString>;
             reel_thumb_offset: import("zod").ZodOptional<import("zod").ZodNumber>;
             reply_settings: import("zod").ZodOptional<import("zod").ZodEnum<["everyone", "following", "mentionedUsers", "subscribers", "verified"]>>;
@@ -1009,6 +1189,22 @@ export declare const validatePostTool: {
             post_type: import("zod").ZodOptional<import("zod").ZodString>;
             content_type: import("zod").ZodOptional<import("zod").ZodString>;
             media_alt_texts: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+            media_accessibility: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+                index: import("zod").ZodNumber;
+                asset_id: import("zod").ZodOptional<import("zod").ZodString>;
+                source_url: import("zod").ZodOptional<import("zod").ZodString>;
+                alt_text: import("zod").ZodString;
+            }, "strip", import("zod").ZodTypeAny, {
+                index: number;
+                alt_text: string;
+                asset_id?: string | undefined;
+                source_url?: string | undefined;
+            }, {
+                index: number;
+                alt_text: string;
+                asset_id?: string | undefined;
+                source_url?: string | undefined;
+            }>, "many">>;
             reel_cover_url: import("zod").ZodOptional<import("zod").ZodString>;
             reel_thumb_offset: import("zod").ZodOptional<import("zod").ZodNumber>;
             reply_settings: import("zod").ZodOptional<import("zod").ZodEnum<["everyone", "following", "mentionedUsers", "subscribers", "verified"]>>;
@@ -1143,6 +1339,12 @@ export declare const validatePostTool: {
             })[] | undefined;
             first_comment?: string | undefined;
             media_alt_texts?: Record<string, string> | undefined;
+            media_accessibility?: {
+                index: number;
+                alt_text: string;
+                asset_id?: string | undefined;
+                source_url?: string | undefined;
+            }[] | undefined;
             is_ai_generated?: boolean | undefined;
             audio_id?: string | undefined;
         } | undefined;
@@ -1151,6 +1353,22 @@ export declare const validatePostTool: {
             post_type: import("zod").ZodOptional<import("zod").ZodString>;
             content_type: import("zod").ZodOptional<import("zod").ZodString>;
             media_alt_texts: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+            media_accessibility: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+                index: import("zod").ZodNumber;
+                asset_id: import("zod").ZodOptional<import("zod").ZodString>;
+                source_url: import("zod").ZodOptional<import("zod").ZodString>;
+                alt_text: import("zod").ZodString;
+            }, "strip", import("zod").ZodTypeAny, {
+                index: number;
+                alt_text: string;
+                asset_id?: string | undefined;
+                source_url?: string | undefined;
+            }, {
+                index: number;
+                alt_text: string;
+                asset_id?: string | undefined;
+                source_url?: string | undefined;
+            }>, "many">>;
             reel_cover_url: import("zod").ZodOptional<import("zod").ZodString>;
             reel_thumb_offset: import("zod").ZodOptional<import("zod").ZodNumber>;
             reply_settings: import("zod").ZodOptional<import("zod").ZodEnum<["everyone", "following", "mentionedUsers", "subscribers", "verified"]>>;
@@ -1284,6 +1502,12 @@ export declare const validatePostTool: {
             })[] | undefined;
             first_comment?: string | undefined;
             media_alt_texts?: Record<string, string> | undefined;
+            media_accessibility?: {
+                index: number;
+                alt_text: string;
+                asset_id?: string | undefined;
+                source_url?: string | undefined;
+            }[] | undefined;
             is_ai_generated?: boolean | undefined;
             audio_id?: string | undefined;
         } | undefined;
@@ -1292,6 +1516,22 @@ export declare const validatePostTool: {
             post_type: import("zod").ZodOptional<import("zod").ZodString>;
             content_type: import("zod").ZodOptional<import("zod").ZodString>;
             media_alt_texts: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+            media_accessibility: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+                index: import("zod").ZodNumber;
+                asset_id: import("zod").ZodOptional<import("zod").ZodString>;
+                source_url: import("zod").ZodOptional<import("zod").ZodString>;
+                alt_text: import("zod").ZodString;
+            }, "strip", import("zod").ZodTypeAny, {
+                index: number;
+                alt_text: string;
+                asset_id?: string | undefined;
+                source_url?: string | undefined;
+            }, {
+                index: number;
+                alt_text: string;
+                asset_id?: string | undefined;
+                source_url?: string | undefined;
+            }>, "many">>;
             reel_cover_url: import("zod").ZodOptional<import("zod").ZodString>;
             reel_thumb_offset: import("zod").ZodOptional<import("zod").ZodNumber>;
             reply_settings: import("zod").ZodOptional<import("zod").ZodEnum<["everyone", "following", "mentionedUsers", "subscribers", "verified"]>>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "posterly-mcp-server",
-  "version": "0.40.0",
+  "version": "0.43.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.40.0",
+  "version": "0.43.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.40.0",
+      "version": "0.43.0",
       "transport": {
         "type": "stdio"
       },

package/src/index.ts

@@ -39,6 +39,7 @@ import { deletePostGroupTool } from './tools/delete-post-group.js';
 import { whoamiTool } from './tools/whoami.js';
 import { generateCaptionsTool } from './tools/generate-captions.js';
 import { generateImageTool } from './tools/generate-image.js';
+import { getImageJobTool } from './tools/get-image-job.js';
 import { getVideoOptionsTool } from './tools/get-video-options.js';
 import { runVideoFunctionTool } from './tools/run-video-function.js';
 import { generateVideoTool } from './tools/generate-video.js';
@@ -898,6 +899,21 @@ server.tool(
   }
 );
 
+server.tool(
+  getImageJobTool.name,
+  getImageJobTool.description,
+  getImageJobTool.inputSchema.shape,
+  getToolAnnotations(getImageJobTool.name),
+  async (input) => {
+    try {
+      const text = await getImageJobTool.execute(client, input as any);
+      return { content: [{ type: 'text' as const, text }] };
+    } catch (err: any) {
+      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+    }
+  }
+);
+
 server.tool(
   getPostTool.name,
   getPostTool.description,

package/src/lib/api-client.ts

@@ -165,6 +165,7 @@ export interface InstagramPostSettings {
   user_tags?: Array<string | { username?: string; label?: string; handle?: string }>;
   first_comment?: string;
   media_alt_texts?: Record<string, string>;
+  media_accessibility?: Array<{ index: number; asset_id?: string; source_url?: string; alt_text: string }>;
   reel_cover_url?: string;
   reel_thumb_offset?: number;
 }
@@ -893,6 +894,25 @@ export interface PublicSignupSessionResponse {
   signup_session: PublicSignupSession;
 }
 
+export interface ImageJob {
+  id: string;
+  status: string;
+  provider: 'google' | 'xai';
+  prompt: string;
+  model: string;
+  resolution: string;
+  quality?: string | null;
+  thinking_level?: string | null;
+  variations: number;
+  urls: string[];
+  images: Array<{ url: string; filename?: string; path?: string }>;
+  error_message?: string | null;
+  credit_cost: number;
+  created_at: string;
+  started_at?: string | null;
+  completed_at?: string | null;
+}
+
 export interface VideoJob {
   id: string;
   status: string;
@@ -1028,6 +1048,7 @@ export class PosterlyClient {
     const url = `${this.baseUrl}/api/v1${path}`;
     const headers: Record<string, string> = {
       Authorization: `Bearer ${this.apiKey}`,
+      'X-Posterly-Source': 'mcp_stdio',
     };
 
     const init: RequestInit = { method, headers };
@@ -1368,20 +1389,24 @@ export class PosterlyClient {
     provider?: 'google' | 'xai';
     model?: 'lite' | 'flash' | 'pro';
     resolution?: '512' | '1K' | '2K' | '4K';
-    quality?: 'low' | 'medium';
+    quality?: 'low' | 'medium' | 'high';
+    thinking_level?: 'minimal' | 'high';
+    reference_image_urls?: string[];
   }): Promise<{
-    urls: string[];
-    images: Array<{ url: string; filename: string; path: string }>;
+    job_id: string;
+    status: string;
+    message?: string;
     model: string;
     provider: 'google' | 'xai';
+    resolution?: string;
+    thinking_level?: 'minimal' | 'high' | null;
     credits_used: number;
-    warnings?: string[];
-    usage: {
+    usage?: {
       used: number | null;
       limit: number | null;
       period: string | null;
       tier: string | null;
-      billed_from: 'plan_quota' | 'credits';
+      billed_from: string;
     };
   }> {
     return this.request('POST', '/ai/generate-image', data);
@@ -1431,6 +1456,21 @@ export class PosterlyClient {
     return this.request('GET', `/ai/video-jobs${qs ? `?${qs}` : ''}`);
   }
 
+  async getImageJob(params?: {
+    job_id?: string;
+    status?: string;
+    limit?: number;
+  }): Promise<{ job?: ImageJob; jobs?: ImageJob[] }> {
+    if (params?.job_id) {
+      return this.request('GET', `/ai/image-jobs/${encodeURIComponent(params.job_id)}`);
+    }
+    const searchParams = new URLSearchParams();
+    if (params?.status) searchParams.set('status', params.status);
+    if (params?.limit) searchParams.set('limit', String(params.limit));
+    const qs = searchParams.toString();
+    return this.request('GET', `/ai/image-jobs${qs ? `?${qs}` : ''}`);
+  }
+
   async findAvailableSlots(params?: {
     account_ids?: string[];
     timezone?: 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.40.0';
+export const POSTERLY_MCP_VERSION = '0.43.0';

package/src/tools/create-post.ts

@@ -3,6 +3,13 @@ import type { PosterlyClient } from '../lib/api-client.js';
 import { dashboardUrlForPost, formatLocalDateTime } from '../lib/format.js';
 import { SUPPORTED_PLATFORM_INPUTS, SUPPORTED_PLATFORM_IDS } from '../generated/platform-manifest.js';
 
+const mediaAccessibilitySchema = z.array(z.object({
+  index: z.number().int().nonnegative(),
+  asset_id: z.string().optional(),
+  source_url: z.string().url().optional(),
+  alt_text: z.string(),
+})).describe('Preferred ordered media alt text. Identity follows index/asset_id through platform media preparation; media_alt_texts remains the legacy URL-map form.');
+
 export const instagramSettingsSchema = z.object({
   __type: z.enum(['instagram', 'instagram-standalone']).optional(),
   post_type: z.enum(['post', 'feed', 'story', 'reel', 'carousel']).optional(),
@@ -19,6 +26,7 @@ export const instagramSettingsSchema = z.object({
     .describe('Native clickable media tags, not caption @mentions. Supported by eligible direct Instagram and Meta-linked connections; feed images, Reels/video, and Stories. Tags apply to each carousel item and the first Story in a Story Series.'),
   first_comment: z.string().optional(),
   media_alt_texts: z.record(z.string(), z.string()).optional(),
+  media_accessibility: mediaAccessibilitySchema.optional(),
   reel_cover_url: z.string().optional(),
   reel_thumb_offset: z.number().nonnegative().optional(),
   is_ai_generated: z.boolean().optional().describe('Label the parent Instagram media container as AI-generated. For carousels, set on the parent only.'),
@@ -30,6 +38,7 @@ export const platformSettingsSchema = z.object({
   post_type: z.string().optional(),
   content_type: z.string().optional(),
   media_alt_texts: z.record(z.string(), z.string()).optional(),
+  media_accessibility: mediaAccessibilitySchema.optional(),
   reel_cover_url: z.string().optional(),
   reel_thumb_offset: z.number().nonnegative().optional(),
   // X

package/src/tools/generate-image.ts

@@ -1,12 +1,12 @@
 import { z } from 'zod';
 import type { PosterlyClient } from '../lib/api-client.js';
-import { mdBullets, mdKeyValue, mdSection, mdTable, mdTitle } from '../lib/format.js';
+import { mdKeyValue, mdTitle } from '../lib/format.js';
 
 export const generateImageTool = {
   name: 'generate_image',
   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' +
+    'Queue an AI image job via Posterly using Nano Banana (Gemini) or Grok Imagine Image 2.0 (xAI). Returns job_id. Poll get_image_job until status is completed, then pass urls to create_post as media_url / media_urls. Gemini thinking high does not change the credit price.\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, quality/thinking, resolution) 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' +
     '  • Instagram feed / LinkedIn: 1:1 (square) or 4:5 (portrait)\n' +
@@ -53,10 +53,19 @@ export const generateImageTool = {
       .optional()
       .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'])
+      .enum(['low', 'medium', 'high'])
       .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.'),
+      .describe('Google: high turns on Gemini thinking (dashboard thinkingLevel=high). low/medium leave thinking minimal unless thinking_level is set. xAI: low or medium credit tiers; high is invalid.'),
+    thinking_level: z
+      .enum(['minimal', 'high'])
+      .optional()
+      .describe('Google flash/lite only. Gemini image quality control. minimal is fastest; high is for infographics, grounded scenes, and harder layouts. Pro reasons automatically. Overrides quality when both are set.'),
+    reference_image_urls: z
+      .array(z.string().url())
+      .max(14)
+      .optional()
+      .describe('Google only. Up to 14 HTTPS image URLs used as references (logo, product, style lock). Same as dashboard reference images.'),
+    confirm: z.literal(true).describe('Must be true after explicit user confirmation of subject, style, aspect ratio, quality, and credit use.'),
   }),
 
   async execute(
@@ -69,7 +78,9 @@ export const generateImageTool = {
       provider?: 'google' | 'xai';
       model?: 'lite' | 'flash' | 'pro';
       resolution?: '512' | '1K' | '2K' | '4K';
-      quality?: 'low' | 'medium';
+      quality?: 'low' | 'medium' | 'high';
+      thinking_level?: 'minimal' | 'high';
+      reference_image_urls?: string[];
       confirm: true;
     }
   ) {
@@ -80,23 +91,16 @@ export const generateImageTool = {
     const result = await client.generateImage(payload);
 
     return [
-      mdTitle(`✅ Generated ${result.images.length} image${result.images.length === 1 ? '' : 's'}`, `Model: ${result.model}`),
-      mdTable(
-        ['#', 'Image URL', 'Filename'],
-        result.images.map((img, index) => [
-          index + 1,
-          img.url,
-          img.filename,
-        ]),
-      ),
+      mdTitle('Image job queued', `Job: ${result.job_id}`),
       mdKeyValue([
-        ['Billed from', result.usage.billed_from],
+        ['Status', result.status],
+        ['Model', result.model],
+        ['Resolution', result.resolution],
+        ['Thinking', result.thinking_level || undefined],
         ['Credits used', result.credits_used],
-        ['Plan usage', result.usage.limit != null ? `${result.usage.used ?? 0}/${result.usage.limit} this ${result.usage.period || 'period'}` : undefined],
-        ['Plan tier', result.usage.tier || undefined],
+        ['Billed from', result.usage?.billed_from],
       ]),
-      result.warnings?.length ? mdSection('Warnings', mdBullets(result.warnings)) : '',
-      '**Next step:** Pass any URL above to `create_post` as `media_url`, or use multiple as `media_urls` for a carousel.',
+      result.message || 'Poll get_image_job with this job_id until status is completed, then pass urls to create_post.',
     ].filter(Boolean).join('\n\n');
   },
 };