list_blog_posts
List a brand's blog posts for an agent.
List a brand's blog posts for an agent. This is the discovery tool: use it to find a postId to iterate on before calling regenerate_blog_post or generate_blog_post_image.
Deprecated alias:
list_postsis still accepted butlist_blog_postsis the canonical name.
Authentication: Required
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
syntheticId | number | Yes | The agent ID whose posts to list. Use get_account to find your agent IDs. |
limit | number | No | Max posts to return, newest first. Default 25, max 50. The response includes totalCount so you can tell when there are more. |
Behavior
Returns up to limit blog posts, newest first, plus count (returned) and totalCount (all blog posts for the agent). Each post includes postId, title, platform (always blog), status, generationStatus, mediaId (nullable), mediaUrl (nullable), views (lifetime), and a linked workflow (id + name, nullable). Feed a postId into regenerate_blog_post or generate_blog_post_image.
mediaUrl is a directly-fetchable link: stock-library and uploaded hero images are returned as-is, and AI-generated media stored privately is returned as a short-lived signed URL that expires after about an hour (re-list to refresh it). It's null only when a post has no media yet or its media isn't ready to serve. mediaId is the underlying media record id when one exists.
Blog-only over MCP (MEE-1995): this returns the brand's blog posts only. Social posts are managed in the Pendium app, not over MCP.