posterly-mcp-server 0.40.1 → 0.43.1

package/README.md

@@ -122,7 +122,7 @@ Add the same server definition to your Cursor MCP settings:
 
 ## Available tools
 
-`posterly-mcp-server@0.40.1` exposes 89 tools.
+`posterly-mcp-server@0.43.1` exposes 90 tools.
 
 Public setup tools work before `POSTERLY_API_KEY` exists:
 
@@ -180,7 +180,8 @@ Authenticated tools require `POSTERLY_API_KEY`:
 - `list_media`
 - `find_available_slot`
 - `generate_captions`
-- `generate_image`
+- `generate_image` (queues a Railway job; Gemini thinking_level / quality high, resolution up to 4K, optional reference_image_urls)
+- `get_image_job` (poll one job or list recent image jobs)
 - `get_video_options`
 - `run_video_function` (read-only Veo helpers for cost estimation and request validation)
 - `generate_video` (queues a cost-guarded Veo video job)

package/dist/index.js

@@ -38,6 +38,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';
@@ -576,6 +577,15 @@ server.tool(generateImageTool.name, generateImageTool.description, generateImage
         return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
     }
 });
+server.tool(getImageJobTool.name, getImageJobTool.description, getImageJobTool.inputSchema.shape, getToolAnnotations(getImageJobTool.name), async (input) => {
+    try {
+        const text = await getImageJobTool.execute(client, input);
+        return { content: [{ type: 'text', text }] };
+    }
+    catch (err) {
+        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+    }
+});
 server.tool(getPostTool.name, getPostTool.description, getPostTool.inputSchema.shape, getToolAnnotations(getPostTool.name), async (input) => {
     try {
         const text = await getPostTool.execute(client, input);

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

@@ -162,6 +162,12 @@ export interface InstagramPostSettings {
     }>;
     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;
 }
@@ -855,6 +861,28 @@ export interface PublicSignupResponse {
 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;
@@ -1065,24 +1093,24 @@ export declare 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;
         };
     }>;
     getVideoOptions(): Promise<Record<string, any>>;
@@ -1116,6 +1144,14 @@ export declare class PosterlyClient {
         job?: VideoJob;
         jobs?: VideoJob[];
     }>;
+    getImageJob(params?: {
+        job_id?: string;
+        status?: string;
+        limit?: number;
+    }): Promise<{
+        job?: ImageJob;
+        jobs?: ImageJob[];
+    }>;
     findAvailableSlots(params?: {
         account_ids?: string[];
         timezone?: string;

package/dist/lib/api-client.js

@@ -326,6 +326,18 @@ export class PosterlyClient {
         const qs = searchParams.toString();
         return this.request('GET', `/ai/video-jobs${qs ? `?${qs}` : ''}`);
     }
+    async getImageJob(params) {
+        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) {
         const searchParams = new URLSearchParams();
         if (params?.account_ids?.length)

package/dist/lib/version.d.ts

@@ -1 +1 @@
-export declare const POSTERLY_MCP_VERSION = "0.40.1";
+export declare const POSTERLY_MCP_VERSION = "0.43.1";

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.40.1';
+export const POSTERLY_MCP_VERSION = '0.43.1';

package/dist/tools/add-google-business-media.d.ts

@@ -14,16 +14,16 @@ export declare const addGoogleBusinessMediaTool: {
         confirm: z.ZodLiteral<true>;
     }, "strip", z.ZodTypeAny, {
         confirm: true;
-        category: "COVER" | "PROFILE" | "LOGO" | "EXTERIOR" | "INTERIOR" | "PRODUCT" | "AT_WORK" | "FOOD_AND_DRINK" | "MENU" | "COMMON_AREA" | "ROOMS" | "TEAMS" | "ADDITIONAL";
         source_url: string;
+        category: "COVER" | "PROFILE" | "LOGO" | "EXTERIOR" | "INTERIOR" | "PRODUCT" | "AT_WORK" | "FOOD_AND_DRINK" | "MENU" | "COMMON_AREA" | "ROOMS" | "TEAMS" | "ADDITIONAL";
         workspace_id?: string | undefined;
         account_id?: number | undefined;
         location_id?: string | undefined;
         media_format?: "PHOTO" | "VIDEO" | undefined;
     }, {
         confirm: true;
-        category: "COVER" | "PROFILE" | "LOGO" | "EXTERIOR" | "INTERIOR" | "PRODUCT" | "AT_WORK" | "FOOD_AND_DRINK" | "MENU" | "COMMON_AREA" | "ROOMS" | "TEAMS" | "ADDITIONAL";
         source_url: string;
+        category: "COVER" | "PROFILE" | "LOGO" | "EXTERIOR" | "INTERIOR" | "PRODUCT" | "AT_WORK" | "FOOD_AND_DRINK" | "MENU" | "COMMON_AREA" | "ROOMS" | "TEAMS" | "ADDITIONAL";
         workspace_id?: string | undefined;
         account_id?: number | undefined;
         location_id?: string | undefined;