posterly-mcp-server 0.40.0 → 0.43.0

package/src/tools/get-image-job.ts

@@ -0,0 +1,36 @@
+import { z } from 'zod';
+import type { PosterlyClient, ImageJob } from '../lib/api-client.js';
+
+export const getImageJobTool = {
+  name: 'get_image_job',
+  description:
+    'Get one AI image generation job by ID, or list recent image jobs when job_id is omitted. Use after generate_image to poll for completed urls.',
+  inputSchema: z.object({
+    job_id: z.string().optional(),
+    status: z.enum(['pending', 'processing', 'completed', 'failed']).optional(),
+    limit: z.number().int().min(1).max(50).default(10).optional(),
+  }),
+
+  async execute(client: PosterlyClient, input: { job_id?: string; status?: string; limit?: number }) {
+    const result = await client.getImageJob(input);
+    if (result.job) return formatJob(result.job, true);
+
+    const jobs = result.jobs || [];
+    return [
+      `Image jobs (${jobs.length})`,
+      jobs.map((job) => formatJob(job, false)).join('\n\n'),
+    ].filter(Boolean).join('\n');
+  },
+};
+
+function formatJob(job: ImageJob, includeRaw: boolean): string {
+  const lines = [
+    `${job.id}: ${job.status}`,
+    `Prompt: ${job.prompt}`,
+    `Model: ${job.model}; resolution: ${job.resolution}; thinking: ${job.thinking_level || 'n/a'}; cost: ${job.credit_cost}`,
+    job.urls?.length ? `URLs: ${job.urls.join(', ')}` : null,
+    job.error_message ? `Error: ${job.error_message}` : null,
+    includeRaw ? `\nRaw job:\n${JSON.stringify(job, null, 2)}` : null,
+  ];
+  return lines.filter(Boolean).join('\n');
+}

package/src/tools/update-post.ts

@@ -2,6 +2,13 @@ import { z } from 'zod';
 import type { PosterlyClient } from '../lib/api-client.js';
 import { code, formatDateTime, mdKeyValue, mdQuote, mdSection, mdTitle, statusLabel } from '../lib/format.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.');
+
 const instagramSettingsSchema = z.object({
   __type: z.enum(['instagram', 'instagram-standalone']).optional(),
   post_type: z.enum(['post', 'feed', 'story', 'reel', 'carousel']).optional(),
@@ -18,6 +25,7 @@ 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_cover_method: z.string().optional(),
   reel_thumb_offset: z.number().nonnegative().optional(),
@@ -30,6 +38,7 @@ 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_cover_method: z.string().optional(),
   reel_thumb_offset: z.number().nonnegative().optional(),

package/tool-annotations.json

@@ -51,6 +51,7 @@
     "run_video_function",
     "generate_video",
     "get_video_job",
+    "get_image_job",
     "generate_captions",
     "generate_image",
     "get_post",
@@ -118,6 +119,7 @@
     "list_media",
     "get_video_options",
     "get_video_job",
+    "get_image_job",
     "get_post",
     "get_post_missing",
     "get_account_analytics",
@@ -203,6 +205,7 @@
     "run_video_function",
     "generate_video",
     "get_video_job",
+    "get_image_job",
     "generate_captions",
     "generate_image",
     "ask_support",