edit_design
ChatGPTChange an existing Krumzi image, carousel, or document from plain-language instructions. Saves changes directly without an MCP review step. Uses AI and may retrieve public web content or media; consumes account credits, including for some partial results. Requires an eligible account and credit balance. Returns design_id, status 'editing', editor_url, and a before_preview_url when available. Usually takes 1-5 minutes; poll get_design every 20-30 seconds, then inspect its preview. Before-preview rendering may use a trial render allowance. Repeating a call can apply and charge for another edit. Does not edit video, publish, or schedule posts.
export_design
ChatGPTExport an existing Krumzi design to publicly accessible download URLs. Compatible clients display image exports, including each slide/page, in an embedded export card with download links. Use that card for visual output; present any url or urls in the assistant response as ordinary download links, never Markdown image embeds. Single-image designs support PNG, JPG, WebP, or single-page PDF and return url plus size_in_bytes. Carousels/documents require format 'urls' and return urls, width, and height for separate JPEG slides/pages, at most 1440px wide with aspect ratio preserved. No video, multi-page PDF, or ZIP export through MCP. Creates new files and an export-history entry on every call. No AI credits are charged, but account export access and trial render allowances apply; eligible trials receive watermarked files. Does not publish or schedule posts.
generate_ai_image
ChatGPTGenerate a standalone raster image asset from a prompt, such as an illustration, photo-style image, logo, or icon. Uses an external AI service and uploads the image to a publicly accessible Krumzi storage URL. Returns image_url; does not create an editable design, layout, or carousel. For an editable post, thumbnail, or other layout, use generate_design. Requires account access and credits; charged after successful generation. Each call creates a new image. is_graphic also removes the background for transparency.
generate_design
ChatGPTCreate an editable Instagram post, LinkedIn or Instagram carousel, YouTube thumbnail, social media graphic, flyer, or banner. Can turn supplied text or a web page into a carousel, or create a multi-page document. Saves a new Krumzi design and applies available brand context. Uses AI and may retrieve public web content or media; consumes account credits, including for some partial results. Requires an eligible account and credit balance. Returns design_id, status 'generating', and editor_url; usually takes 1-5 minutes. Poll get_design every 20-30 seconds and inspect the result. Repeating this call creates another design. Does not publish, schedule posts, or create video.
get_brand_kit
ChatGPTRead the saved colors, color shades, fonts, and logos for an active Krumzi brand the account belongs to. Returns brandId, brandName, and brandKit (null when no kit exists). Does not return Brand Mind or brand voice. Use when the user wants to inspect existing brand styling; generation already loads available brand context. Omit brand_id for the default brand, or use list_brands to identify a specific brand. Does not change brand settings or consume credits.
get_design
ChatGPTInspect one existing Krumzi image, carousel, or document. Returns id, name, format, canvas size, element_count, editor_url, and status. While a generation/edit lock is active, returns 'generating' without rendering or consuming a trial render allowance. Otherwise returns 'ready' and attempts a new publicly accessible preview, returning preview_url or preview_error. Ready means no active lock, not confirmed work success. Poll every 20-30 seconds after generate_design or edit_design, then inspect the result. Ready-state preview attempts may consume a trial render allowance; no AI credits are charged. Preview access depends on account entitlement. Compatible clients display a preview card; do not duplicate its image in the assistant response. Without embedded UI, provide preview_url and editor_url as ordinary links, not Markdown image embeds. Does not modify design content. Video is unsupported.
list_brands
ChatGPTList active Krumzi brands this account belongs to. Returns brands with brand_id, name, membership role, and is_default; archived brands are excluded. Use to find the intended brand for generate_design or get_brand_kit when the user has multiple brands. Does not change the default brand or consume credits.
list_designs
ChatGPTFind this account's recent Krumzi images, carousels, and documents, newest first. Returns designs with id, name, format, created_at, and editor_url, up to limit. Use an id to inspect, edit, or export an existing design. Excludes templates and video; does not search design text or paginate beyond the latest 50 matching designs. Does not modify designs, render previews, or consume credits.
