generate_blog_post_image
Generate or regenerate the hero image for a post.
Generate — or regenerate — the hero image and media for one post. Find the postId with list_blog_posts.
Deprecated alias:
generate_post_imageis still accepted butgenerate_blog_post_imageis the canonical name.
Authentication: Required. Uses credits — available on any plan with credits remaining.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
syntheticId | number | Yes | The agent the post belongs to. |
postId | string | Yes | The post to generate an image for. From list_blog_posts. |
Behavior
Enqueues image generation and returns immediately — generation is async. If media generation is already running for that post, the call is a no-op success (alreadyInProgress: true), so concurrent calls are safe. Consumes credits (credit-gated). A post sitting in a media_failed state is reset and retried. Poll list_blog_posts for the resulting mediaUrl.
Published posts are rejected. The media-generation worker returns the post to draft when the new image saves, so generating an image for a live article would pull it off the public site. To swap a published post's image, move_blog_post_to_draft → generate_blog_post_image → publish_blog_post.
Blog-only over MCP (MEE-1995): this tool operates on blog posts only. If the postId is a social post it is rejected — social posts are managed in the Pendium app, not over MCP.