Kuro

Update recipe

update_recipe

Destructive

Change anything about a recipe you own — its words, its model set, its document, its medium or its kind. Words apply to any row (a run row takes no cover focus points). An arm row takes model_id, allowed_models, recommended_model, config and suggested_params; a reprompt row takes those and writer; a run row takes definition. config, writer and definition are replaced WHOLE and re-validated whole — read get_own_recipe first and resend every slot, choice or step. To change the medium, pass model_kind (with the new medium's model_id, or its default model is used, and its settings reset). To change the kind, pass action: run needs a definition, reprompt needs a writer unless the row has one, and arm from a run row needs a config; the row keeps its words and its URL. Moving into or out of clips drops the cover. A published row is taken down before the edit and needs publish_recipe again.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "recipe_id": "<recipe_id>"
    },
    "name": "update_recipe"
  }
}

Input Schema

Name	Required	Description
`name`	No
`tags`	No
`action`	No
`config`	No
`writer`	No
`model_id`	No
`recipe_id`	Yes
`definition`	No	The whole workflow definition, replacing the stored one; read it with get_own_recipe first. Validated by the server like create_recipe's.
`highlights`	No
`model_kind`	No
`cover_focus`	No
`cover_shape`	No
`description`	No
`allowed_models`	No
`suggested_params`	No
`recommended_model`	No
`cover_before_focus`	No

Output Schema

Name	Required	Description	Default
`recipe`	Yes
`message`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed27 schema fields changedNov 4, 2026

addedOutput schema / properties / recipe / properties / recipe / description

Added value: +"A template that asks a few questions and makes something."

addedOutput schema / properties / recipe / properties / recipe / properties / action / description

Added value: +"`arm` makes one generation from your answers; `reprompt` does too, with a model writing the prompt from them; `run` starts a multi-step run (`GET /v1/runs/{id}`). New values may be added."

changedOutput schema / properties / recipe / properties / recipe / properties / action / enum

Previous value: -[
-  "arm",
-  "run",
-  "reprompt"
-]New value: +[
+  "arm",
+  "reprompt",
+  "run"
+]

removedOutput schema / properties / recipe / properties / recipe / properties / allowed_models
```
Removed value: -{
-  "items": {
-    "type": "string"
-  },
-  "type": "array"
-}
```
addedOutput schema / properties / recipe / properties / recipe / properties / app_url / $ref
```
Added value: +"#/properties/recipe/properties/recipe/properties/cover_url/anyOf/0"
```
removedOutput schema / properties / recipe / properties / recipe / properties / app_url / format
```
Removed value: -"uri"
```
removedOutput schema / properties / recipe / properties / recipe / properties / app_url / type
```
Removed value: -"string"
```
removedOutput schema / properties / recipe / properties / recipe / properties / arrangement
```
Removed value: -{}
```

addedOutput schema / properties / recipe / properties / recipe / properties / choices

Added value: +{
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "help": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "key": {
+        "type": "string"
+      },
+      "label": {
+        "type": "string"
+      },
+      "max_picks": {
+        "type": "integer"
+      },
+      "options": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "label": {
+              "type": "string"
+            },
+            "value": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "value",
+            "label"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "shown_when": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "choice": {
+                "type": "string"
+              },
+              "values": {
+                "items": {
+                  "type": "string"
+                },
+                "type": "array"
+              }
+            },
+            "required": [
+              "choice",
+              "values"
+            ],
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Asked only when that earlier choice holds one of these values."
+      }
+    },
+    "required": [
+      "key",
+      "label",
+      "help",
+      "options",
+      "max_picks",
+      "shown_when"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

addedOutput schema / properties / recipe / properties / recipe / properties / id
```
Added value: +{
+  "format": "uuid",
+  "type": "string"
+}
```

addedOutput schema / properties / recipe / properties / recipe / properties / inputs

Added value: +{
+  "description": "The media an `arm` or `reprompt` recipe takes, by key.",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "help": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "key": {
+        "type": "string"
+      },
+      "label": {
+        "type": "string"
+      },
+      "max_items": {
+        "type": "integer"
+      },
+      "media": {
+        "description": "\"image\", \"video\" or \"audio\".",
+        "type": "string"
+      },
+      "required": {
+        "type": "boolean"
+      },
+      "takes_subject": {
+        "description": "Whether this input takes one of your Subjects as `{ \"type\": \"subject\", \"subject_id\" }`.",
+        "type": "boolean"
+      }
+    },
+    "required": [
+      "key",
+      "label",
+      "help",
+      "media",
+      "required",
+      "max_items",
+      "takes_subject"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

addedOutput schema / properties / recipe / properties / recipe / properties / model

Added value: +{
+  "description": "The default model; null on a `run` recipe, whose steps choose their own.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

removedOutput schema / properties / recipe / properties / recipe / properties / model_id
```
Removed value: -{
-  "type": "string"
-}
```

removedOutput schema / properties / recipe / properties / recipe / properties / model_kind

Removed value: -{
-  "enum": [
-    "image",
-    "video",
-    "tts",
-    "music"
-  ],
-  "type": "string"
-}

addedOutput schema / properties / recipe / properties / recipe / properties / object
```
Added value: +{
+  "const": "recipe",
+  "type": "string"
+}
```

addedOutput schema / properties / recipe / properties / recipe / properties / prompt

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": false,
+      "properties": {
+        "label": {
+          "type": "string"
+        },
+        "max_length": {
+          "type": "integer"
+        },
+        "placeholder": {
+          "type": "string"
+        },
+        "required": {
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "label",
+        "placeholder",
+        "required",
+        "max_length"
+      ],
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "What `prompt` asks for when you run it; null when it asks for none."
+}

removedOutput schema / properties / recipe / properties / recipe / properties / recipe_id
```
Removed value: -{
-  "format": "uuid",
-  "type": "string"
-}
```
removedOutput schema / properties / recipe / properties / recipe / properties / recommended_model
```
Removed value: -{
-  "type": [
-    "string",
-    "null"
-  ]
-}
```

addedOutput schema / properties / recipe / properties / recipe / properties / recommended_models

Added value: +{
+  "description": "Models its author tested. Any model of its medium that can take its inputs runs it too.",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

addedOutput schema / properties / recipe / properties / recipe / properties / run_inputs / description
```
Added value: +"What a `run` recipe takes, by key; empty on the others."
```
addedOutput schema / properties / recipe / properties / recipe / properties / run_inputs / items / additionalProperties
```
Added value: +true
```

addedOutput schema / properties / recipe / properties / recipe / properties / run_inputs / items / properties

Added value: +{
+  "key": {
+    "type": "string"
+  },
+  "label": {
+    "type": "string"
+  },
+  "type": {
+    "type": "string"
+  }
+}

addedOutput schema / properties / recipe / properties / recipe / properties / run_inputs / items / required
```
Added value: +[
+  "type",
+  "key",
+  "label"
+]
```
addedOutput schema / properties / recipe / properties / recipe / properties / run_inputs / items / type
```
Added value: +"object"
```

addedOutput schema / properties / recipe / properties / recipe / properties / type

Added value: +{
+  "description": "What it makes. New values may be added.",
+  "enum": [
+    "image",
+    "clip",
+    "voiceover",
+    "music"
+  ],
+  "type": "string"
+}

changedOutput schema / properties / recipe / properties / recipe / properties / uses / type
```
Previous value: -"number"New value: +"integer"
```

changedOutput schema / properties / recipe / properties / recipe / required

Previous value: -[
-  "recipe_id",
-  "model_kind",
-  "action",
-  "name",
-  "description",
-  "visibility",
-  "featured",
-  "tags",
-  "uses",
-  "cover_url",
-  "app_url"
-]New value: +[
+  "object",
+  "id",
+  "name",
+  "description",
+  "action",
+  "type",
+  "model",
+  "recommended_models",
+  "prompt",
+  "inputs",
+  "choices",
+  "run_inputs",
+  "tags",
+  "uses",
+  "cover_url",
+  "app_url",
+  "visibility",
+  "featured"
+]

Changed3 schema fields changedOct 28, 2026

changedInput schema / properties / allowed_models / items / enum

Previous value: -[
-  "seedream-5-lite",
-  "nano-banana-2.1",
-  "nano-banana-2",
-  "gpt-image-2.5-flare",
-  "gpt-image-2.5-sunburst",
-  "gpt-image-2",
-  "nano-banana-2-lite",
-  "seedream-5-pro",
-  "seedream-5-pro-spicy",
-  "flux-schnell",
-  "flux-2-flex",
-  "flux-2-pro",
-  "flux-2-max",
-  "recraft-v4.1-svg",
-  "recraft-v4.1-pro-svg",
-  "p-image",
-  "grok-imagine-image",
-  "grok-imagine-image-quality",
-  "krea-3",
-  "qwen-image-3-pro",
-  "soul-2",
-  "seedance-2.5",
-  "seedance-2.5-spicy",
-  "seedance-2.0",
-  "seedance-2.0-fast",
-  "seedance-2.0-mini",
-  "grok-imagine-video-1.5",
-  "veo-3.1",
-  "veo-3.1-fast",
-  "veo-3.1-lite",
-  "gemini-omni-1.1",
-  "kling-v3-omni-video",
-  "kling-v3-video",
-  "happyhorse-1.0",
-  "wan-3",
-  "wan-3-prime",
-  "gen-4.5",
-  "p-video",
-  "p-video-2",
-  "flux-3",
-  "minimax-h3-max",
-  "p-video-avatar",
-  "p-video-animate",
-  "p-video-replace",
-  "omni-human-1.5",
-  "kling-avatar-v2",
-  "kling-v3-motion-control",
-  "sync-lipsync-2",
-  "kling-lip-sync",
-  "genjutsu-motion-transfer",
-  "genjutsu-object-swap",
-  "elevenlabs-tts",
-  "eleven-v4",
-  "gemini-3.1-flash-tts",
-  "kokoro-82m",
-  "minimax-speech-2.8-hd",
-  "inworld-tts-2",
-  "minimax-music-2.6",
-  "eleven-music"
-]New value: +[
+  "seedream-5-lite",
+  "nano-banana-2.1",
+  "nano-banana-2",
+  "gpt-image-2.5-flare",
+  "gpt-image-2.5-sunburst",
+  "gpt-image-2",
+  "nano-banana-2-lite",
+  "seedream-5-pro",
+  "flux-schnell",
+  "flux-2-flex",
+  "flux-2-pro",
+  "flux-2-max",
+  "recraft-v4.1-svg",
+  "recraft-v4.1-pro-svg",
+  "p-image",
+  "grok-imagine-image",
+  "grok-imagine-image-quality",
+  "krea-3",
+  "qwen-image-3-pro",
+  "soul-2",
+  "seedance-2.5",
+  "seedance-2.0",
+  "seedance-2.0-fast",
+  "seedance-2.0-mini",
+  "grok-imagine-video-1.5",
+  "veo-3.1",
+  "veo-3.1-fast",
+  "veo-3.1-lite",
+  "gemini-omni-1.1",
+  "kling-v3-omni-video",
+  "kling-v3-video",
+  "happyhorse-1.0",
+  "wan-3",
+  "wan-3-prime",
+  "gen-4.5",
+  "p-video",
+  "p-video-2",
+  "flux-3",
+  "minimax-h3-max",
+  "p-video-avatar",
+  "p-video-animate",
+  "p-video-replace",
+  "omni-human-1.5",
+  "kling-avatar-v2",
+  "kling-v3-motion-control",
+  "sync-lipsync-2",
+  "kling-lip-sync",
+  "genjutsu-motion-transfer",
+  "genjutsu-object-swap",
+  "elevenlabs-tts",
+  "eleven-v4",
+  "gemini-3.1-flash-tts",
+  "kokoro-82m",
+  "minimax-speech-2.8-hd",
+  "inworld-tts-2",
+  "minimax-music-2.6",
+  "eleven-music"
+]

changedInput schema / properties / model_id / enum

Previous value: -[
-  "seedream-5-lite",
-  "nano-banana-2.1",
-  "nano-banana-2",
-  "gpt-image-2.5-flare",
-  "gpt-image-2.5-sunburst",
-  "gpt-image-2",
-  "nano-banana-2-lite",
-  "seedream-5-pro",
-  "seedream-5-pro-spicy",
-  "flux-schnell",
-  "flux-2-flex",
-  "flux-2-pro",
-  "flux-2-max",
-  "recraft-v4.1-svg",
-  "recraft-v4.1-pro-svg",
-  "p-image",
-  "grok-imagine-image",
-  "grok-imagine-image-quality",
-  "krea-3",
-  "qwen-image-3-pro",
-  "soul-2",
-  "seedance-2.5",
-  "seedance-2.5-spicy",
-  "seedance-2.0",
-  "seedance-2.0-fast",
-  "seedance-2.0-mini",
-  "grok-imagine-video-1.5",
-  "veo-3.1",
-  "veo-3.1-fast",
-  "veo-3.1-lite",
-  "gemini-omni-1.1",
-  "kling-v3-omni-video",
-  "kling-v3-video",
-  "happyhorse-1.0",
-  "wan-3",
-  "wan-3-prime",
-  "gen-4.5",
-  "p-video",
-  "p-video-2",
-  "flux-3",
-  "minimax-h3-max",
-  "p-video-avatar",
-  "p-video-animate",
-  "p-video-replace",
-  "omni-human-1.5",
-  "kling-avatar-v2",
-  "kling-v3-motion-control",
-  "sync-lipsync-2",
-  "kling-lip-sync",
-  "genjutsu-motion-transfer",
-  "genjutsu-object-swap",
-  "elevenlabs-tts",
-  "eleven-v4",
-  "gemini-3.1-flash-tts",
-  "kokoro-82m",
-  "minimax-speech-2.8-hd",
-  "inworld-tts-2",
-  "minimax-music-2.6",
-  "eleven-music"
-]New value: +[
+  "seedream-5-lite",
+  "nano-banana-2.1",
+  "nano-banana-2",
+  "gpt-image-2.5-flare",
+  "gpt-image-2.5-sunburst",
+  "gpt-image-2",
+  "nano-banana-2-lite",
+  "seedream-5-pro",
+  "flux-schnell",
+  "flux-2-flex",
+  "flux-2-pro",
+  "flux-2-max",
+  "recraft-v4.1-svg",
+  "recraft-v4.1-pro-svg",
+  "p-image",
+  "grok-imagine-image",
+  "grok-imagine-image-quality",
+  "krea-3",
+  "qwen-image-3-pro",
+  "soul-2",
+  "seedance-2.5",
+  "seedance-2.0",
+  "seedance-2.0-fast",
+  "seedance-2.0-mini",
+  "grok-imagine-video-1.5",
+  "veo-3.1",
+  "veo-3.1-fast",
+  "veo-3.1-lite",
+  "gemini-omni-1.1",
+  "kling-v3-omni-video",
+  "kling-v3-video",
+  "happyhorse-1.0",
+  "wan-3",
+  "wan-3-prime",
+  "gen-4.5",
+  "p-video",
+  "p-video-2",
+  "flux-3",
+  "minimax-h3-max",
+  "p-video-avatar",
+  "p-video-animate",
+  "p-video-replace",
+  "omni-human-1.5",
+  "kling-avatar-v2",
+  "kling-v3-motion-control",
+  "sync-lipsync-2",
+  "kling-lip-sync",
+  "genjutsu-motion-transfer",
+  "genjutsu-object-swap",
+  "elevenlabs-tts",
+  "eleven-v4",
+  "gemini-3.1-flash-tts",
+  "kokoro-82m",
+  "minimax-speech-2.8-hd",
+  "inworld-tts-2",
+  "minimax-music-2.6",
+  "eleven-music"
+]

changedInput schema / properties / recommended_model / anyOf

Previous value: -[
-  {
-    "enum": [
-      "seedream-5-lite",
-      "nano-banana-2.1",
-      "nano-banana-2",
-      "gpt-image-2.5-flare",
-      "gpt-image-2.5-sunburst",
-      "gpt-image-2",
-      "nano-banana-2-lite",
-      "seedream-5-pro",
-      "seedream-5-pro-spicy",
-      "flux-schnell",
-      "flux-2-flex",
-      "flux-2-pro",
-      "flux-2-max",
-      "recraft-v4.1-svg",
-      "recraft-v4.1-pro-svg",
-      "p-image",
-      "grok-imagine-image",
-      "grok-imagine-image-quality",
-      "krea-3",
-      "qwen-image-3-pro",
-      "soul-2",
-      "seedance-2.5",
-      "seedance-2.5-spicy",
-      "seedance-2.0",
-      "seedance-2.0-fast",
-      "seedance-2.0-mini",
-      "grok-imagine-video-1.5",
-      "veo-3.1",
-      "veo-3.1-fast",
-      "veo-3.1-lite",
-      "gemini-omni-1.1",
-      "kling-v3-omni-video",
-      "kling-v3-video",
-      "happyhorse-1.0",
-      "wan-3",
-      "wan-3-prime",
-      "gen-4.5",
-      "p-video",
-      "p-video-2",
-      "flux-3",
-      "minimax-h3-max",
-      "p-video-avatar",
-      "p-video-animate",
-      "p-video-replace",
-      "omni-human-1.5",
-      "kling-avatar-v2",
-      "kling-v3-motion-control",
-      "sync-lipsync-2",
-      "kling-lip-sync",
-      "genjutsu-motion-transfer",
-      "genjutsu-object-swap",
-      "elevenlabs-tts",
-      "eleven-v4",
-      "gemini-3.1-flash-tts",
-      "kokoro-82m",
-      "minimax-speech-2.8-hd",
-      "inworld-tts-2",
-      "minimax-music-2.6",
-      "eleven-music"
-    ],
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "enum": [
+      "seedream-5-lite",
+      "nano-banana-2.1",
+      "nano-banana-2",
+      "gpt-image-2.5-flare",
+      "gpt-image-2.5-sunburst",
+      "gpt-image-2",
+      "nano-banana-2-lite",
+      "seedream-5-pro",
+      "flux-schnell",
+      "flux-2-flex",
+      "flux-2-pro",
+      "flux-2-max",
+      "recraft-v4.1-svg",
+      "recraft-v4.1-pro-svg",
+      "p-image",
+      "grok-imagine-image",
+      "grok-imagine-image-quality",
+      "krea-3",
+      "qwen-image-3-pro",
+      "soul-2",
+      "seedance-2.5",
+      "seedance-2.0",
+      "seedance-2.0-fast",
+      "seedance-2.0-mini",
+      "grok-imagine-video-1.5",
+      "veo-3.1",
+      "veo-3.1-fast",
+      "veo-3.1-lite",
+      "gemini-omni-1.1",
+      "kling-v3-omni-video",
+      "kling-v3-video",
+      "happyhorse-1.0",
+      "wan-3",
+      "wan-3-prime",
+      "gen-4.5",
+      "p-video",
+      "p-video-2",
+      "flux-3",
+      "minimax-h3-max",
+      "p-video-avatar",
+      "p-video-animate",
+      "p-video-replace",
+      "omni-human-1.5",
+      "kling-avatar-v2",
+      "kling-v3-motion-control",
+      "sync-lipsync-2",
+      "kling-lip-sync",
+      "genjutsu-motion-transfer",
+      "genjutsu-object-swap",
+      "elevenlabs-tts",
+      "eleven-v4",
+      "gemini-3.1-flash-tts",
+      "kokoro-82m",
+      "minimax-speech-2.8-hd",
+      "inworld-tts-2",
+      "minimax-music-2.6",
+      "eleven-music"
+    ],
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

Changed2 schema fields changedOct 20, 2026

addedInput schema / properties / config / properties / choices / items / properties / max_picks
```
Added value: +{
+  "default": 1,
+  "maximum": 16,
+  "minimum": 1,
+  "type": "integer"
+}
```

addedInput schema / properties / config / properties / choices / items / properties / shown_when

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": false,
+      "properties": {
+        "choice": {
+          "maxLength": 40,
+          "minLength": 1,
+          "pattern": "^[a-z][a-z0-9_]*$",
+          "type": "string"
+        },
+        "values": {
+          "items": {
+            "maxLength": 40,
+            "minLength": 1,
+            "pattern": "^[a-z][a-z0-9_]*$",
+            "type": "string"
+          },
+          "maxItems": 16,
+          "minItems": 1,
+          "type": "array"
+        }
+      },
+      "required": [
+        "choice",
+        "values"
+      ],
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null
+}

Changed3 schema fields changedOct 19, 2026

changedInput schema / properties / config / properties / choices / items / properties / options / maxItems
```
Previous value: -8New value: +16
```
changedInput schema / properties / config / properties / choices / maxItems
```
Previous value: -4New value: +12
```

changedInput schema / properties / config / properties / preset_policies / properties / style / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "default": {
-        "maxLength": 80,
-        "minLength": 1,
-        "type": "string"
-      },
-      "families": {
-        "items": {
-          "enum": [
-            "photorealistic",
-            "cinematic",
-            "3d_animation",
-            "cartoon",
-            "anime"
-          ],
-          "type": "string"
-        },
-        "minItems": 1,
-        "type": "array"
-      },
-      "helper_text": {
-        "anyOf": [
-          {
-            "maxLength": 240,
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "label": {
-        "maxLength": 60,
-        "minLength": 1,
-        "type": "string"
-      },
-      "mode": {
-        "const": "editable",
-        "type": "string"
-      },
-      "required": {
-        "default": false,
-        "type": "boolean"
-      }
-    },
-    "required": [
-      "mode"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "mode": {
-        "const": "fixed",
-        "type": "string"
-      },
-      "preset": {
-        "$ref": "#/properties/config/properties/preset_policies/properties/style/anyOf/0/properties/default"
-      },
-      "reason": {
-        "maxLength": 240,
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "mode",
-      "preset",
-      "reason"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "mode": {
-        "const": "unused",
-        "type": "string"
-      }
-    },
-    "required": [
-      "mode"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "default": {
+        "maxLength": 80,
+        "minLength": 1,
+        "type": "string"
+      },
+      "families": {
+        "items": {
+          "enum": [
+            "photorealistic",
+            "cinematic",
+            "3d_animation",
+            "cartoon",
+            "anime",
+            "pan_tilt",
+            "zoom_lens",
+            "dolly_track",
+            "slide_orbit",
+            "handheld_body",
+            "drone_crane",
+            "specials"
+          ],
+          "type": "string"
+        },
+        "minItems": 1,
+        "type": "array"
+      },
+      "helper_text": {
+        "anyOf": [
+          {
+            "maxLength": 240,
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "label": {
+        "maxLength": 60,
+        "minLength": 1,
+        "type": "string"
+      },
+      "mode": {
+        "const": "editable",
+        "type": "string"
+      },
+      "required": {
+        "default": false,
+        "type": "boolean"
+      }
+    },
+    "required": [
+      "mode"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "mode": {
+        "const": "fixed",
+        "type": "string"
+      },
+      "preset": {
+        "$ref": "#/properties/config/properties/preset_policies/properties/style/anyOf/0/properties/default"
+      },
+      "reason": {
+        "maxLength": 240,
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "mode",
+      "preset",
+      "reason"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "mode": {
+        "const": "unused",
+        "type": "string"
+      }
+    },
+    "required": [
+      "mode"
+    ],
+    "type": "object"
+  }
+]

Changed3 schema fields changedOct 16, 2026

changedInput schema / properties / allowed_models / items / enum

Previous value: -[
-  "seedream-5-lite",
-  "nano-banana-2.1",
-  "nano-banana-2",
-  "gpt-image-2.5-flare",
-  "gpt-image-2.5-sunburst",
-  "gpt-image-2",
-  "nano-banana-2-lite",
-  "seedream-5-pro",
-  "seedream-5-pro-spicy",
-  "flux-schnell",
-  "flux-2-flex",
-  "flux-2-pro",
-  "flux-2-max",
-  "recraft-v4.1-svg",
-  "recraft-v4.1-pro-svg",
-  "p-image",
-  "grok-imagine-image",
-  "grok-imagine-image-quality",
-  "soul-2",
-  "seedance-2.5",
-  "seedance-2.5-spicy",
-  "seedance-2.0",
-  "seedance-2.0-fast",
-  "seedance-2.0-mini",
-  "grok-imagine-video-1.5",
-  "veo-3.1",
-  "veo-3.1-fast",
-  "veo-3.1-lite",
-  "gemini-omni-1.1",
-  "kling-v3-omni-video",
-  "kling-v3-video",
-  "happyhorse-1.0",
-  "wan-3",
-  "wan-3-prime",
-  "gen-4.5",
-  "p-video",
-  "p-video-2",
-  "flux-3",
-  "minimax-h3-max",
-  "p-video-avatar",
-  "p-video-animate",
-  "p-video-replace",
-  "omni-human-1.5",
-  "kling-avatar-v2",
-  "kling-v3-motion-control",
-  "sync-lipsync-2",
-  "kling-lip-sync",
-  "genjutsu-motion-transfer",
-  "genjutsu-object-swap",
-  "elevenlabs-tts",
-  "eleven-v4",
-  "gemini-3.1-flash-tts",
-  "kokoro-82m",
-  "minimax-speech-2.8-hd",
-  "inworld-tts-2",
-  "minimax-music-2.6",
-  "eleven-music"
-]New value: +[
+  "seedream-5-lite",
+  "nano-banana-2.1",
+  "nano-banana-2",
+  "gpt-image-2.5-flare",
+  "gpt-image-2.5-sunburst",
+  "gpt-image-2",
+  "nano-banana-2-lite",
+  "seedream-5-pro",
+  "seedream-5-pro-spicy",
+  "flux-schnell",
+  "flux-2-flex",
+  "flux-2-pro",
+  "flux-2-max",
+  "recraft-v4.1-svg",
+  "recraft-v4.1-pro-svg",
+  "p-image",
+  "grok-imagine-image",
+  "grok-imagine-image-quality",
+  "krea-3",
+  "qwen-image-3-pro",
+  "soul-2",
+  "seedance-2.5",
+  "seedance-2.5-spicy",
+  "seedance-2.0",
+  "seedance-2.0-fast",
+  "seedance-2.0-mini",
+  "grok-imagine-video-1.5",
+  "veo-3.1",
+  "veo-3.1-fast",
+  "veo-3.1-lite",
+  "gemini-omni-1.1",
+  "kling-v3-omni-video",
+  "kling-v3-video",
+  "happyhorse-1.0",
+  "wan-3",
+  "wan-3-prime",
+  "gen-4.5",
+  "p-video",
+  "p-video-2",
+  "flux-3",
+  "minimax-h3-max",
+  "p-video-avatar",
+  "p-video-animate",
+  "p-video-replace",
+  "omni-human-1.5",
+  "kling-avatar-v2",
+  "kling-v3-motion-control",
+  "sync-lipsync-2",
+  "kling-lip-sync",
+  "genjutsu-motion-transfer",
+  "genjutsu-object-swap",
+  "elevenlabs-tts",
+  "eleven-v4",
+  "gemini-3.1-flash-tts",
+  "kokoro-82m",
+  "minimax-speech-2.8-hd",
+  "inworld-tts-2",
+  "minimax-music-2.6",
+  "eleven-music"
+]

changedInput schema / properties / model_id / enum

Previous value: -[
-  "seedream-5-lite",
-  "nano-banana-2.1",
-  "nano-banana-2",
-  "gpt-image-2.5-flare",
-  "gpt-image-2.5-sunburst",
-  "gpt-image-2",
-  "nano-banana-2-lite",
-  "seedream-5-pro",
-  "seedream-5-pro-spicy",
-  "flux-schnell",
-  "flux-2-flex",
-  "flux-2-pro",
-  "flux-2-max",
-  "recraft-v4.1-svg",
-  "recraft-v4.1-pro-svg",
-  "p-image",
-  "grok-imagine-image",
-  "grok-imagine-image-quality",
-  "soul-2",
-  "seedance-2.5",
-  "seedance-2.5-spicy",
-  "seedance-2.0",
-  "seedance-2.0-fast",
-  "seedance-2.0-mini",
-  "grok-imagine-video-1.5",
-  "veo-3.1",
-  "veo-3.1-fast",
-  "veo-3.1-lite",
-  "gemini-omni-1.1",
-  "kling-v3-omni-video",
-  "kling-v3-video",
-  "happyhorse-1.0",
-  "wan-3",
-  "wan-3-prime",
-  "gen-4.5",
-  "p-video",
-  "p-video-2",
-  "flux-3",
-  "minimax-h3-max",
-  "p-video-avatar",
-  "p-video-animate",
-  "p-video-replace",
-  "omni-human-1.5",
-  "kling-avatar-v2",
-  "kling-v3-motion-control",
-  "sync-lipsync-2",
-  "kling-lip-sync",
-  "genjutsu-motion-transfer",
-  "genjutsu-object-swap",
-  "elevenlabs-tts",
-  "eleven-v4",
-  "gemini-3.1-flash-tts",
-  "kokoro-82m",
-  "minimax-speech-2.8-hd",
-  "inworld-tts-2",
-  "minimax-music-2.6",
-  "eleven-music"
-]New value: +[
+  "seedream-5-lite",
+  "nano-banana-2.1",
+  "nano-banana-2",
+  "gpt-image-2.5-flare",
+  "gpt-image-2.5-sunburst",
+  "gpt-image-2",
+  "nano-banana-2-lite",
+  "seedream-5-pro",
+  "seedream-5-pro-spicy",
+  "flux-schnell",
+  "flux-2-flex",
+  "flux-2-pro",
+  "flux-2-max",
+  "recraft-v4.1-svg",
+  "recraft-v4.1-pro-svg",
+  "p-image",
+  "grok-imagine-image",
+  "grok-imagine-image-quality",
+  "krea-3",
+  "qwen-image-3-pro",
+  "soul-2",
+  "seedance-2.5",
+  "seedance-2.5-spicy",
+  "seedance-2.0",
+  "seedance-2.0-fast",
+  "seedance-2.0-mini",
+  "grok-imagine-video-1.5",
+  "veo-3.1",
+  "veo-3.1-fast",
+  "veo-3.1-lite",
+  "gemini-omni-1.1",
+  "kling-v3-omni-video",
+  "kling-v3-video",
+  "happyhorse-1.0",
+  "wan-3",
+  "wan-3-prime",
+  "gen-4.5",
+  "p-video",
+  "p-video-2",
+  "flux-3",
+  "minimax-h3-max",
+  "p-video-avatar",
+  "p-video-animate",
+  "p-video-replace",
+  "omni-human-1.5",
+  "kling-avatar-v2",
+  "kling-v3-motion-control",
+  "sync-lipsync-2",
+  "kling-lip-sync",
+  "genjutsu-motion-transfer",
+  "genjutsu-object-swap",
+  "elevenlabs-tts",
+  "eleven-v4",
+  "gemini-3.1-flash-tts",
+  "kokoro-82m",
+  "minimax-speech-2.8-hd",
+  "inworld-tts-2",
+  "minimax-music-2.6",
+  "eleven-music"
+]

changedInput schema / properties / recommended_model / anyOf

Previous value: -[
-  {
-    "enum": [
-      "seedream-5-lite",
-      "nano-banana-2.1",
-      "nano-banana-2",
-      "gpt-image-2.5-flare",
-      "gpt-image-2.5-sunburst",
-      "gpt-image-2",
-      "nano-banana-2-lite",
-      "seedream-5-pro",
-      "seedream-5-pro-spicy",
-      "flux-schnell",
-      "flux-2-flex",
-      "flux-2-pro",
-      "flux-2-max",
-      "recraft-v4.1-svg",
-      "recraft-v4.1-pro-svg",
-      "p-image",
-      "grok-imagine-image",
-      "grok-imagine-image-quality",
-      "soul-2",
-      "seedance-2.5",
-      "seedance-2.5-spicy",
-      "seedance-2.0",
-      "seedance-2.0-fast",
-      "seedance-2.0-mini",
-      "grok-imagine-video-1.5",
-      "veo-3.1",
-      "veo-3.1-fast",
-      "veo-3.1-lite",
-      "gemini-omni-1.1",
-      "kling-v3-omni-video",
-      "kling-v3-video",
-      "happyhorse-1.0",
-      "wan-3",
-      "wan-3-prime",
-      "gen-4.5",
-      "p-video",
-      "p-video-2",
-      "flux-3",
-      "minimax-h3-max",
-      "p-video-avatar",
-      "p-video-animate",
-      "p-video-replace",
-      "omni-human-1.5",
-      "kling-avatar-v2",
-      "kling-v3-motion-control",
-      "sync-lipsync-2",
-      "kling-lip-sync",
-      "genjutsu-motion-transfer",
-      "genjutsu-object-swap",
-      "elevenlabs-tts",
-      "eleven-v4",
-      "gemini-3.1-flash-tts",
-      "kokoro-82m",
-      "minimax-speech-2.8-hd",
-      "inworld-tts-2",
-      "minimax-music-2.6",
-      "eleven-music"
-    ],
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "enum": [
+      "seedream-5-lite",
+      "nano-banana-2.1",
+      "nano-banana-2",
+      "gpt-image-2.5-flare",
+      "gpt-image-2.5-sunburst",
+      "gpt-image-2",
+      "nano-banana-2-lite",
+      "seedream-5-pro",
+      "seedream-5-pro-spicy",
+      "flux-schnell",
+      "flux-2-flex",
+      "flux-2-pro",
+      "flux-2-max",
+      "recraft-v4.1-svg",
+      "recraft-v4.1-pro-svg",
+      "p-image",
+      "grok-imagine-image",
+      "grok-imagine-image-quality",
+      "krea-3",
+      "qwen-image-3-pro",
+      "soul-2",
+      "seedance-2.5",
+      "seedance-2.5-spicy",
+      "seedance-2.0",
+      "seedance-2.0-fast",
+      "seedance-2.0-mini",
+      "grok-imagine-video-1.5",
+      "veo-3.1",
+      "veo-3.1-fast",
+      "veo-3.1-lite",
+      "gemini-omni-1.1",
+      "kling-v3-omni-video",
+      "kling-v3-video",
+      "happyhorse-1.0",
+      "wan-3",
+      "wan-3-prime",
+      "gen-4.5",
+      "p-video",
+      "p-video-2",
+      "flux-3",
+      "minimax-h3-max",
+      "p-video-avatar",
+      "p-video-animate",
+      "p-video-replace",
+      "omni-human-1.5",
+      "kling-avatar-v2",
+      "kling-v3-motion-control",
+      "sync-lipsync-2",
+      "kling-lip-sync",
+      "genjutsu-motion-transfer",
+      "genjutsu-object-swap",
+      "elevenlabs-tts",
+      "eleven-v4",
+      "gemini-3.1-flash-tts",
+      "kokoro-82m",
+      "minimax-speech-2.8-hd",
+      "inworld-tts-2",
+      "minimax-music-2.6",
+      "eleven-music"
+    ],
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

First observedOct 15, 2026

TDQS

A4.1/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations only say destructiveHint=true and idempotent=false; the description adds the substantive behavior: config, writer and definition are replaced WHOLE and re-validated whole, medium changes reset settings and may override model_id, moving into or out of clips drops the cover, and a published row is taken down before the edit. These are exactly the side effects an agent cannot infer from the annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Dense but front-loaded and largely waste-free; each sentence adds a distinct rule about replacement, medium change, kind change or cover/publish side effects. The cost is readability: idiosyncratic terms like 'words' and 'its document' force re-reading, and the paragraph is a single block rather than structured per action.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 17-parameter mutation tool with deep nested config/writer objects and almost no schema descriptions, the description covers the hardest parts: which params each row kind accepts, whole-object replacement, and validation/takedown consequences. Return values are covered by the output schema, and the remaining omissions are simple scalar fields.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 6% across 17 parameters, so the description carries most of the burden and does explain the action-gated parameter sets and the whole-replacement rule. However, cover_focus, cover_shape, cover_before_focus, highlights, tags and description are never addressed, and the parenthetical 'a run row takes no cover focus points' is the only hint at cover behavior.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

Opens with a specific verb+resource and scope ('Change anything about a recipe you own'), then enumerates the editable surfaces and distinguishes the row kinds (arm/reprompt/run). It is clear enough to separate from create_recipe, delete_recipe and get_own_recipe, but the domain vocabulary ('words', 'document', 'medium', 'kind') does not map one-to-one onto the schema's field names, so the agent must translate.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives concrete prerequisites and sequencing: read get_own_recipe first and resend every slot/choice/step, and re-publish after editing a published row. It states conditional requirements per action ('run' needs a definition, 'reprompt' needs a writer unless the row has one). It stops short of naming siblings like remix_recipe or create_recipe as alternatives, but the when-to-use conditions are explicit.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Kuro tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?