@usemo.com/sdk 0.1.0

package/src/catalog.json

@@ -0,0 +1,1599 @@
+[
+  {
+    "annotations": {
+      "destructiveHint": false,
+      "idempotentHint": false,
+      "openWorldHint": true,
+      "readOnlyHint": false,
+      "title": "Generate an image (spends credits)"
+    },
+    "command": "images create",
+    "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        ",
+    "inputSchema": {
+      "additionalProperties": false,
+      "properties": {
+        "aspect_ratio": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "e.g. '1:1', '9:16', '16:9'. Omit for square.",
+          "title": "Aspect Ratio"
+        },
+        "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"
+        },
+        "model": {
+          "default": "flux-dev",
+          "description": "A customer-routable image model.",
+          "enum": [
+            "flux-dev",
+            "sdxl",
+            "flux2_flex",
+            "flux2_pro"
+          ],
+          "title": "Model",
+          "type": "string"
+        },
+        "negative_prompt": {
+          "anyOf": [
+            {
+              "maxLength": 1000,
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Negative Prompt"
+        },
+        "num_images": {
+          "default": 1,
+          "description": "How many variations (1-4).",
+          "maximum": 4,
+          "minimum": 1,
+          "title": "Num Images",
+          "type": "integer"
+        },
+        "project_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Project Id"
+        },
+        "prompt": {
+          "description": "What to draw.",
+          "maxLength": 2000,
+          "minLength": 1,
+          "title": "Prompt",
+          "type": "string"
+        },
+        "twin_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Optional digital-twin id to render the person's likeness.",
+          "title": "Twin Id"
+        }
+      },
+      "required": [
+        "prompt"
+      ],
+      "title": "GenerateImageInput",
+      "type": "object"
+    },
+    "method": "POST",
+    "name": "usemo_generate_image",
+    "path": "/generate",
+    "positional": "prompt"
+  },
+  {
+    "annotations": {
+      "destructiveHint": false,
+      "idempotentHint": false,
+      "openWorldHint": true,
+      "readOnlyHint": false,
+      "title": "Create a video from a brief (spends credits)"
+    },
+    "command": "videos create",
+    "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        ",
+    "inputSchema": {
+      "additionalProperties": false,
+      "properties": {
+        "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"
+        },
+        "async_plan": {
+          "default": true,
+          "description": "Queue storyboard planning with rendering to avoid gateway timeouts. Recommended.",
+          "title": "Async Plan",
+          "type": "boolean"
+        },
+        "brand_voice": {
+          "anyOf": [
+            {
+              "maxLength": 1000,
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Optional tone/voice override.",
+          "title": "Brand Voice"
+        },
+        "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"
+        },
+        "iterate": {
+          "default": false,
+          "description": "If true, iterate the storyboard toward its best version before rendering (slower, higher quality).",
+          "title": "Iterate",
+          "type": "boolean"
+        },
+        "persona_prompt": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Optional description of the on-screen presenter/persona.",
+          "title": "Persona Prompt"
+        }
+      },
+      "required": [
+        "ask"
+      ],
+      "title": "CreateVideoInput",
+      "type": "object"
+    },
+    "method": "POST",
+    "name": "usemo_create_video",
+    "path": "/video/create",
+    "positional": "ask"
+  },
+  {
+    "annotations": {
+      "destructiveHint": false,
+      "idempotentHint": false,
+      "openWorldHint": true,
+      "readOnlyHint": false,
+      "title": "Generate a video (spends credits)"
+    },
+    "command": "videos generate",
+    "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        ",
+    "inputSchema": {
+      "additionalProperties": false,
+      "anyOf": [
+        {
+          "required": [
+            "input_image_url"
+          ]
+        },
+        {
+          "required": [
+            "input_image_asset_id"
+          ]
+        }
+      ],
+      "properties": {
+        "duration_sec": {
+          "default": 5,
+          "description": "Clip length in seconds: one of 5, 15, 30, 60.",
+          "enum": [
+            5,
+            15,
+            30,
+            60
+          ],
+          "title": "Duration Sec",
+          "type": "integer"
+        },
+        "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"
+        },
+        "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"
+        },
+        "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"
+        },
+        "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"
+        },
+        "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"
+        },
+        "quality": {
+          "default": "quality",
+          "description": "'fast' or 'quality'.",
+          "enum": [
+            "fast",
+            "quality"
+          ],
+          "title": "Quality",
+          "type": "string"
+        },
+        "resolution": {
+          "default": "720p",
+          "description": "'480p', '720p', or '1080p'.",
+          "enum": [
+            "480p",
+            "720p",
+            "1080p"
+          ],
+          "title": "Resolution",
+          "type": "string"
+        }
+      },
+      "required": [
+        "motion_prompt"
+      ],
+      "title": "GenerateVideoInput",
+      "type": "object"
+    },
+    "method": "POST",
+    "name": "usemo_generate_video",
+    "path": "/video/generate",
+    "positional": "motion_prompt"
+  },
+  {
+    "annotations": {
+      "destructiveHint": false,
+      "idempotentHint": false,
+      "openWorldHint": true,
+      "readOnlyHint": true,
+      "title": "Plan a video (grounded storyboard)"
+    },
+    "command": "videos plan",
+    "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        ",
+    "inputSchema": {
+      "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"
+    },
+    "method": "POST",
+    "name": "usemo_plan_video",
+    "path": "/video/storyboard",
+    "positional": "ask"
+  },
+  {
+    "annotations": {
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": true,
+      "readOnlyHint": true,
+      "title": "Quote video cost"
+    },
+    "command": "videos quote",
+    "description": "Estimate the cost (COGS) of producing a storyboard at draft / standard / premium\n        tiers, BEFORE spending any credits. Always quote before generating so the user can\n        approve the spend.\n\n        Returns: {\"tiers\": {\"draft\": {...}, \"standard\": {...}, \"premium\": {...}}}.\n        ",
+    "inputSchema": {
+      "$defs": {
+        "Tier": {
+          "enum": [
+            "draft",
+            "standard",
+            "premium"
+          ],
+          "title": "Tier",
+          "type": "string"
+        }
+      },
+      "additionalProperties": false,
+      "anyOf": [
+        {
+          "required": [
+            "storyboard"
+          ]
+        },
+        {
+          "required": [
+            "shots"
+          ]
+        }
+      ],
+      "properties": {
+        "shots": {
+          "anyOf": [
+            {
+              "items": {
+                "type": "object"
+              },
+              "type": "array"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "A list of shot objects. Provide this OR `storyboard`.",
+          "title": "Shots"
+        },
+        "storyboard": {
+          "anyOf": [
+            {
+              "type": "object"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "A storyboard object returned by usemo_plan_video. Provide this OR `shots`.",
+          "title": "Storyboard"
+        },
+        "tier": {
+          "$ref": "#/$defs/Tier",
+          "default": "standard",
+          "description": "Quality/cost tier: 'draft' (cheapest), 'standard', or 'premium'."
+        }
+      },
+      "title": "QuoteCostInput",
+      "type": "object"
+    },
+    "method": "POST",
+    "name": "usemo_quote_cost",
+    "path": "/video/scene-video/quote",
+    "positional": null
+  },
+  {
+    "annotations": {
+      "destructiveHint": false,
+      "idempotentHint": false,
+      "openWorldHint": true,
+      "readOnlyHint": false
+    },
+    "command": "videos script",
+    "description": "Turn a supplied script into a video. Spends credits; returns a job handle.",
+    "inputSchema": {
+      "additionalProperties": false,
+      "properties": {
+        "aspect_ratio": {
+          "default": "16:9",
+          "enum": [
+            "16:9",
+            "9:16",
+            "1:1"
+          ],
+          "title": "Aspect Ratio",
+          "type": "string"
+        },
+        "brand_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Brand Id"
+        },
+        "broll_prompts": {
+          "items": {
+            "type": "string"
+          },
+          "maxItems": 8,
+          "title": "Broll Prompts",
+          "type": "array"
+        },
+        "project_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Project Id"
+        },
+        "script": {
+          "maxLength": 4000,
+          "minLength": 20,
+          "title": "Script",
+          "type": "string"
+        },
+        "twin_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Twin Id"
+        },
+        "use_context": {
+          "default": true,
+          "title": "Use Context",
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "script"
+      ],
+      "title": "ScriptToVideoRequest",
+      "type": "object"
+    },
+    "method": "POST",
+    "name": "usemo_script_to_video",
+    "path": "/video/script-to-video",
+    "positional": "script"
+  },
+  {
+    "annotations": {
+      "destructiveHint": false,
+      "idempotentHint": false,
+      "openWorldHint": true,
+      "readOnlyHint": false,
+      "title": "Generate written content"
+    },
+    "command": "content create",
+    "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        ",
+    "inputSchema": {
+      "$defs": {
+        "ContentFormat": {
+          "enum": [
+            "text",
+            "markdown",
+            "json"
+          ],
+          "title": "ContentFormat",
+          "type": "string"
+        },
+        "ContentUseCase": {
+          "enum": [
+            "general",
+            "blog",
+            "email",
+            "deck"
+          ],
+          "title": "ContentUseCase",
+          "type": "string"
+        }
+      },
+      "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"
+        },
+        "max_tokens": {
+          "default": 800,
+          "description": "Max length of the output.",
+          "maximum": 4096,
+          "minimum": 64,
+          "title": "Max Tokens",
+          "type": "integer"
+        },
+        "prompt": {
+          "description": "What to write (e.g. 'a LinkedIn post announcing our Series A').",
+          "maxLength": 12000,
+          "minLength": 1,
+          "title": "Prompt",
+          "type": "string"
+        },
+        "response_format": {
+          "$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"
+        },
+        "temperature": {
+          "default": 0.7,
+          "description": "Creativity (0=precise, 2=wild).",
+          "maximum": 2,
+          "minimum": 0,
+          "title": "Temperature",
+          "type": "number"
+        },
+        "use_case": {
+          "$ref": "#/$defs/ContentUseCase",
+          "default": "general",
+          "description": "Tunes tone/structure: 'general', 'blog', 'email', or 'deck'."
+        }
+      },
+      "required": [
+        "prompt"
+      ],
+      "title": "GenerateContentInput",
+      "type": "object"
+    },
+    "method": "POST",
+    "name": "usemo_generate_content",
+    "path": "/generate/text",
+    "positional": "prompt"
+  },
+  {
+    "annotations": {
+      "destructiveHint": false,
+      "idempotentHint": false,
+      "openWorldHint": true,
+      "readOnlyHint": false
+    },
+    "command": "content social",
+    "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        ",
+    "inputSchema": {
+      "$defs": {
+        "AssetInput": {
+          "properties": {
+            "asset_id": {
+              "anyOf": [
+                {
+                  "format": "uuid",
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "title": "Asset Id"
+            },
+            "base64_data": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "title": "Base64 Data"
+            },
+            "source_url": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "title": "Source Url"
+            }
+          },
+          "title": "AssetInput",
+          "type": "object"
+        }
+      },
+      "additionalProperties": false,
+      "properties": {
+        "aspect_ratio": {
+          "default": "1:1",
+          "enum": [
+            "1:1",
+            "16:9",
+            "9:16",
+            "4:5"
+          ],
+          "title": "Aspect Ratio",
+          "type": "string"
+        },
+        "brand_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Brand Id"
+        },
+        "cta": {
+          "anyOf": [
+            {
+              "maxLength": 60,
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Cta"
+        },
+        "headline": {
+          "maxLength": 200,
+          "minLength": 1,
+          "title": "Headline",
+          "type": "string"
+        },
+        "input_image": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/AssetInput"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null
+        },
+        "project_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Project Id"
+        },
+        "subtext": {
+          "anyOf": [
+            {
+              "maxLength": 400,
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Subtext"
+        }
+      },
+      "required": [
+        "headline"
+      ],
+      "title": "SocialPostComposeRequest",
+      "type": "object"
+    },
+    "method": "POST",
+    "name": "usemo_create_social_post",
+    "path": "/collateral/social-post",
+    "positional": "headline"
+  },
+  {
+    "annotations": {
+      "destructiveHint": false,
+      "idempotentHint": false,
+      "openWorldHint": true,
+      "readOnlyHint": false
+    },
+    "command": "content deck",
+    "description": "Create a presentation from a title and brief. Spends credits; returns a job handle.",
+    "inputSchema": {
+      "$defs": {
+        "AssetInput": {
+          "properties": {
+            "asset_id": {
+              "anyOf": [
+                {
+                  "format": "uuid",
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "title": "Asset Id"
+            },
+            "base64_data": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "title": "Base64 Data"
+            },
+            "source_url": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "title": "Source Url"
+            }
+          },
+          "title": "AssetInput",
+          "type": "object"
+        }
+      },
+      "additionalProperties": false,
+      "properties": {
+        "brand_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Brand Id"
+        },
+        "brief": {
+          "maxLength": 8000,
+          "minLength": 1,
+          "title": "Brief",
+          "type": "string"
+        },
+        "project_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Project Id"
+        },
+        "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"
+        },
+        "subtitle": {
+          "anyOf": [
+            {
+              "maxLength": 200,
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Subtitle"
+        },
+        "title": {
+          "maxLength": 200,
+          "minLength": 1,
+          "title": "Title",
+          "type": "string"
+        }
+      },
+      "required": [
+        "title",
+        "brief"
+      ],
+      "title": "DeckComposeRequest",
+      "type": "object"
+    },
+    "method": "POST",
+    "name": "usemo_create_deck",
+    "path": "/collateral/deck",
+    "positional": "title"
+  },
+  {
+    "annotations": {
+      "destructiveHint": false,
+      "idempotentHint": false,
+      "openWorldHint": true,
+      "readOnlyHint": false
+    },
+    "command": "content article",
+    "description": "Write an SEO article grounded in brand context. Spends credits; returns a job handle.",
+    "inputSchema": {
+      "additionalProperties": false,
+      "properties": {
+        "audience": {
+          "anyOf": [
+            {
+              "maxLength": 300,
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Audience"
+        },
+        "brand_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Brand Id"
+        },
+        "project_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Project Id"
+        },
+        "target_keyword": {
+          "anyOf": [
+            {
+              "maxLength": 200,
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Target Keyword"
+        },
+        "topic": {
+          "maxLength": 300,
+          "minLength": 3,
+          "title": "Topic",
+          "type": "string"
+        },
+        "use_context": {
+          "default": true,
+          "title": "Use Context",
+          "type": "boolean"
+        },
+        "word_count": {
+          "default": 1200,
+          "maximum": 3000,
+          "minimum": 400,
+          "title": "Word Count",
+          "type": "integer"
+        }
+      },
+      "required": [
+        "topic"
+      ],
+      "title": "SeoArticleRequest",
+      "type": "object"
+    },
+    "method": "POST",
+    "name": "usemo_create_article",
+    "path": "/content/seo-article",
+    "positional": "topic"
+  },
+  {
+    "annotations": {
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": true,
+      "readOnlyHint": true,
+      "title": "Get job status"
+    },
+    "command": "jobs get",
+    "description": "Get the current status of one generation job, including progress and (when finished)\n        the result URLs.\n\n        Returns: {job_id, status, progress, progress_message, result_urls, credits_cost, error}.\n        ",
+    "inputSchema": {
+      "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"
+    },
+    "method": "GET",
+    "name": "usemo_job_status",
+    "path": "/jobs/{job_id}",
+    "positional": "job_id"
+  },
+  {
+    "annotations": {
+      "destructiveHint": false,
+      "idempotentHint": false,
+      "openWorldHint": true,
+      "readOnlyHint": true,
+      "title": "Wait for a job to finish"
+    },
+    "command": "jobs wait",
+    "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        ",
+    "inputSchema": {
+      "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"
+    },
+    "method": "GET",
+    "name": "usemo_wait_for_job",
+    "path": "/jobs/{job_id}",
+    "positional": "job_id"
+  },
+  {
+    "annotations": {
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": true,
+      "readOnlyHint": true,
+      "title": "List recent jobs"
+    },
+    "command": "jobs list",
+    "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        ",
+    "inputSchema": {
+      "additionalProperties": false,
+      "properties": {
+        "limit": {
+          "default": 20,
+          "maximum": 100,
+          "minimum": 1,
+          "title": "Limit",
+          "type": "integer"
+        },
+        "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"
+        }
+      },
+      "title": "ListJobsInput",
+      "type": "object"
+    },
+    "method": "GET",
+    "name": "usemo_list_jobs",
+    "path": "/jobs",
+    "positional": null
+  },
+  {
+    "annotations": {
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": true,
+      "readOnlyHint": true,
+      "title": "List assets"
+    },
+    "command": "assets list",
+    "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        ",
+    "inputSchema": {
+      "additionalProperties": false,
+      "properties": {
+        "limit": {
+          "default": 50,
+          "maximum": 100,
+          "minimum": 1,
+          "title": "Limit",
+          "type": "integer"
+        },
+        "search": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Free-text search over asset names/tags.",
+          "title": "Search"
+        },
+        "type": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Filter by asset type (e.g. 'video', 'image', 'audio').",
+          "title": "Type"
+        }
+      },
+      "title": "ListAssetsInput",
+      "type": "object"
+    },
+    "method": "GET",
+    "name": "usemo_list_assets",
+    "path": "/assets",
+    "positional": null
+  },
+  {
+    "annotations": {
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": true,
+      "readOnlyHint": true,
+      "title": "Get asset details"
+    },
+    "command": "assets get",
+    "description": "Get full details for one asset, including its download/preview URL.\n\n        Returns the asset object: {id, type, name, url, created_at, metadata, ...}.\n        ",
+    "inputSchema": {
+      "additionalProperties": false,
+      "properties": {
+        "asset_id": {
+          "description": "The asset id.",
+          "title": "Asset Id",
+          "type": "string"
+        }
+      },
+      "required": [
+        "asset_id"
+      ],
+      "title": "AssetIdInput",
+      "type": "object"
+    },
+    "method": "GET",
+    "name": "usemo_get_asset",
+    "path": "/assets/{asset_id}",
+    "positional": "asset_id"
+  },
+  {
+    "annotations": {
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": true,
+      "readOnlyHint": true,
+      "title": "List digital twins"
+    },
+    "command": "twins list",
+    "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        ",
+    "inputSchema": {
+      "additionalProperties": false,
+      "properties": {
+        "limit": {
+          "default": 50,
+          "maximum": 100,
+          "minimum": 1,
+          "title": "Limit",
+          "type": "integer"
+        },
+        "status": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Filter by status (e.g. 'ready').",
+          "title": "Status"
+        }
+      },
+      "title": "ListTwinsInput",
+      "type": "object"
+    },
+    "method": "GET",
+    "name": "usemo_list_twins",
+    "path": "/twins",
+    "positional": null
+  },
+  {
+    "annotations": {
+      "destructiveHint": false,
+      "idempotentHint": false,
+      "openWorldHint": true,
+      "readOnlyHint": false,
+      "title": "Render a digital twin (spends credits)"
+    },
+    "command": "twins render",
+    "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        ",
+    "inputSchema": {
+      "$defs": {
+        "AspectRatio": {
+          "enum": [
+            "9:16",
+            "1:1",
+            "16:9"
+          ],
+          "title": "AspectRatio",
+          "type": "string"
+        }
+      },
+      "additionalProperties": false,
+      "properties": {
+        "aspect_ratio": {
+          "$ref": "#/$defs/AspectRatio",
+          "default": "9:16"
+        },
+        "audio_asset_id": {
+          "description": "Asset id of the voiceover audio the avatar should lip-sync to.",
+          "title": "Audio Asset Id",
+          "type": "string"
+        },
+        "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"
+        },
+        "project_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Project Id"
+        },
+        "style_prompt": {
+          "anyOf": [
+            {
+              "maxLength": 2000,
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Style Prompt"
+        },
+        "twin_id": {
+          "description": "The digital-twin id (from usemo_list_twins).",
+          "title": "Twin Id",
+          "type": "string"
+        }
+      },
+      "required": [
+        "twin_id",
+        "audio_asset_id"
+      ],
+      "title": "RenderTwinInput",
+      "type": "object"
+    },
+    "method": "POST",
+    "name": "usemo_render_twin",
+    "path": "/twins/{twin_id}/avatar/render",
+    "positional": "twin_id"
+  },
+  {
+    "annotations": {
+      "destructiveHint": false,
+      "idempotentHint": false,
+      "openWorldHint": true,
+      "readOnlyHint": false,
+      "title": "Synthesize a twin's voice (spends credits)"
+    },
+    "command": "twins speak",
+    "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        ",
+    "inputSchema": {
+      "additionalProperties": false,
+      "properties": {
+        "language": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Optional language override.",
+          "title": "Language"
+        },
+        "script_text": {
+          "description": "The text to speak.",
+          "maxLength": 20000,
+          "minLength": 1,
+          "title": "Script Text",
+          "type": "string"
+        },
+        "style_prompt": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Optional delivery/style direction.",
+          "title": "Style Prompt"
+        },
+        "twin_id": {
+          "description": "The digital-twin id whose voice to use (from usemo_list_twins).",
+          "title": "Twin Id",
+          "type": "string"
+        }
+      },
+      "required": [
+        "twin_id",
+        "script_text"
+      ],
+      "title": "SynthesizeVoiceInput",
+      "type": "object"
+    },
+    "method": "POST",
+    "name": "usemo_synthesize_voice",
+    "path": "/twins/{twin_id}/voice/synthesize",
+    "positional": "twin_id"
+  },
+  {
+    "annotations": {
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": true,
+      "readOnlyHint": true,
+      "title": "Get brand context"
+    },
+    "command": "brand get",
+    "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        ",
+    "inputSchema": {
+      "additionalProperties": false,
+      "properties": {},
+      "type": "object"
+    },
+    "method": "GET",
+    "name": "usemo_get_brand_context",
+    "path": "/context/profile",
+    "positional": null
+  },
+  {
+    "annotations": {
+      "destructiveHint": false,
+      "idempotentHint": false,
+      "openWorldHint": true,
+      "readOnlyHint": false,
+      "title": "Learn brand context from a website"
+    },
+    "command": "brand learn",
+    "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        ",
+    "inputSchema": {
+      "additionalProperties": false,
+      "properties": {
+        "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"
+    },
+    "method": "POST",
+    "name": "usemo_learn_context",
+    "path": "/context/sources/website",
+    "positional": "url"
+  },
+  {
+    "annotations": {
+      "destructiveHint": false,
+      "idempotentHint": false,
+      "openWorldHint": true,
+      "readOnlyHint": true,
+      "title": "Suggest video ideas"
+    },
+    "command": "ideas suggest",
+    "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        ",
+    "inputSchema": {
+      "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"
+    },
+    "method": "POST",
+    "name": "usemo_suggest_ideas",
+    "path": "/companion/suggest",
+    "positional": "brief"
+  },
+  {
+    "annotations": {
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": true,
+      "readOnlyHint": true,
+      "title": "Quote a multi-video campaign"
+    },
+    "command": "campaigns quote",
+    "description": "Estimate the per-video and campaign-total cost (COGS) 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 cost at the chosen tier.\n        ",
+    "inputSchema": {
+      "$defs": {
+        "Tier": {
+          "enum": [
+            "draft",
+            "standard",
+            "premium"
+          ],
+          "title": "Tier",
+          "type": "string"
+        }
+      },
+      "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": {
+          "$ref": "#/$defs/Tier",
+          "default": "standard",
+          "description": "Quality/cost tier for the estimate."
+        }
+      },
+      "required": [
+        "concepts"
+      ],
+      "title": "PlanCampaignInput",
+      "type": "object"
+    },
+    "method": "POST",
+    "name": "usemo_plan_campaign",
+    "path": "/video/campaign/plan",
+    "positional": null
+  }
+]