Designforyou MCP Server

Return the no-server-LLM Living Panels authoring brief: PanelScript instructions, schema, unit templates, and success criteria. Use this when the MCP client will do the creative direction with its own model, then call comic_submit_design with the authored Story JSON.

Return the current Story JSON, stale-write hash, allowed patch paths, and dirty-node contract for a client-authored Living Panels revision. Use this when the client will decide the edit with its own model, then call comic_submit_revision.

Check asset-production progress for a comic created with create_comic: panels, motion clips, and voice lines done vs total, plus ready=true when the whole comic is live at its reader_url. Free to call.

Accept a client-authored Living Panels Story JSON and start artifact production without using a server story LLM. The client does direction; DesignForYou validates, saves, generates character sheets, panel/unit art, motion clips, voice-over, and assembles the public reader.

Apply a client-authored Living Panels revision without using a server revision LLM. Targeted changes regenerate only inferred dirty producer nodes such as panel:<id>, motion:<id>, or tts:<bubble_id>.

Write and produce a Living Panels interactive comic from a one-paragraph premise. One call writes a complete 5-page comic (panels, dialogue, motion plan, voice casting) and starts generating every asset in the background: character sheet, ~13 panels of art with character consistency, ambient image-to-video motion for the liveliest panels, and per-line voice-over. Returns immediately with the story summary and a public reader_url where the comic can be read, watched live, and heard. Production takes several minutes — poll comic_status until ready, then share the reader_url.

Generate one or more finished images from a template (get a template_id from recommend_template or browse_templates) plus a description. Use this after the user has selected or explicitly supplied a template_id; otherwise call `recommend_template` first so the visual gallery can collect the selection. Works for all categories (Instagram, logo, app-store, Visual Novel backgrounds/sprites, CG illustrations). Pass variants for multi-image output (expressions, time-of-day, etc.). Pass session_id to refine a prior result. Pass context_ids to ground a new image on prior designs (character consistency for VN CG scenes).

Generate a short realistic character video from structured requirements. The tool gives DesignForYou's reusable home-video character template and the user's requirements to a text LLM, which writes a fresh final video prompt while preserving character consistency, camera imperfections, ambient audio, and requested shot structure. It then generates a Gemini Omni Flash video. Use this for 3-10 second character/lifestyle clips.

Generate one actor-grounded narrative first frame from one to four existing LetMeActForYou actor_ids plus location, wardrobe, pose, and composition. Uses actor headshots as image references and returns a stored image_url. For multi-shot continuity, first generate a wide scene reference, then pass its scene_frame_id as continuity_scene_frame_id while specifying a fresh camera setup in composition and fresh blocking in pose for every shot. Pass only the actor_ids that should be visible in that shot. Pass composition_reference_url to preserve a Blender previs frame's camera and blocking while replacing proxy geometry with actors and the finished set. Defaults to Gemini; pass provider='grok' to use Grok Imagine. Use this before animation when a close-up headshot is not enough.

Generate one fixed-grid visual-novel character sprite sheet, crop it into cell assets, remove the chroma-key background, validate transparent sprites, and return a VN Creator-ready manifest. Base cost: 3 credits. Optional quality.hi_res_cells=true adds a reference-grounded per-cell re-render at full native resolution (fixes cells being limited to ~1/N of the sheet resolution) and bills +2 credits per cell re-rendered. quality.hi_res_model optionally routes the hi-res pass to a specific model (e.g. gpt-image-2 for fabric fidelity).

Generate a short image-to-video take with xAI Grok Imagine Video from one reference frame. The result is normalized to the requested source duration.

Generate a short vertical image-to-video take from one supplied reference frame. Use an HTTPS artifact URL or a data URL when exact source style and composition need to anchor the shot.

Generate a short video take conditioned on one supplied source clip. Preserves the source shot's actors, illustration style, wardrobe, camera, and action more closely than a still-frame reference.

Start a casting audition: the chosen actor performs your cue in a short (~8-10s) vertical video. Billed. Returns audition_id immediately; poll audition_status every few seconds until status=ready, then share video_url. Get actor_id from casting_roster.

Check a casting audition started with audition: status (rendering / ready / failed) and, when ready, the video_url to share. Free to call.

Permanently remove the authenticated user's media and user-authored direction for one ready or refunded-failed audition. Keeps a minimal tombstone for billing, refund, and lineage audit. Destructive and free.

Create a private reusable LetMeActForYou actor. Generates a casting headshot, stores it on S3, and returns actor_id for cast_character or audition. When available, provide a saved full-body standing performance_reference_url; all generated clips prioritize it over the profile headshot. The default casting template produces an original Pixar-quality 3D animated feature-film headshot; pass stable fictional physical identity, not performance direction. Apparent age may be child, teen, adult, or elderly.

Delete an unused private actor and headshot. Refuses seeded actors and actors referenced by active castings or auditions. Destructive and free.

List only the public seeded LetMeActForYou casting roster with headshots, type, and bio. This public catalog never includes a user's private actors; authenticated users can retrieve those with my_actors. Call this first, show the user the seed actors, then call audition with the chosen actor_id.

Delete an unused authenticated-user casting. Refuses while active auditions reference it. Destructive and free.

Check a queued MiniMax H3 video for free. Pass wait_seconds (up to 900) to keep this MCP call open until the job completes, fails, or is cancelled; completed jobs include the persistent S3 video_url. This works from any MCP thread authenticated as the same account that queued the job.

Remove one queued MiniMax H3 job. For an active render, use the safe cancellation action instead.

List only the authenticated user's private reusable LetMeActForYou actors, newest first. Free. Supports bounded offset pagination and never returns internal identity prompts or visual descriptions.

Assemble ordered local video segments or HTTPS generated-artifact URLs into one normalized 9:16 MP4. This is the missing composition step for multi-take LetMeActForYou stories.

List only the authenticated user's LetMeActForYou audition history, newest first. Free. Supports bounded offset pagination and an optional queued, rendering, ready, or failed status filter.

Browse the DesignForYou template catalog. Optionally filter by category (e.g. 'instagram', 'app-store', 'logo', 'living-panels'). Returns template IDs, names, and previews.

Bind a seeded or private actor to one story character. Returns a casting_id that keeps character identity and story provenance across takes.

Return the authenticated user's current credit balance, usage, and Stripe subscription status. Free to call.

Add one or more prompts to your private self-hosted MiniMax H3 queue. Each prompt costs 5 credits. Choose 5, 8, 10, or 15 seconds and optionally attach up to five image URLs; images are references by default, with optional first/last frame roles. Queued jobs resume automatically when the offline GPU worker returns.

Recommend the best matching templates for any use case. Describe what you need and the system auto-detects the category and ranks templates by relevance. Return the recommendations so the user can pick a template from the visual gallery; do not call `generate` in the same turn unless the user explicitly names a template_id or asks you to skip selection.

Move a queued MiniMax H3 job one place earlier or later. It never interrupts an active render.

Report a visible LetMeActForYou actor or an audition owned by the authenticated user. Free. Stores bounded triage metadata without copying prompts, media URLs, billing data, or account identity.

Create a child take from an existing audition. Inherits actor, story casting, cue, emotion, and line unless overrides are supplied, while preserving parent/root ids and the director note.

Create a private reusable DesignForYou template from a structured brief. The returned template_id works immediately with get_text_fields and generate. This stores a user-owned template in the canonical catalog collection; it does not publish it to the anonymous gallery.

List a template's editable text fields (headline, subhead, CTA, etc.) with their current values. Free. Use right after a template is chosen and BEFORE `generate` when you want to fill the template's fields precisely instead of relying on a freeform description.

Return a fixed, no-cost DesignForYou widget payload for ChatGPT Apps debugging. Use this only to verify the template gallery/result iframe renders correctly; it does not generate images, use an LLM, or charge credits.