org.swapp1990.designforyou/designforyou

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.

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.

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.

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>.

Create a private LetMeActForYou actor draft. Generates a casting headshot, stores it on S3, and returns actor_id for cast_character or audition. Draft actors never appear in the public feed; an authorized operator can call publish_actor with an approved seamless idle-loop URL when the actor is ready. 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.

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.

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.

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

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.

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

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). Set model to 'minimax-h3-image-balanced' or 'minimax-h3-image-quality' (or use the 'h3 balanced'/'h3 quality' aliases) to render through the MiniMax H3 image service; context_ids are forwarded as ordered H3 reference images.

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.

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

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.

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.

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.

Promote an operator-owned actor draft into the shared public LetMeActForYou roster and bind its approved seamless idle-loop video. Only configured public actor publishers and first-party internal services can call this tool. Auditions remain private to the user who generated them.

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.

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.

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).

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.