{"name":"io.github.gaufire/usemo-mcp","title":"UseMo","version":"0.1.0","description":"Create brand-grounded videos, images, ad campaigns, social posts, and decks with UseMo.","websiteUrl":"https://usemo.com/agents","documentationUrl":"https://usemo.com/agents.md","repositoryUrl":"https://github.com/gaufire/usemo-mcp","cursorInstallUrl":"https://cursor.com/link/mcp/install?name=usemo&config=eyJ1cmwiOiJodHRwczovL2FwaS51c2Vtby5jb20vbWNwIn0%3D","llmsTxtUrl":"https://usemo.com/llms.txt","openApiUrl":"https://api.usemo.com/api/openapi.json","remotes":[{"type":"streamable-http","url":"https://api.usemo.com/mcp","oauthProtectedResourceMetadata":"https://api.usemo.com/.well-known/oauth-protected-resource/mcp","authMethods":["oauth2","api-key"]}],"packages":[{"registryType":"npm","identifier":"@usemo.com/sdk","version":"0.1.0","binary":"usemo-mcp","transport":"stdio"}],"toolCount":41,"tools":[{"name":"usemo_whoami","title":"Inspect workspace identity, plan, and credits","description":"Return safe caller identity: workspace id/name, account plan, scopes, remaining\n        workspace credits, and concurrency/video-length limits. Never returns secrets.\n\n        Call this before paid generation to verify you are connected to the intended workspace\n        and have sufficient credits. Read-only.\n        ","annotations":{"title":"Inspect workspace identity, plan, and credits","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"inputSchema":{"properties":{},"title":"usemo_whoamiArguments","type":"object"}},{"name":"usemo_get_capabilities","title":"Get enabled models, formats, and credit costs","description":"Return live workspace capabilities: enabled image models, aspect ratios, video\n        durations/resolutions, per-operation credit costs, upload limits, and whether beta\n        Cartoon Studio is enabled for this workspace. Read-only.\n        ","annotations":{"title":"Get enabled models, formats, and credit costs","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"inputSchema":{"properties":{},"title":"usemo_get_capabilitiesArguments","type":"object"}},{"name":"usemo_get_brand_context","title":"Get brand context","description":"Return the workspace's learned brand profile (what UseMo knows about this business:\n        product, audience, voice) and how complete that knowledge is.\n\n        Call this first to ground ideation and scripts. If coverage is low, suggest the user add\n        their website in the UseMo app so generations are on-brand.\n\n        Returns: {\"profile\": {...}, \"coverage\": {...}} or an error string.\n        ","annotations":{"title":"Get brand context","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"inputSchema":{"properties":{},"title":"usemo_get_brand_contextArguments","type":"object"}},{"name":"usemo_suggest_ideas","title":"Suggest video ideas","description":"Propose fresh, on-brand short-video concepts for this workspace — one per content\n        pillar — each with a scroll-stopping hook, an angle, a format, and an estimated cost.\n\n        This is the \"what should I make today?\" tool. Read-only: it does not generate anything.\n\n        Returns: {\"ideas\": [{title, hook, angle, pillar, format, duration_sec}], \"plan\": {...},\n        \"grounded\": bool, \"context\": {...}}. Returns a setup hint if the workspace has no context.\n        ","annotations":{"title":"Suggest video ideas","readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"inputSchema":{"$defs":{"SuggestIdeasInput":{"additionalProperties":false,"properties":{"brief":{"anyOf":[{"maxLength":2000,"type":"string"},{"type":"null"}],"default":null,"description":"Optional steer for the ideas (e.g. 'promote our summer sale to Gen-Z'). Omit to get the proactive default: fresh high-performing concepts for this brand.","title":"Brief"}},"title":"SuggestIdeasInput","type":"object"}},"properties":{"params":{"$ref":"#/$defs/SuggestIdeasInput"}},"required":["params"],"title":"usemo_suggest_ideasArguments","type":"object"}},{"name":"usemo_plan_video","title":"Plan a video (grounded storyboard)","description":"Turn a plain-language ask into a grounded, fact-checked storyboard (shots, script,\n        on-screen text) using the workspace's brand context. Read-only — nothing is rendered.\n\n        Feed the returned `storyboard` into usemo_quote_cost to price it, then into the\n        generation tools to actually make it.\n\n        Returns: {\"storyboard\": {...}, \"shippable\": bool, \"verdict\": {...}}.\n        ","annotations":{"title":"Plan a video (grounded storyboard)","readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"inputSchema":{"$defs":{"PlanVideoInput":{"additionalProperties":false,"properties":{"ask":{"description":"What the video should accomplish, in plain language (e.g. 'a 30s founder talking-head explaining our new pricing').","maxLength":2000,"minLength":3,"title":"Ask","type":"string"},"brand_voice":{"anyOf":[{"maxLength":1000,"type":"string"},{"type":"null"}],"default":null,"description":"Optional tone/voice override for the script.","title":"Brand Voice"},"iterate":{"default":false,"description":"If true, the director iterates the storyboard toward its best version (slower, higher quality) instead of returning a first draft.","title":"Iterate","type":"boolean"}},"required":["ask"],"title":"PlanVideoInput","type":"object"}},"properties":{"params":{"$ref":"#/$defs/PlanVideoInput"}},"required":["params"],"title":"usemo_plan_videoArguments","type":"object"}},{"name":"usemo_create_video","title":"Create a video from a brief (spends credits)","description":"One-shot \"brief → finished video\", end to end through UseMo's quality harness.\n\n        Unlike usemo_generate_video (a single raw render), this plans a GROUNDED, fact-checked\n        storyboard (the critic gate blocks ungrounded claims before any spend) and then renders it\n        through the GATED pipeline (per-shot identity + realism gates with bounded aimed retry) — so\n        you get the best video we can produce from one sentence. SPENDS CREDITS.\n\n        If the plan can't be grounded it returns without spending, so you can refine the ask.\n\n        Returns (rendering): {\"shippable\": true, \"job_id\": str, \"status\": str, \"job_path\": str,\n        \"estimated_cost_usd\": float, \"storyboard\": {...}} — poll usemo_wait_for_job for the URL.\n        Returns (blocked): {\"shippable\": false, \"verdict\": {...}, \"reason\": str}.\n        ","annotations":{"title":"Create a video from a brief (spends credits)","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"inputSchema":{"$defs":{"CreateVideoInput":{"additionalProperties":false,"properties":{"idempotency_key":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"description":"Reuse the same key and payload after an uncertain submission; never blindly resubmit.","title":"Idempotency Key"},"async_plan":{"default":true,"description":"Queue storyboard planning with rendering to avoid gateway timeouts. Recommended.","title":"Async Plan","type":"boolean"},"ask":{"description":"One line describing the video to make (e.g. 'a 30s founder talking-head announcing our Series A').","maxLength":2000,"minLength":3,"title":"Ask","type":"string"},"brand_voice":{"anyOf":[{"maxLength":1000,"type":"string"},{"type":"null"}],"default":null,"description":"Optional tone/voice override.","title":"Brand Voice"},"persona_prompt":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional description of the on-screen presenter/persona.","title":"Persona Prompt"},"iterate":{"default":false,"description":"If true, iterate the storyboard toward its best version before rendering (slower, higher quality).","title":"Iterate","type":"boolean"}},"required":["ask"],"title":"CreateVideoInput","type":"object"}},"properties":{"params":{"$ref":"#/$defs/CreateVideoInput"}},"required":["params"],"title":"usemo_create_videoArguments","type":"object"}},{"name":"usemo_quote_cost","title":"Quote video cost","description":"Estimate the price of producing a storyboard at draft, standard, or premium tiers\n        before spending workspace credits. Always quote and confirm with the user before\n        submitting a paid video render. Read-only.\n\n        Returns: {\"tiers\": {\"draft\": {...}, \"standard\": {...}, \"premium\": {...}}}.\n        ","annotations":{"title":"Quote video cost","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"inputSchema":{"$defs":{"QuoteCostInput":{"additionalProperties":false,"properties":{"storyboard":{"anyOf":[{"type":"object"},{"type":"null"}],"default":null,"description":"A storyboard object returned by usemo_plan_video. Provide this OR `shots`.","title":"Storyboard"},"shots":{"anyOf":[{"items":{"type":"object"},"type":"array"},{"type":"null"}],"default":null,"description":"A list of shot objects. Provide this OR `storyboard`.","title":"Shots"},"tier":{"allOf":[{"$ref":"#/$defs/Tier"}],"default":"standard","description":"Quality/cost tier: 'draft' (cheapest), 'standard', or 'premium'."}},"title":"QuoteCostInput","type":"object"},"Tier":{"enum":["draft","standard","premium"],"title":"Tier","type":"string"}},"properties":{"params":{"$ref":"#/$defs/QuoteCostInput"}},"required":["params"],"title":"usemo_quote_costArguments","type":"object"}},{"name":"usemo_generate_video","title":"Generate a video (spends credits)","description":"Start an image-to-video generation job. SPENDS CREDITS. Returns immediately with a\n        job handle — the render runs asynchronously (seconds to minutes). Call usemo_wait_for_job\n        with the returned job_id to get the finished video URL.\n\n        Prefer quoting first (usemo_quote_cost) and confirming the spend with the user.\n\n        Returns: {\"job_id\": str, \"status\": \"queued\", \"credits_charged\": float, \"job_path\": str}.\n        ","annotations":{"title":"Generate a video (spends credits)","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"inputSchema":{"$defs":{"GenerateVideoInput":{"additionalProperties":false,"properties":{"idempotency_key":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"description":"Reuse the same key and payload after an uncertain submission; never blindly resubmit.","title":"Idempotency Key"},"motion_prompt":{"description":"What should happen / move in the shot (e.g. 'slow push-in, gentle smile').","maxLength":2000,"minLength":1,"title":"Motion Prompt","type":"string"},"input_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Public URL of the starting frame. Provide this OR an asset id.","title":"Input Image Url"},"input_image_asset_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Asset id of the starting frame (from usemo_list_assets or a generate call).","title":"Input Image Asset Id"},"duration_sec":{"default":5,"description":"Clip length in seconds: one of 5, 15, 30, 60.","title":"Duration Sec","type":"integer"},"resolution":{"default":"720p","description":"'480p', '720p', or '1080p'.","enum":["480p","720p","1080p"],"title":"Resolution","type":"string"},"quality":{"default":"quality","description":"'fast' or 'quality'.","enum":["fast","quality"],"title":"Quality","type":"string"},"negative_prompt":{"anyOf":[{"maxLength":2000,"type":"string"},{"type":"null"}],"default":null,"title":"Negative Prompt"},"project_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional project to file the job under.","title":"Project Id"}},"required":["motion_prompt"],"title":"GenerateVideoInput","type":"object"}},"properties":{"params":{"$ref":"#/$defs/GenerateVideoInput"}},"required":["params"],"title":"usemo_generate_videoArguments","type":"object"}},{"name":"usemo_generate_image","title":"Generate an image (spends credits)","description":"Start a text-to-image generation job. SPENDS CREDITS. Returns a job handle; poll with\n        usemo_wait_for_job for the resulting image URL(s). Pass a twin_id to render a person's\n        enrolled likeness.\n\n        Returns: {\"job_id\": str, \"status\": \"queued\", \"credits_charged\": float, \"job_path\": str}.\n        ","annotations":{"title":"Generate an image (spends credits)","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"inputSchema":{"$defs":{"GenerateImageInput":{"additionalProperties":false,"properties":{"idempotency_key":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"description":"Reuse the same key and payload after an uncertain submission; never blindly resubmit.","title":"Idempotency Key"},"prompt":{"description":"What to draw.","maxLength":2000,"minLength":1,"title":"Prompt","type":"string"},"model":{"default":"flux-dev","description":"A customer-routable image model.","enum":["flux-dev","sdxl","flux2_flex","flux2_pro"],"title":"Model","type":"string"},"num_images":{"default":1,"description":"How many variations (1-4).","maximum":4,"minimum":1,"title":"Num Images","type":"integer"},"aspect_ratio":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"e.g. '1:1', '9:16', '16:9'. Omit for square.","title":"Aspect Ratio"},"negative_prompt":{"anyOf":[{"maxLength":1000,"type":"string"},{"type":"null"}],"default":null,"title":"Negative Prompt"},"twin_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional digital-twin id to render the person's likeness.","title":"Twin Id"},"project_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Project Id"}},"required":["prompt"],"title":"GenerateImageInput","type":"object"}},"properties":{"params":{"$ref":"#/$defs/GenerateImageInput"}},"required":["params"],"title":"usemo_generate_imageArguments","type":"object"}},{"name":"usemo_list_twins","title":"List digital twins","description":"List the workspace's digital twins (enrolled avatars/clones) with their ids and status.\n        Use a twin's id with usemo_render_twin or usemo_generate_image.\n\n        Returns: {\"twins\": [{id, name, status, default_language}], \"count\": int}.\n        ","annotations":{"title":"List digital twins","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"inputSchema":{"$defs":{"ListTwinsInput":{"additionalProperties":false,"properties":{"status":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter by status (e.g. 'ready').","title":"Status"},"limit":{"default":50,"maximum":100,"minimum":1,"title":"Limit","type":"integer"}},"title":"ListTwinsInput","type":"object"}},"properties":{"params":{"$ref":"#/$defs/ListTwinsInput"}},"required":["params"],"title":"usemo_list_twinsArguments","type":"object"}},{"name":"usemo_render_twin","title":"Render a digital twin (spends credits)","description":"Render a talking-head video of a digital twin lip-syncing to a voiceover audio asset.\n        SPENDS CREDITS. Returns a job handle; poll with usemo_wait_for_job for the video URL.\n\n        Returns: {\"job_id\": str, \"status\": \"queued\", \"credits_charged\": float, \"job_path\": str}.\n        ","annotations":{"title":"Render a digital twin (spends credits)","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"inputSchema":{"$defs":{"AspectRatio":{"enum":["9:16","1:1","16:9"],"title":"AspectRatio","type":"string"},"RenderTwinInput":{"additionalProperties":false,"properties":{"idempotency_key":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"description":"Reuse the same key and payload after an uncertain submission; never blindly resubmit.","title":"Idempotency Key"},"twin_id":{"description":"The digital-twin id (from usemo_list_twins).","title":"Twin Id","type":"string"},"audio_asset_id":{"description":"Asset id of the voiceover audio the avatar should lip-sync to.","title":"Audio Asset Id","type":"string"},"aspect_ratio":{"allOf":[{"$ref":"#/$defs/AspectRatio"}],"default":"9:16"},"motion_asset_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional driving video for head motion; defaults to the twin's best clip.","title":"Motion Asset Id"},"style_prompt":{"anyOf":[{"maxLength":2000,"type":"string"},{"type":"null"}],"default":null,"title":"Style Prompt"},"project_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Project Id"}},"required":["twin_id","audio_asset_id"],"title":"RenderTwinInput","type":"object"}},"properties":{"params":{"$ref":"#/$defs/RenderTwinInput"}},"required":["params"],"title":"usemo_render_twinArguments","type":"object"}},{"name":"usemo_cartoon_create_series","title":"Start a kids cartoon series (spends credits)","description":"Start a preschool cartoon series (ages 3-6) in its own project, spoken in\n        ``language``. Beta: requires Cartoon Studio enabled on the workspace (check\n        ``cartoon_studio.enabled`` in ``usemo_get_capabilities`` first). A series bible\n        (world, cast, places, sound) is drafted from the brief for your approval.\n        SPENDS CREDITS. Returns {series, job}; wait for the job, then read the series.","annotations":{"title":"Start a kids cartoon series (spends credits)","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"inputSchema":{"$defs":{"CartoonSeriesInput":{"additionalProperties":false,"properties":{"idempotency_key":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"description":"Reuse the same key and payload after an uncertain submission; never blindly resubmit.","title":"Idempotency Key"},"title":{"description":"The series title.","maxLength":200,"minLength":2,"title":"Title","type":"string"},"brief":{"description":"What the show is about: the world, the characters, the kind of stories. A series bible is drafted from it for your approval.","maxLength":6000,"minLength":20,"title":"Brief","type":"string"},"language":{"default":"en","description":"The language the children hear. Voices can be designed in en, es, fr, de, it, pt, ru, ja, ko and zh; hi, bn, gu, kn, pa, te and ur use stock voices (or a twin's voice).","pattern":"^(en|hi|es|fr|de|bn|gu|kn|pa|te|ur|ja|it|pt|ko|ru|zh)$","title":"Language","type":"string"}},"required":["title","brief"],"title":"CartoonSeriesInput","type":"object"}},"properties":{"params":{"$ref":"#/$defs/CartoonSeriesInput"}},"required":["params"],"title":"usemo_cartoon_create_seriesArguments","type":"object"}},{"name":"usemo_cartoon_get_series","title":"Read a cartoon series","description":"A series with its bible, its cast (character packs, voices, designed voice\n        candidates with previews) and its episodes (status, findings, video).","annotations":{"title":"Read a cartoon series","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"inputSchema":{"$defs":{"CartoonSeriesIdInput":{"additionalProperties":false,"properties":{"series_id":{"maxLength":64,"minLength":1,"title":"Series Id","type":"string"}},"required":["series_id"],"title":"CartoonSeriesIdInput","type":"object"}},"properties":{"params":{"$ref":"#/$defs/CartoonSeriesIdInput"}},"required":["params"],"title":"usemo_cartoon_get_seriesArguments","type":"object"}},{"name":"usemo_cartoon_add_character","title":"Add a cartoon character and draw its pack (spends credits)","description":"Add a character from a description (and optionally your own art) and draw its\n        full character pack: an eight-view turnaround, expressions, construction close-ups,\n        a clean reference and a written guide. SPENDS CREDITS. Returns {character, job}.","annotations":{"title":"Add a cartoon character and draw its pack (spends credits)","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"inputSchema":{"$defs":{"CartoonCharacterInput":{"additionalProperties":false,"properties":{"idempotency_key":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"description":"Reuse the same key and payload after an uncertain submission; never blindly resubmit.","title":"Idempotency Key"},"series_id":{"maxLength":64,"minLength":1,"title":"Series Id","type":"string"},"name":{"maxLength":120,"minLength":1,"title":"Name","type":"string"},"description":{"maxLength":4000,"minLength":10,"title":"Description","type":"string"},"reference_asset_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Your own art for this character (an image asset id).","title":"Reference Asset Id"}},"required":["series_id","name","description"],"title":"CartoonCharacterInput","type":"object"}},"properties":{"params":{"$ref":"#/$defs/CartoonCharacterInput"}},"required":["params"],"title":"usemo_cartoon_add_characterArguments","type":"object"}},{"name":"usemo_cartoon_design_voice","title":"Design three voices for a character (spends credits)","description":"Design three candidate voices for a character, or for the narrator when no\n        character is given; each comes with a preview to listen to. SPENDS CREDITS.","annotations":{"title":"Design three voices for a character (spends credits)","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"inputSchema":{"$defs":{"CartoonVoiceDesignInput":{"additionalProperties":false,"properties":{"idempotency_key":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"description":"Reuse the same key and payload after an uncertain submission; never blindly resubmit.","title":"Idempotency Key"},"series_id":{"maxLength":64,"minLength":1,"title":"Series Id","type":"string"},"character_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"The character; leave empty for the narrator.","title":"Character Id"}},"required":["series_id"],"title":"CartoonVoiceDesignInput","type":"object"}},"properties":{"params":{"$ref":"#/$defs/CartoonVoiceDesignInput"}},"required":["params"],"title":"usemo_cartoon_design_voiceArguments","type":"object"}},{"name":"usemo_cartoon_set_voice","title":"Choose a voice for a character or the narrator","description":"Choose a stock voice, one of the designed candidates, or a twin's voice (the\n        twin needs voice consent on file). Free.","annotations":{"title":"Choose a voice for a character or the narrator","readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"inputSchema":{"$defs":{"CartoonVoiceInput":{"additionalProperties":false,"properties":{"series_id":{"maxLength":64,"minLength":1,"title":"Series Id","type":"string"},"character_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"The character; leave empty for the narrator.","title":"Character Id"},"source":{"pattern":"^(stock|designed|twin)$","title":"Source","type":"string"},"voice_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A stock voice id (source=stock).","title":"Voice Id"},"candidate_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A designed candidate (source=designed).","title":"Candidate Id"},"twin_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A twin with voice consent on file (source=twin).","title":"Twin Id"}},"required":["series_id","source"],"title":"CartoonVoiceInput","type":"object"}},"properties":{"params":{"$ref":"#/$defs/CartoonVoiceInput"}},"required":["params"],"title":"usemo_cartoon_set_voiceArguments","type":"object"}},{"name":"usemo_cartoon_create_episode","title":"Write a cartoon episode script (spends credits)","description":"Write an episode script from a premise and learning goal, or lay out your own\n        script as shots (every spoken word kept). The script comes back for approval;\n        nothing is rendered yet. SPENDS CREDITS. Returns {episode, job}.","annotations":{"title":"Write a cartoon episode script (spends credits)","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"inputSchema":{"$defs":{"CartoonEpisodeInput":{"additionalProperties":false,"properties":{"idempotency_key":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"description":"Reuse the same key and payload after an uncertain submission; never blindly resubmit.","title":"Idempotency Key"},"series_id":{"maxLength":64,"minLength":1,"title":"Series Id","type":"string"},"premise":{"anyOf":[{"maxLength":2000,"minLength":10,"type":"string"},{"type":"null"}],"default":null,"title":"Premise"},"learning_goal":{"anyOf":[{"maxLength":500,"minLength":5,"type":"string"},{"type":"null"}],"default":null,"title":"Learning Goal"},"target_seconds":{"default":60,"maximum":480,"minimum":30,"title":"Target Seconds","type":"integer"},"script_text":{"anyOf":[{"maxLength":20000,"minLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Your own script; every spoken word is kept as written.","title":"Script Text"}},"required":["series_id"],"title":"CartoonEpisodeInput","type":"object"}},"properties":{"params":{"$ref":"#/$defs/CartoonEpisodeInput"}},"required":["params"],"title":"usemo_cartoon_create_episodeArguments","type":"object"}},{"name":"usemo_cartoon_render_episode","title":"Make a cartoon episode from its script (spends credits)","description":"Make the approved script into the narrated episode (480p). Every character in\n        it needs a finished pack and every speaker a voice. SPENDS CREDITS, priced per\n        second. Returns {episode, job}.","annotations":{"title":"Make a cartoon episode from its script (spends credits)","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"inputSchema":{"$defs":{"CartoonRenderInput":{"additionalProperties":false,"properties":{"idempotency_key":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"description":"Reuse the same key and payload after an uncertain submission; never blindly resubmit.","title":"Idempotency Key"},"series_id":{"maxLength":64,"minLength":1,"title":"Series Id","type":"string"},"episode_id":{"maxLength":64,"minLength":1,"title":"Episode Id","type":"string"}},"required":["series_id","episode_id"],"title":"CartoonRenderInput","type":"object"}},"properties":{"params":{"$ref":"#/$defs/CartoonRenderInput"}},"required":["params"],"title":"usemo_cartoon_render_episodeArguments","type":"object"}},{"name":"usemo_cartoon_dub_episode","title":"Dub a cartoon episode into another language (spends credits)","description":"Dub a made episode into another language with PyAI: the picture is kept and the\n        speech is voiced again, keeping each speaker's voice and the music (not lip sync).\n        The dub of a draft episode is a draft too. SPENDS CREDITS, priced per second.\n        Returns {episode, job}.","annotations":{"title":"Dub a cartoon episode into another language (spends credits)","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"inputSchema":{"$defs":{"CartoonDubInput":{"additionalProperties":false,"properties":{"idempotency_key":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"description":"Reuse the same key and payload after an uncertain submission; never blindly resubmit.","title":"Idempotency Key"},"series_id":{"maxLength":64,"minLength":1,"title":"Series Id","type":"string"},"episode_id":{"maxLength":64,"minLength":1,"title":"Episode Id","type":"string"},"language":{"description":"The language to dub into, e.g. hi. PyAI dubs into hi, en, es, fr, de, it, pt, zh, ja, ko and ru, from a series in en, es, fr, de, hi, it or pt.","maxLength":8,"minLength":2,"title":"Language","type":"string"}},"required":["series_id","episode_id","language"],"title":"CartoonDubInput","type":"object"}},"properties":{"params":{"$ref":"#/$defs/CartoonDubInput"}},"required":["params"],"title":"usemo_cartoon_dub_episodeArguments","type":"object"}},{"name":"usemo_job_status","title":"Get job status","description":"Get the current status of one generation job, including progress and (when finished)\n        the result URLs and asset IDs. Read-only: polling never resubmits or charges credits.\n\n        Returns: {job_id, status, progress, progress_message, result_urls, asset_ids, credits_cost, error}.\n        ","annotations":{"title":"Get job status","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"inputSchema":{"$defs":{"JobIdInput":{"additionalProperties":false,"properties":{"job_id":{"description":"The job id returned by a generate/render tool.","title":"Job Id","type":"string"}},"required":["job_id"],"title":"JobIdInput","type":"object"}},"properties":{"params":{"$ref":"#/$defs/JobIdInput"}},"required":["params"],"title":"usemo_job_statusArguments","type":"object"}},{"name":"usemo_cancel_job","title":"Cancel an active job","description":"Cancel a queued or processing job and refund its held workspace credits.\n\n        Use only when the user explicitly wants to abort an in-flight job; do NOT call this just\n        because usemo_wait_for_job hit its bounded wait cap. Returns 409 if the job is already\n        completed, failed, or cancelled.\n        ","annotations":{"title":"Cancel an active job","readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":false},"inputSchema":{"$defs":{"JobIdInput":{"additionalProperties":false,"properties":{"job_id":{"description":"The job id returned by a generate/render tool.","title":"Job Id","type":"string"}},"required":["job_id"],"title":"JobIdInput","type":"object"}},"properties":{"params":{"$ref":"#/$defs/JobIdInput"}},"required":["params"],"title":"usemo_cancel_jobArguments","type":"object"}},{"name":"usemo_wait_for_job","title":"Wait for a job to finish","description":"Poll a job until it reaches a terminal state (completed/failed/cancelled) OR the\n        max_wait_sec cap is hit — whichever comes first. BOUNDED: it never blocks indefinitely.\n\n        If the cap is reached while the job is still running, returns the latest in-progress\n        status with timed_out=true so the caller can decide to wait again.\n\n        Returns: {job_id, status, progress, result_urls, credits_cost, error, timed_out: bool}.\n        ","annotations":{"title":"Wait for a job to finish","readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"inputSchema":{"$defs":{"WaitForJobInput":{"additionalProperties":false,"properties":{"job_id":{"description":"The job id to wait on.","title":"Job Id","type":"string"},"max_wait_sec":{"default":180,"description":"Hard cap on how long to wait (5-600s). Returns the latest status even if the job is still running when the cap is hit — it never blocks indefinitely.","maximum":600,"minimum":5,"title":"Max Wait Sec","type":"integer"},"poll_interval_sec":{"default":5,"maximum":30,"minimum":2,"title":"Poll Interval Sec","type":"integer"}},"required":["job_id"],"title":"WaitForJobInput","type":"object"}},"properties":{"params":{"$ref":"#/$defs/WaitForJobInput"}},"required":["params"],"title":"usemo_wait_for_jobArguments","type":"object"}},{"name":"usemo_list_jobs","title":"List recent jobs","description":"List recent generation jobs in this workspace (most recent first), trimmed to the\n        fields that matter. Use this to recover a job_id you lost or to check what's in flight.\n\n        Returns: {\"jobs\": [{job_id, status, progress, type, result_urls}], \"count\": int}.\n        ","annotations":{"title":"List recent jobs","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"inputSchema":{"$defs":{"ListJobsInput":{"additionalProperties":false,"properties":{"status":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter by status (queued/processing/completed/failed).","title":"Status"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter by job type.","title":"Type"},"limit":{"default":20,"maximum":100,"minimum":1,"title":"Limit","type":"integer"}},"title":"ListJobsInput","type":"object"}},"properties":{"params":{"$ref":"#/$defs/ListJobsInput"}},"required":["params"],"title":"usemo_list_jobsArguments","type":"object"}},{"name":"usemo_list_assets","title":"List assets","description":"List media assets in this workspace (generated outputs and uploads). Use asset ids as\n        inputs to generation tools (e.g. an audio asset for usemo_render_twin).\n\n        Returns: {\"assets\": [{id, type, name, url, ...}], \"count\": int}.\n        ","annotations":{"title":"List assets","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"inputSchema":{"$defs":{"ListAssetsInput":{"additionalProperties":false,"properties":{"type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter by asset type (e.g. 'video', 'image', 'audio').","title":"Type"},"search":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Free-text search over asset names/tags.","title":"Search"},"limit":{"default":50,"maximum":100,"minimum":1,"title":"Limit","type":"integer"}},"title":"ListAssetsInput","type":"object"}},"properties":{"params":{"$ref":"#/$defs/ListAssetsInput"}},"required":["params"],"title":"usemo_list_assetsArguments","type":"object"}},{"name":"usemo_get_asset","title":"Get asset details","description":"Get full details for one asset, including its MIME type, metadata, and a fresh\n        signed download/preview URL. Signed URLs expire; store the durable ``asset_id`` and call\n        ``usemo_get_asset`` to refresh an expired URL instead of regenerating the asset.\n\n        Returns the asset object: {id, type, mime_type, url, created_at, metadata_json, ...}.\n        ","annotations":{"title":"Get asset details","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"inputSchema":{"$defs":{"AssetIdInput":{"additionalProperties":false,"properties":{"asset_id":{"description":"The asset id.","title":"Asset Id","type":"string"}},"required":["asset_id"],"title":"AssetIdInput","type":"object"}},"properties":{"params":{"$ref":"#/$defs/AssetIdInput"}},"required":["params"],"title":"usemo_get_assetArguments","type":"object"}},{"name":"usemo_learn_context","title":"Learn brand context from a website","description":"Teach UseMo about a brand by reading its website — extracts product, audience, and voice\n        into the workspace's context so later generations are on-brand. Great for onboarding.\n\n        Returns a job handle; poll usemo_wait_for_job, then usemo_get_brand_context to see coverage.\n        ","annotations":{"title":"Learn brand context from a website","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"inputSchema":{"$defs":{"LearnContextInput":{"additionalProperties":false,"properties":{"idempotency_key":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"description":"Reuse the same key and payload after an uncertain submission; never blindly resubmit.","title":"Idempotency Key"},"url":{"description":"A website URL UseMo should read to learn this brand (product, audience, voice).","maxLength":2048,"minLength":8,"title":"Url","type":"string"}},"required":["url"],"title":"LearnContextInput","type":"object"}},"properties":{"params":{"$ref":"#/$defs/LearnContextInput"}},"required":["params"],"title":"usemo_learn_contextArguments","type":"object"}},{"name":"usemo_synthesize_voice","title":"Synthesize a twin's voice (spends credits)","description":"Generate spoken audio in a digital twin's voice from a script. SPENDS CREDITS. Returns a\n        job handle; poll usemo_wait_for_job for the audio asset (then usable as the audio for\n        usemo_render_twin).\n        ","annotations":{"title":"Synthesize a twin's voice (spends credits)","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"inputSchema":{"$defs":{"SynthesizeVoiceInput":{"additionalProperties":false,"properties":{"idempotency_key":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"description":"Reuse the same key and payload after an uncertain submission; never blindly resubmit.","title":"Idempotency Key"},"twin_id":{"description":"The digital-twin id whose voice to use (from usemo_list_twins).","title":"Twin Id","type":"string"},"script_text":{"description":"The text to speak.","maxLength":20000,"minLength":1,"title":"Script Text","type":"string"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional language override.","title":"Language"},"style_prompt":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional delivery/style direction.","title":"Style Prompt"}},"required":["twin_id","script_text"],"title":"SynthesizeVoiceInput","type":"object"}},"properties":{"params":{"$ref":"#/$defs/SynthesizeVoiceInput"}},"required":["params"],"title":"usemo_synthesize_voiceArguments","type":"object"}},{"name":"usemo_plan_campaign","title":"Quote a multi-video campaign","description":"Estimate the per-video and total campaign price for a set of video concepts —\n        e.g. the ``ideas`` from usemo_suggest_ideas. Read-only; nothing is rendered.\n\n        Returns per-concept + total estimate at the chosen tier.\n        ","annotations":{"title":"Quote a multi-video campaign","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"inputSchema":{"$defs":{"PlanCampaignInput":{"additionalProperties":false,"properties":{"concepts":{"description":"Video concepts to price (e.g. the `ideas` from usemo_suggest_ideas), one per format/pillar.","items":{"type":"object"},"minItems":1,"title":"Concepts","type":"array"},"tier":{"allOf":[{"$ref":"#/$defs/Tier"}],"default":"standard","description":"Quality/cost tier for the estimate."}},"required":["concepts"],"title":"PlanCampaignInput","type":"object"},"Tier":{"enum":["draft","standard","premium"],"title":"Tier","type":"string"}},"properties":{"params":{"$ref":"#/$defs/PlanCampaignInput"}},"required":["params"],"title":"usemo_plan_campaignArguments","type":"object"}},{"name":"usemo_create_profile_pic","title":"Create a professional headshot (spends credits)","description":"Generate an identity-locked professional headshot from a source photo URL in\n        'studio', 'outdoor', 'creative', or 'corporate' style. SPENDS CREDITS. Returns a job\n        handle; poll with usemo_wait_for_job for the finished portrait URL.\n        ","annotations":{"title":"Create a professional headshot (spends credits)","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"inputSchema":{"$defs":{"ProfilePicInput":{"additionalProperties":false,"properties":{"idempotency_key":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"description":"Reuse the same key and payload after an uncertain submission; never blindly resubmit.","title":"Idempotency Key"},"photo_url":{"description":"Public HTTPS URL of the source face photo.","maxLength":2048,"minLength":8,"title":"Photo Url","type":"string"},"style":{"default":"studio","description":"Headshot style preset: 'studio', 'outdoor', 'creative', or 'corporate'.","enum":["studio","outdoor","creative","corporate"],"title":"Style","type":"string"},"background":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Optional background description override.","title":"Background"},"brand_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional brand kit UUID; defaults to the workspace brand kit.","title":"Brand Id"}},"required":["photo_url"],"title":"ProfilePicInput","type":"object"}},"properties":{"params":{"$ref":"#/$defs/ProfilePicInput"}},"required":["params"],"title":"usemo_create_profile_picArguments","type":"object"}},{"name":"usemo_create_ads_campaign","title":"Create a multi-format ad campaign (spends credits)","description":"Generate a multi-format ad bundle in parallel (Instagram 1:1, Stories 9:16,\n        YouTube 16:9, LinkedIn 1:1) with brand-grounded copy and claim checking. SPENDS CREDITS.\n\n        Returns ``{\"jobs\": {\"instagram_square\": {...}, ...}, \"hook\": str, \"cta\": str}`` — poll\n        each format's ``job_id`` with ``usemo_wait_for_job``.\n        ","annotations":{"title":"Create a multi-format ad campaign (spends credits)","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"inputSchema":{"$defs":{"AdsCampaignInput":{"additionalProperties":false,"properties":{"idempotency_key":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"description":"Reuse the same key and payload after an uncertain submission; never blindly resubmit.","title":"Idempotency Key"},"hook":{"description":"Primary headline / hook text for the ad campaign.","maxLength":300,"minLength":1,"title":"Hook","type":"string"},"cta":{"default":"Learn more","description":"Call-to-action button copy.","maxLength":80,"minLength":1,"title":"Cta","type":"string"},"visual_context":{"anyOf":[{"maxLength":1000,"type":"string"},{"type":"null"}],"default":null,"description":"Scene description for the ad visuals (copy is composited separately).","title":"Visual Context"},"formats":{"description":"Formats to generate in parallel; each format returns its own job_id.","items":{"enum":["instagram_square","stories","youtube","linkedin"],"type":"string"},"minItems":1,"title":"Formats","type":"array"},"brand_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional brand kit UUID.","title":"Brand Id"}},"required":["hook"],"title":"AdsCampaignInput","type":"object"}},"properties":{"params":{"$ref":"#/$defs/AdsCampaignInput"}},"required":["params"],"title":"usemo_create_ads_campaignArguments","type":"object"}},{"name":"usemo_meme_face_swap","title":"Swap a consented face onto a meme (spends credits)","description":"Composite an adult's face onto a meme template image, optionally adding a brand-voiced\n        caption. Requires ``consent_confirmed=true`` confirming explicit permission from the\n        depicted person. SPENDS CREDITS; returns a job handle.\n        ","annotations":{"title":"Swap a consented face onto a meme (spends credits)","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"inputSchema":{"$defs":{"MemeFaceSwapInput":{"additionalProperties":false,"properties":{"idempotency_key":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"description":"Reuse the same key and payload after an uncertain submission; never blindly resubmit.","title":"Idempotency Key"},"source_face_url":{"description":"Public HTTPS URL of the adult source face photo.","maxLength":2048,"minLength":8,"title":"Source Face Url","type":"string"},"meme_template_url":{"description":"Public HTTPS URL of the meme template image.","maxLength":2048,"minLength":8,"title":"Meme Template Url","type":"string"},"consent_confirmed":{"const":true,"description":"Required: must be true to confirm explicit permission to use the depicted adult's likeness.","enum":[true],"title":"Consent Confirmed","type":"boolean"},"meme_name":{"anyOf":[{"maxLength":120,"type":"string"},{"type":"null"}],"default":null,"description":"Optional meme format name (enables brand-voiced captioning).","title":"Meme Name"},"face_identity":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Optional role description for the swapped face (e.g. 'a SaaS founder').","title":"Face Identity"},"caption":{"default":true,"description":"Auto-generate a brand-voiced caption when meme_name is provided.","title":"Caption","type":"boolean"},"target_face_index":{"anyOf":[{"maximum":31,"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"0-based left-to-right target face index for multi-face memes.","title":"Target Face Index"},"swap_all_faces":{"default":false,"description":"Swap every detected face with the source face.","title":"Swap All Faces","type":"boolean"},"brand_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional brand kit UUID.","title":"Brand Id"}},"required":["source_face_url","meme_template_url","consent_confirmed"],"title":"MemeFaceSwapInput","type":"object"}},"properties":{"params":{"$ref":"#/$defs/MemeFaceSwapInput"}},"required":["params"],"title":"usemo_meme_face_swapArguments","type":"object"}},{"name":"usemo_gif_face_swap","title":"Swap a consented face into a GIF (spends credits)","description":"Swap an adult's face across a reaction GIF and output a ready-to-share MP4 video asset.\n        Requires ``consent_confirmed=true`` confirming explicit permission from the depicted\n        person. SPENDS CREDITS; returns a job handle.\n        ","annotations":{"title":"Swap a consented face into a GIF (spends credits)","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"inputSchema":{"$defs":{"GifFaceSwapInput":{"additionalProperties":false,"properties":{"idempotency_key":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"description":"Reuse the same key and payload after an uncertain submission; never blindly resubmit.","title":"Idempotency Key"},"gif_url":{"description":"Public HTTPS URL of the target GIF.","maxLength":2048,"minLength":8,"title":"Gif Url","type":"string"},"source_face_url":{"description":"Public HTTPS URL of the adult source face photo.","maxLength":2048,"minLength":8,"title":"Source Face Url","type":"string"},"consent_confirmed":{"const":true,"description":"Required: must be true to confirm explicit permission to use the depicted adult's likeness.","enum":[true],"title":"Consent Confirmed","type":"boolean"}},"required":["gif_url","source_face_url","consent_confirmed"],"title":"GifFaceSwapInput","type":"object"}},"properties":{"params":{"$ref":"#/$defs/GifFaceSwapInput"}},"required":["params"],"title":"usemo_gif_face_swapArguments","type":"object"}},{"name":"usemo_generate_content","title":"Generate written content","description":"Generate on-brand written content — captions, posts, blog copy, email, or deck text.\n\n        Returns a job handle immediately; poll usemo_wait_for_job for the result.\n        The generated text is saved as an asset in the workspace.\n\n        Returns: {\"status\": \"queued\", \"job_id\": str, \"job_path\": str, \"note\": \"...\"}.\n        ","annotations":{"title":"Generate written content","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"inputSchema":{"$defs":{"ContentFormat":{"enum":["text","markdown","json"],"title":"ContentFormat","type":"string"},"ContentUseCase":{"enum":["general","blog","email","deck"],"title":"ContentUseCase","type":"string"},"GenerateContentInput":{"additionalProperties":false,"properties":{"idempotency_key":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"description":"Reuse the same key and payload after an uncertain submission; never blindly resubmit.","title":"Idempotency Key"},"prompt":{"description":"What to write (e.g. 'a LinkedIn post announcing our Series A').","maxLength":12000,"minLength":1,"title":"Prompt","type":"string"},"use_case":{"allOf":[{"$ref":"#/$defs/ContentUseCase"}],"default":"general","description":"Tunes tone/structure: 'general', 'blog', 'email', or 'deck'."},"response_format":{"allOf":[{"$ref":"#/$defs/ContentFormat"}],"default":"markdown","description":"Output format: 'markdown', 'text', or 'json'."},"system_prompt":{"anyOf":[{"maxLength":4000,"type":"string"},{"type":"null"}],"default":null,"description":"Optional steering instructions (voice, rules).","title":"System Prompt"},"max_tokens":{"default":800,"description":"Max length of the output.","maximum":4096,"minimum":64,"title":"Max Tokens","type":"integer"},"temperature":{"default":0.7,"description":"Creativity (0=precise, 2=wild).","maximum":2.0,"minimum":0.0,"title":"Temperature","type":"number"}},"required":["prompt"],"title":"GenerateContentInput","type":"object"}},"properties":{"params":{"$ref":"#/$defs/GenerateContentInput"}},"required":["params"],"title":"usemo_generate_contentArguments","type":"object"}},{"name":"usemo_create_social_post","title":"Create a social post","description":"Compose a branded social image with a headline and optional CTA. Spends credits.\n\n        Returns a job handle; use usemo_wait_for_job for the finished asset.\n        ","annotations":{"title":"Create a social post","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"inputSchema":{"$defs":{"AssetInput":{"properties":{"asset_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"default":null,"title":"Asset Id"},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Source Url"},"base64_data":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Base64 Data"}},"title":"AssetInput","type":"object"},"SocialPostComposeRequest":{"properties":{"headline":{"maxLength":200,"minLength":1,"title":"Headline","type":"string"},"subtext":{"anyOf":[{"maxLength":400,"type":"string"},{"type":"null"}],"default":null,"title":"Subtext"},"cta":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"title":"Cta"},"aspect_ratio":{"default":"1:1","enum":["1:1","16:9","9:16","4:5"],"title":"Aspect Ratio","type":"string"},"input_image":{"anyOf":[{"$ref":"#/$defs/AssetInput"},{"type":"null"}],"default":null},"twin_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Twin Id"},"clone_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Clone Id"},"brand_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Brand Id"},"project_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Project Id"},"idempotency_key":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Idempotency Key"}},"required":["headline"],"title":"SocialPostComposeRequest","type":"object"}},"properties":{"params":{"$ref":"#/$defs/SocialPostComposeRequest"}},"required":["params"],"title":"usemo_create_social_postArguments","type":"object"}},{"name":"usemo_create_deck","title":"Create a presentation","description":"Create a presentation from a title and brief. Spends credits; returns a job handle.","annotations":{"title":"Create a presentation","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"inputSchema":{"$defs":{"AssetInput":{"properties":{"asset_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"default":null,"title":"Asset Id"},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Source Url"},"base64_data":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Base64 Data"}},"title":"AssetInput","type":"object"},"DeckComposeRequest":{"properties":{"title":{"maxLength":200,"minLength":1,"title":"Title","type":"string"},"brief":{"maxLength":8000,"minLength":1,"title":"Brief","type":"string"},"subtitle":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"title":"Subtitle"},"slide_count":{"default":6,"maximum":12,"minimum":3,"title":"Slide Count","type":"integer"},"slide_images":{"items":{"$ref":"#/$defs/AssetInput"},"maxItems":8,"title":"Slide Images","type":"array"},"brand_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Brand Id"},"project_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Project Id"},"idempotency_key":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Idempotency Key"}},"required":["title","brief"],"title":"DeckComposeRequest","type":"object"}},"properties":{"params":{"$ref":"#/$defs/DeckComposeRequest"}},"required":["params"],"title":"usemo_create_deckArguments","type":"object"}},{"name":"usemo_create_article","title":"Create an SEO article","description":"Write an SEO article grounded in brand context. Spends credits; returns a job handle.","annotations":{"title":"Create an SEO article","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"inputSchema":{"$defs":{"SeoArticleRequest":{"properties":{"topic":{"maxLength":300,"minLength":3,"title":"Topic","type":"string"},"target_keyword":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"title":"Target Keyword"},"audience":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"title":"Audience"},"word_count":{"default":1200,"maximum":3000,"minimum":400,"title":"Word Count","type":"integer"},"brand_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Brand Id"},"project_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Project Id"},"use_context":{"default":true,"title":"Use Context","type":"boolean"},"idempotency_key":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Idempotency Key"}},"required":["topic"],"title":"SeoArticleRequest","type":"object"}},"properties":{"params":{"$ref":"#/$defs/SeoArticleRequest"}},"required":["params"],"title":"usemo_create_articleArguments","type":"object"}},{"name":"usemo_script_to_video","title":"Turn a script into a video","description":"Turn a supplied script into a video. Spends credits; returns a job handle.","annotations":{"title":"Turn a script into a video","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"inputSchema":{"$defs":{"ScriptToVideoRequest":{"properties":{"script":{"maxLength":4000,"minLength":20,"title":"Script","type":"string"},"broll_prompts":{"items":{"type":"string"},"maxItems":8,"title":"Broll Prompts","type":"array"},"aspect_ratio":{"default":"16:9","enum":["16:9","9:16","1:1"],"title":"Aspect Ratio","type":"string"},"twin_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Twin Id"},"clone_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Clone Id"},"voice_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Voice Id"},"brand_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Brand Id"},"project_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Project Id"},"use_context":{"default":true,"title":"Use Context","type":"boolean"},"mature_content_undertaking":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"title":"Mature Content Undertaking"},"idempotency_key":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Idempotency Key"}},"required":["script"],"title":"ScriptToVideoRequest","type":"object"}},"properties":{"params":{"$ref":"#/$defs/ScriptToVideoRequest"}},"required":["params"],"title":"usemo_script_to_videoArguments","type":"object"}},{"name":"usemo_run_outcome","title":"Run the Prompt-to-Outcome Creative Harness","description":"One-shot Prompt-to-Outcome harness: supply a brief plus optional portrait/product URLs\n        (sales pitch with client logo, talking head, character/object sheet, or ad).\n\n        With ``execute=false`` (default), returns the agent plan and trace without queueing a\n        render. With ``execute=true``, queues a paid render job (spends credits).\n        ","annotations":{"title":"Run the Prompt-to-Outcome Creative Harness","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"inputSchema":{"$defs":{"RunOutcomeInput":{"additionalProperties":false,"properties":{"idempotency_key":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"description":"Reuse the same key and payload after an uncertain submission; never blindly resubmit.","title":"Idempotency Key"},"brief":{"description":"One-sentence outcome brief (sales pitch with client logo, talking head, sheet, or ad).","maxLength":4000,"minLength":3,"title":"Brief","type":"string"},"attachments":{"anyOf":[{"items":{"type":"string"},"maxItems":8,"type":"array"},{"type":"null"}],"default":null,"description":"Optional public URLs or asset IDs for portraits/products.","title":"Attachments"},"gender":{"anyOf":[{"maxLength":32,"type":"string"},{"type":"null"}],"default":null,"title":"Gender"},"product_brand":{"anyOf":[{"maxLength":160,"type":"string"},{"type":"null"}],"default":null,"title":"Product Brand"},"execute":{"default":false,"description":"False previews the agent plan/trace without rendering; true queues a paid render job.","title":"Execute","type":"boolean"}},"required":["brief"],"title":"RunOutcomeInput","type":"object"}},"properties":{"params":{"$ref":"#/$defs/RunOutcomeInput"}},"required":["params"],"title":"usemo_run_outcomeArguments","type":"object"}},{"name":"usemo_build_sheet","title":"Build a 10-view Seedance Character or Object Sheet","description":"Build a 10-view identity-locked Character Sheet (for AI presenters) or design-locked\n        Object Sheet (for 360 product turnarounds). Read-only specification builder.\n        ","annotations":{"title":"Build a 10-view Seedance Character or Object Sheet","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"inputSchema":{"$defs":{"BuildSheetInput":{"additionalProperties":false,"properties":{"brief":{"description":"Character or product turnaround brief.","maxLength":4000,"minLength":3,"title":"Brief","type":"string"},"mode":{"default":"character","description":"'character' for identity-locked persona sheet or 'object' for 360 product sheet.","enum":["character","object"],"title":"Mode","type":"string"},"name":{"anyOf":[{"maxLength":120,"type":"string"},{"type":"null"}],"default":null,"title":"Name"},"seedance_version":{"default":"2.5","enum":["2.5","2.0"],"title":"Seedance Version","type":"string"}},"required":["brief"],"title":"BuildSheetInput","type":"object"}},"properties":{"params":{"$ref":"#/$defs/BuildSheetInput"}},"required":["params"],"title":"usemo_build_sheetArguments","type":"object"}},{"name":"usemo_get_started","title":"Get started with UseMo","description":"Get setup, workflow, and boundary guidance without reading private workspace data.","annotations":{"title":"Get started with UseMo","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"inputSchema":{"properties":{},"title":"usemo_get_startedArguments","type":"object"}},{"name":"usemo_discover_tools","title":"Find UseMo tools","description":"Find UseMo tools by user job, constraint, name, or description (offline, read-only).\n\n        Pass an empty query for the full catalog. Automatically filters to read-only tools when\n        the query negates spending/rendering, and returns explicit ``unsupported_constraint``\n        guidance when a hard privacy, local-only, realtime, or transcription constraint is asked.\n        ","annotations":{"title":"Find UseMo tools","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"inputSchema":{"properties":{"query":{"default":"","title":"Query","type":"string"}},"title":"usemo_discover_toolsArguments","type":"object"}}]}