Actions / Media
Design poster
Read and createdesign_poster
Designs a branded poster, infographic or 3 to 6 slide carousel. Text is rendered exactly as given. Saved to the Media Library. Uses AI credits.
Needs the write scope. Creates or changes things in Chirpy. Publishes nothing.
Inputs
| Input | Type | Required | Description |
|---|---|---|---|
kind | "poster" | "infographic" | "carousel" | Yes | |
platformSize | "instagram_square" | "instagram_portrait" | "story" | "linkedin_horizontal" | "facebook_post" | "a4_poster" | ||
headline | string | Poster: main line | |
supportingText | string | Poster: one or two short lines | |
offer | string | ||
dateTime | string | ||
cta | string | ||
contactInfo | string | ||
notes | string | Style or layout notes | |
title | string | Infographic title | |
subtitle | string | ||
stats | object[] | Infographic: 2 to 8 figures Each item: label (required), value (required). | |
source | string | Infographic: where the figures come from | |
topic | string | Carousel: what it is about | |
audience | string | ||
slides | object[] | Carousel: 3 to 10 slides, text rendered on each Each item: role, text (required). | |
referenceFileIds | integer[] | Up to 5 Media Library image fileIds to use as references: the user's photos, product or style to follow. Use the ids of images the user attached in this chat, or ones you found with list_media and look_at_media. Up to 5. |
REST
curl https://chirpy.me/api/v1/design_poster \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"kind":"poster"}'MCP
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "design_poster",
"arguments": {
"kind": "poster"
}
}
}MCP hints: readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false.
